# Método documental para IA

Leia ao decidir arquitetura de documento extenso, composição de fontes, recuperação por trechos ou relação com ingestão. Este método está incorporado ao pacote; não exige fonte privada adicional.

## Fonte autoral e o que chega à IA

A fonte preserva significado e autoridade. Um sistema pode converter o arquivo, extrair texto, separar blocos, criar índices, selecionar resultados e montar contexto antes de entregar algo à IA. Cada passagem pode perder relações. Um documento correto não demonstra que o consumidor recebeu o conteúdo necessário.

Uma unidade semântica é o menor conjunto que permite interpretar uma afirmação sem mudar seu significado: objeto, regra, condições e exceções materiais. Um bloco técnico é uma divisão feita pelo sistema. Os dois podem coincidir, mas o limite de caracteres não define a unidade de conhecimento.

Quando a fonte não estiver acessível, marque a limitação. Título e endereço não comprovam conteúdo; uma versão lembrada não vence uma fonte atual consultada.

## Escolher consumo e fidelidade

| Consumo | Decisão de escrita | Conferência |
| --- | --- | --- |
| Persistente | Deixe o que influencia a atuação frequente; desenvolva detalhe em fonte sob demanda com rota suficiente. | A entrada conserva os critérios que não podem faltar? |
| Integral sob demanda | Preserve encadeamento e profundidade; acrescente navegação quando ajudar. | Outra IA resolve a tarefa lendo o documento completo? |
| Seletivo | Cada unidade deve conservar objeto e fronteiras locais; relações longas precisam de vínculo explícito. | A unidade isolada sustenta a resposta sem induzir regra universal? |
| Híbrido | Concilie encadeamento global e suficiência local. | Confira os dois modos separadamente. |

Se desconhecido, a hipótese híbrida é escolha de projeto, não descrição de plataforma. Não conclua que todo arquivo precisa ser curto ou que toda regra deve ser repetida integralmente em cada seção.

Fidelidade textual preserva palavras quando elas definem obrigação ou quando o usuário a exige. Fidelidade conceitual permite reescrever conservando proposições, relações e limites. Síntese seleciona contribuições e deve declarar perdas: não a apresente como conversão integral.

## Projetar unidades e relações

Comece por inventariar as contribuições materiais do insumo. Use uma lista interna ou um mapa comparativo conforme o volume; ela serve para verificar perdas, não precisa entrar no documento final.

Título nomeia o objeto. Heading diz objeto e função: “Condições de empréstimo de equipamentos”, em vez de apenas “Condições”. Termos canônicos e aliases úteis permanecem reconhecíveis. A escrita pode ser natural; pronomes são aceitáveis quando o antecedente acompanha o trecho.

Uma regra que admite exceção precisa conservar a exceção ou sua dependência explícita. “Empreste por cinco dias” perde sentido se o original diz que reservas confirmadas reduzem o período. Um ponteiro solto para “saiba mais” é insuficiente quando o vínculo altera a decisão.

A divisão em vários arquivos se justifica por consulta, manutenção ou autoridade distinta, não por um teto inventado de palavras. Ao dividir, mantenha identidade, papel, relação e percurso. Evite uma fonte mutável repetida manualmente em vários documentos; para conteúdo crítico curto, a repetição local pode ser adequada se sua manutenção estiver definida.

Tabelas favorecem comparação; condições longas costumam precisar de prosa. Uma linha isolada sem cabeçalhos pode inverter significado. Código precisa da linguagem, finalidade, entradas e limite que sustentam seu uso; não separe uma instrução crítica apenas para reduzir um bloco.

## Preservar condição e proveniência

Uma política aprovada continua aprovada na origem; uma minuta continua minuta após ganhar uma boa forma. A transformação não dá ao arquivo derivado autoridade para substituir a origem.

Conserve fonte, edição ou data identificável, condição e localizador suficiente na proporção do risco. Não invente um identificador institucional: um nome local pode servir à cópia, desde que essa função seja clara. Quando a data de vigência não foi fornecida, não use a data da conversão como substituta.

Separe alterações de forma, mudança de sentido e conteúdo novo. Explicação própria é identificada como interpretação ou proposta quando acrescenta algo que a fonte não afirma. Uma divergência não resolvida permanece junto da regra afetada.

Estado vivo descreve o agora; histórico explica trajetória; evidência sustenta uma ocorrência; exemplo ilustra mecanismo. Esses conteúdos não concorrem silenciosamente como regra atual.

## Escolher metadata com função

Frontmatter é opcional para documentos produzidos. Pode resolver identidade e manutenção, mas a condição essencial não fica apenas nele se a passagem puder ser consumida sem o cabeçalho.

| Campo possível | Função que justifica |
| --- | --- |
| titulo / id | Resolver a identidade do objeto. |
| condicao | Diferenciar proposta, cópia de consulta, original ou histórico. |
| origem / edicao_origem | Reencontrar o material que sustenta o conteúdo. |
| versao | Identificar edição da representação, sem confundir com aprovação da origem. |
| consumo_previsto | Registrar a hipótese usada para desenhar o documento. |
| depende_de / substitui | Preservar uma relação real e verificável. |

Remova o campo se ele não ajudar uma operação. Registre “não informado” quando a lacuna for material. Não prometa filtro ou indexação só porque o dado está em YAML.

## Quando há ingestão ou recuperação automatizada

Há dois compromissos distintos: a autoria preserva significado; o sistema preserva e devolve o conteúdo necessário. Use o registro de ingestão somente quando ajudar a investigar esse segundo compromisso. Preencha fatos observados e evidências; mantenha desconhecido o que não foi visto.

Inspecione saídas reais: texto extraído, blocos, metadata e contexto recebido. Se uma tabela perdeu cabeçalhos, a falha pode estar no conversor; se a unidade chegou inteira e a resposta omitiu a exceção, examine interpretação e geração. Não reescreva conteúdo correto para esconder uma falha sem identificar a camada.

Divisão por headings, busca lexical, semântica ou combinada e reordenação de resultados são opções para experimentar no sistema responsável. O documento conserva sinais úteis; esta Skill não instala nem escolhe essas opções sem evidência.

Não há tamanho, sobreposição, XML, quantidade de títulos ou posição crítica universal. Se existir limite técnico, registre-o como condição daquele destino e teste perdas. Ajuste adaptador ou representação derivada sem degradar silenciosamente a fonte.

## Manter a fonte ao longo do uso

Correção de conteúdo volta à casa que governa o objeto. A cópia literal acompanha a fonte; uma aplicação recebe revisão de pertinência; índices e conversões são reconstruídos quando necessário. Identifique consumidores materiais sem exigir inventário geral para uma alteração simples.

A atualização do arquivo não prova que outro agente recebeu a nova edição. Preserve origem, edição em uso, destino e evidência de chegada quando essa diferença decidir o trabalho.