O AGENTS.md resolve um problema bem concreto: agentes de código com IA precisam de contexto operacional — como instalar dependências, iniciar o servidor de desenvolvimento, executar testes e respeitar convenções do projeto —, mas colocar tudo isso no README torna o README ruim para colaboradores humanos. O AGENTS.md separa essas orientações em um arquivo próprio, escrito em Markdown puro e sem esquema obrigatório, para que os agentes o encontrem de forma confiável e o README continue curto e legível.
Como é apenas Markdown, não há nada a instalar nem ferramentas proprietárias a adotar. Você adiciona um AGENTS.md na raiz do repositório, inclui as seções relevantes e os agentes compatíveis o leem automaticamente. Em monorepos grandes, é possível colocar arquivos AGENTS.md adicionais dentro dos subpacotes; os agentes leem o arquivo mais próximo na árvore de diretórios, então o mais próximo prevalece e cada pacote pode ter instruções sob medida.
O formato surgiu da colaboração no ecossistema de desenvolvimento com IA — incluindo OpenAI Codex, Amp, Jules do Google, Cursor e Factory — e agora é mantido pela Agentic AI Foundation, sob a Linux Foundation. É usado por mais de 60 mil projetos de código aberto e suportado por diversos agentes, como Codex, Jules, Aider, goose, opencode, Zed, Warp, VS Code, Devin, Amp, Cursor, RooCode, Gemini CLI, Kilo Code e GitHub Copilot.