PulseFlow Tecnologia
← Insights
·6 min de leitura·atualizacao-de-produto·agents-md·agentic-ai-foundation·coding-agents
PulseFlow Tecnologia

AGENTS.md: o novo artefato de configuração para agentes de código

Um formato de arquivo simples - texto markdown, sem schema rígido, sem ferramenta proprietária por trás - já acumula mais de 22 mil estrelas no GitHub, 1,7 mil forks, e foi doado para uma fundação neutra ao lado do próprio Model Context Protocol. AGENTS.md deixou de ser convenção informal de alguns projetos e virou artefato de configuração padrão para coding agents.

Um README, mas para agentes

A proposta central do formato é simples: "a simple, open format for guiding coding agents" - um lugar único e previsível onde um agente de código procura instruções antes de tocar num repositório, cobrindo dicas de ambiente de desenvolvimento, instruções de teste, diretrizes de PR e comandos e convenções específicas do projeto. A analogia com README não é força de expressão: assim como um README orienta um desenvolvedor humano entrando num projeto novo, o AGENTS.md orienta um agente.

O que 2.500+ repositórios já ensinaram sobre o formato

Uma análise do GitHub sobre mais de 2.500 repositórios com AGENTS.md concluiu que "os agentes bem-sucedidos não são apenas ajudantes vagos; eles são especialistas". Seis blocos aparecem consistentemente nos arquivos mais eficazes: comandos executáveis prontos para copiar e colar, estrutura do projeto, stack técnico com versões específicas, exemplos de código real, padrões de estilo, e limites claros sobre o que o agente pode e não pode fazer sozinho. Entre as restrições identificadas, a mais comum e mais útil foi simplesmente "never commit secrets".

De convenção de projeto a projeto fundacional de uma fundação

O salto de maturidade mais importante não foi técnico - foi de governança. AGENTS.md, junto com o Model Context Protocol da Anthropic e o goose da Block, integra a recém-criada Agentic AI Foundation, sob o guarda-chuva da Linux Foundation, com Amazon Web Services, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft e OpenAI como membros Platinum. Um formato de arquivo que era, até pouco tempo, mantido de forma independente passa a ter a mesma estrutura de governança neutra que sustenta projetos de infraestrutura crítica open source.

Por que isso importa além da conveniência

Um AGENTS.md versionado junto do código resolve um problema que documentação externa nunca resolveu de verdade: manter-se atualizado. Documentação em wiki ou ferramenta de conhecimento separada do repositório tende a desatualizar silenciosamente; um arquivo dentro do próprio repositório, revisado no mesmo pull request que muda a arquitetura que ele descreve, tem muito mais chance de continuar correto.

O que isso sinaliza para quem ainda não adotou

Com adoção medida em dezenas de milhares de repositórios, um padrão de seis blocos já testado empiricamente, e agora governança compartilhada entre as maiores empresas de IA do mundo, a pergunta para times de engenharia deixou de ser "vale a pena ter um AGENTS.md?" e passou a ser "por que o nosso repositório ainda não tem um".

Fontes