22 Escrevendo com IA
Os livros recentes da casa foram escritos com apoio de assistentes de IA que operam no repositório: convertem edições antigas para Markdown, organizam a bibliografia, redigem rascunhos, sugerem revisões e auditam as fontes. O ganho é grande, e o risco também: um assistente produz, com a mesma fluência, uma referência real e uma inventada. Este capítulo descreve como a casa usa a IA sem abrir mão da verificação.
22.1 O CLAUDE.md como contrato
Na raiz de cada livro há um arquivo CLAUDE.md, lido pela ferramenta a cada sessão. Ele diz o que o projeto é, quais comandos existem, o que está congelado e, sobretudo, a regra zero: nada inventado. Nenhum dado verificável escrito de memória; nenhuma entrada do .bib que não venha de metadados recuperados; “não encontrei” como resposta aceitável; a citação sustentando a frase exata em que está; a força da afirmação original preservada na paráfrase; fato consolidado, hipótese em disputa e opinião do autor separados.
O mesmo arquivo registra o modo de trabalho pedido pelo autor: apontar problemas citando a frase concreta, propor redação no chat antes de incorporar, respostas breves, voz do autor preservada, ressalvas em comentário AUTOR e não em nota de rodapé para o estudante.
22.2 Rascunho, comentário, revisão
Todo texto rascunhado com IA nasce com um comentário que declara a procedência e pede revisão:
<!-- AUTOR (2ª ed.): seção nova, redigida com apoio de IA a partir dos slides da aula. Revisar. -->O autor revisa e remove o comentário ao aprovar. A ausência do comentário significa “revisado pelo autor”; a ferramenta não o recoloca. Decisões tomadas na revisão (o que foi cortado, por quê, que fonte sustentou o quê) ficam em comentários datados no fim do arquivo, e são o registro de auditoria do capítulo.
22.3 Auditoria de fontes
Nos livros em revisão, a auditoria é sistemática e em lotes: para cada capítulo, um relatório lista as afirmações, as fontes que as sustentam, o que foi lido diretamente e o que ficou pendente; o autor decide, e a decisão é registrada. Os arquivos da auditoria vivem numa pasta própria do repositório e não são renderizados. Os PDFs consultados ficam fora do Git.
Os validadores (Capítulo 14) são a rede de segurança dessa auditoria: a IA pode propor uma entrada, mas a entrada só entra depois de recuperada de uma fonte externa e conferida pelo script.
22.4 Declarar o uso
A página de créditos de cada livro declara quais ferramentas foram usadas e para quê, e descreve o estágio efetivo da revisão, não o desejado. Enquanto a verificação sistemática não estiver concluída, um callout diz isso ao leitor, com data. A responsabilidade pela seleção das fontes, pelas decisões editoriais e pelo conteúdo é do autor.
- O
CLAUDE.mdé o contrato: regra zero, o que está congelado, o modo de trabalho. - Rascunhos de IA nascem com comentário de procedência; o autor o remove ao revisar.
- A auditoria de fontes é registrada em lotes; os validadores impedem entradas não recuperadas.
- Os créditos declaram o uso de IA e o estágio real da revisão.