--- name: produzir-documentos-markdown-para-ia description: "Prepara e revisa Markdown para bases e contexto de IA, preservando fontes, regras e exceções em leitura integral ou por trechos. Use para documentos; não cria agentes nem pipelines de RAG." metadata: version: "1.0.0" product: "Gestão de Agentes de IA — Couto-IAS" method: "Arquitetura documental para leitura e recuperação por IA" --- # Produzir documentos Markdown para IA Transforme materiais do usuário em fontes Markdown utilizáveis por outra IA, preservando a inteligência: conceitos, razões, critérios, relações, operações, exemplos e limites que mudam a interpretação. Cabeçalhos e resumos não substituem esse conteúdo. Funciona pela leitura deste arquivo e dos apoios relativos, com os materiais legítimos do usuário. Não exige plugin, rede, script ou acervo do autor. Leitura e escrita no destino dependem dos meios da sessão; sem escrita, entregue o conteúdo completo com nome e destino propostos, sem alegar gravação. ## Entrar na transformação certa Use para criar, converter ou revisar conhecimento, política, procedimento, decisão, referência ou instrução em Markdown destinado a contexto ou consulta por IA. Uma revisão documental pode diagnosticar e propor sem aplicar. Texto comum sem consumo por IA usa escrita comum. Construir um agente, desenvolver inteligência ausente, decidir política, implantar acesso e configurar recuperação são outras contribuições. Esta Skill organiza conteúdo sustentado; pode apontar lacunas e formular propostas identificadas, sem inventar a regra do usuário. ## Receber e preservar Recupere objeto, materiais, fonte que governa o conteúdo, condição de aprovação, destino, alcance da mudança e consumo pretendido. Pergunte somente o que impede uma conclusão material. Se o consumo for desconhecido, trabalhe com hipótese híbrida: leitura integral e trechos interpretáveis; diga que o mecanismo real não foi observado. Leia a fonte antes de reescrever. Identifique o que precisa atravessar: afirmações, condições, exceções, prioridades, sequência, termos, exemplos, números e autoridade. Preserve o original e sua identidade. Conversão ou reorganização não promove proposta a política vigente, não substitui a fonte autoral e não autoriza publicação. Material cuja redação tem valor normativo exige fidelidade textual: preserve a formulação e acrescente navegação ou explicação separada. Mudança de sentido, remoção de contribuição ou resolução de conflito vira proposta explícita. Se fontes incompatíveis não puderem ser reconciliadas por alcance, período e autoridade, mostre a divergência no ponto afetado e conclua o restante. ## Construir o documento 1. Escolha função, fidelidade e consumo. Se haverá consulta por trechos, inclusive no modo híbrido e em documento curto, leia [método e arquitetura](references/metodo-documental.md) antes de definir a divisão. Leia-o também para documento extenso ou composto de várias fontes. Um caso simples de leitura integral pode seguir diretamente com um arquivo, contexto e unidades completas. 2. Escreva título e seções pelo objeto e função. Mantenha sujeito, escopo e tempo onde alteram a interpretação. Evite “a regra acima” quando o antecedente puder desaparecer. 3. Conserve regra, condição e exceção na mesma unidade quando separá-las induzir erro. Se a dependência for longa, declare junto da regra que ela depende de outra seção/fonte e forneça o percurso exato; sem essa fonte, a resposta fica incompleta. 4. Desenvolva o conteúdo suficiente, preservando explicações e critérios que sustentam o julgamento. Não comprima a fonte para caber num tamanho arbitrário. 5. Distinga conhecimento estável, estado atual, histórico, exemplo e derivado. Uma cópia preparada para IA aponta para a fonte que governa; índice, resumo e conversão não viram originais concorrentes. 6. Use metadata somente com função: identidade, origem, edição, autoridade, relação ou manutenção. Informação crítica também aparece em prosa quando sua ausência tornaria o trecho enganoso. Não presuma que o consumidor interpretará YAML. 7. Salve no destino autorizado e releia o salvo. Preserve o original ou sua referência recuperável. Se não puder conferir a gravação, identifique a parte entregue apenas como conteúdo preparado. Para política ou referência nova, adapte [modelo de fonte](assets/modelo-fonte.md). Para processo com entradas, decisões e saída, adapte [modelo de procedimento](assets/modelo-procedimento.md). Remova campos sem uso; lacuna material permanece explícita. Para reconhecer erros de conversão, consulte os [exemplos neutros](references/exemplos-neutros.md); seus números e papéis são fictícios. ## Conferir e devolver Leia [conferência e limites da prova](references/conferencia.md) ao converter, revisar ou concluir uma fonte. Confronte conteúdo salvo com o original; teste uma pergunta diferente do exemplo sobre condição/exceção e uma pergunta sem resposta. No consumo híbrido, confira tanto o documento inteiro quanto uma unidade isolada. Só chame de recuperação observada o que passou pelo mecanismo real. Selecionar manualmente uma seção testa sua interpretação; não prova que a plataforma a encontrará. Não prescreva tamanho universal de bloco, sobreposição, profundidade de títulos, XML ou posição da informação. Se houver sistema de ingestão conhecido ou diagnóstico de perda na conversão, leia a seção correspondente do [método](references/metodo-documental.md) e adapte o [registro de ingestão](assets/registro-ingestao.yaml). Não configure o sistema por esta Skill. Devolva o arquivo pronto ou o conteúdo completo, com condição, origem e limite suficientes para o consumidor. Na mensagem de entrega, diga o que foi preservado, reescrito ou ficou de fora com razão; separe proposta de aplicação e conferência documental de teste em uso. Guarde bastidores e provas de teste fora da fonte operacional. ## Uso pelo Couto-IAS e por outros agentes O Couto-IAS usa esta Skill ao produzir fontes Markdown do kit e ao preparar conhecimento compartilhado ou revisão documental. A concepção do agente, o julgamento de domínio e a organização do ambiente conservam suas contribuições próprias. Um agente produzido usa a Skill quando precisa criar ou revisar documentos para outra IA e tem os insumos e a autoridade pertinentes. Recebe objeto, fontes/edições, destino, consumo e transformação; devolve documento, proveniência, alterações e prova alcançada. Não recebe o mandato do Couto-IAS. A pasta completa pode acompanhar um agente que precise dessa capacidade; não é obrigatória em todo kit. A rota de chamada deve existir no ambiente consumidor. Presença da pasta, leitura explícita e seleção nativa são condições distintas; a exposição no ambiente exige conferência própria.