Exemplos de AGENTS.md
Instruções do repositório
AGENTS.md reúne instruções do projeto para um agente de programação. Inclua informações usadas em várias tarefas, como o comando de testes, as pastas do código e as regras para arquivos gerados. Descreva um defeito específico na tarefa para que ele não vire uma instrução permanente.
Em uma aplicação fictícia de entregas, você poderia escrever: “A lógica de pedidos fica em src/orders. Execute os testes de pedidos depois de alterá-la. Preserve os campos da resposta pública. Nunca copie registros de clientes para um prompt”. Cada frase resolve uma decisão que o agente teria de tomar por conta própria.
Escopo e permissões
O Codex procura instruções no caminho da raiz do repositório até seu diretório de trabalho. O guia oficial de AGENTS.md explica as substituições e os limites de tamanho. Conferimos essas convenções em 14 de novembro de 2026. Outros produtos podem carregar o mesmo arquivo de outra forma.
Uma instrução escrita não impede um processo de ler um segredo ou acessar a rede. Combine as instruções com controles de acesso. Pratique os limites de permissão e compare o exemplo de CLAUDE.md.