
AGENTS.md na prática: como orientar a IA dentro de um projeto
A IA recebe uma tarefa de manutenção Delphi e sugere trocar uma dependência, alterar uma assinatura pública ou gravar dados durante uma análise. Você explica as restrições, e a conversa melhora.
Ver resumo completo
A IA recebe uma tarefa de manutenção Delphi e sugere trocar uma dependência, alterar uma assinatura pública ou gravar dados durante uma análise. Você explica as restrições, e a conversa melhora. Na próxima tarefa, precisa repetir o mesmo contexto. O problema não é somente a qualidade do pedido: os acordos do projeto ainda dependem de alguém lembrar de transmiti-los.
Um arquivo de orientações pode organizar esses acordos, desde que a ferramenta saiba onde encontrá-lo e a equipe saiba mantê-lo. Ele não deve reunir toda a documentação, todas as decisões antigas e todos os pedidos do histórico. Deve ajudar a trabalhar naquele ambiente, localizando referências relevantes e estabelecendo limites verificáveis.
Neste capítulo da série sobre instruções para IA, vamos construir um exemplo de AGENTS.md para um projeto Delphi fictício. Explicaremos raiz do projeto, módulo, precedência e conferência antes de usá-los. O comportamento de descoberta descrito aqui é o documentado para o Codex em 4 de outubro de 2026; não será apresentado como uma regra de todos os assistentes.
Se o desafio é explicitar comportamentos e conferir alterações, SDD em Delphi aprofunda especificações, contratos e critérios de aceite. Consulte o sumário e a degustação gratuita para avaliar como ligar essas orientações à implementação e aos testes. Um arquivo de instruções é mais útil quando participa desse entendimento, não quando funciona apenas como uma lista de preferências.















