O AGENTS.md serve como uma especificação de projeto para inteligências de IA, semelhante a um manual de integração para desenvolvedores humanos. Quando esse arquivo existe no diretório raiz do projeto, o Codex pode se adaptar rapidamente a ambientes técnicos e especificações de desenvolvimento específicos, melhorando a eficiência da execução em mais de 40%. Esse arquivo Markdown usa um sistema de diretiva hierárquica que suporta vários níveis de granularidade, desde especificações globais até detalhes em nível de módulo.
O conteúdo do arquivo consiste em três módulos principais: requisitos de especificação de teste (por exemplo, parâmetros de execução do pytest), restrições de estilo de código (seguindo o PEP8 ou o Google Style) e uma descrição da arquitetura do projeto (limites de responsabilidade para os módulos principais). O AGENTS.md profundamente aninhado tem precedência sobre as diretivas, por exemplo, os requisitos de formatação em subdiretórios substituem as especificações comuns no diretório raiz. Como exemplo, um projeto financeiro configurado com 5 camadas de AGENTS.md aumentou a probabilidade de o código gerado pelo Codex passar em uma auditoria de código de 62% para 89% em uma única passagem.
É importante observar que, quando o AGENTS.md contém scripts de validação automatizados, o Codex força a realização dessas verificações antes de fazer o commit. Um projeto de IoT bloqueou com êxito 3 commits de código com possíveis vulnerabilidades de injeção ao integrar um security_linter.sh personalizado.
Essa resposta foi extraída do artigoChatGPT Codex: um corpo inteligente para automatizar tarefas de engenharia de softwareO
Português do Brasil 
简体中文 
English 
日本語 
Deutsch