O que é AGENTS.md? | Glossário GEO

AGENTS.md é um arquivo Markdown colocado na raiz de um repositório ou site que diz aos agentes de IA como construir o projeto, quais comandos de teste usar, qual o estilo de código e quais regras seguir durante o trabalho - tornando-se o arquivo de instruções padrão de fato. Chamado de "README para agentes", ele é lido automaticamente no início da tarefa pelos principais agentes de código, incluindo o OpenAI Codex.

Por que importa

Os agentes de IA de código são poderosos, mas não conhecem o conhecimento tácito do projeto. Com qual comando se rodam os testes, em quais diretórios não se deve mexer - tudo isso precisava ser explicado de novo a cada prompt. O AGENTS.md fixa esse contexto em um único arquivo e faz com que o agente o consulte automaticamente. Foi projetado em conjunto por OpenAI Codex, Amp, Jules (Google), Cursor e Factory, e tem suporte nativo em mais de 20 ferramentas, incluindo GitHub Copilot, Gemini CLI, Devin e Zed. Em 2026, já era adotado por mais de 60 mil projetos de código aberto e, em dezembro de 2025, foi doado - junto do MCP da Anthropic - a Agentic AI Foundation, sob a Linux Foundation, passando a ser gerido por uma governança neutra.

Estrutura e como escrever

AGENTS.md é Markdown puro, sem campos obrigatórios. Em vez de um schema fixo, ele contém instruções em linguagem natural que o agente pode ler e seguir. A composição recomendada é a seguinte:

Visão geral do projeto: um ou dois parágrafos sobre o que a base de código faz
Comandos de build e teste: instalação de dependencias, servidor de desenvolvimento, execução de testes
Estilo de código: nomenclatura, formatação, convenções do framework
Seguranca e limites: arquivos em que não se deve mexer, regras de tratamento de segredos
Regras de commit e PR: formato das mensagens, processo de revisão

Em monorepos grandes, coloca-se um AGENTS.md aninhado por pacote, e o agente aplica primeiro o arquivo mais próximo do local em que está trabalhando.

Diferença em relação ao llms.txt

Se o llms.txt é o folheto que informa "qual conteúdo existe" para a IA, o AGENTS.md é o manual de operação que informa "como se trabalha aqui". Ele surgiu originalmente nos repositórios de código, mas, recentemente, também apareceu o padrão de colocá-lo na raiz do site (/agents.md) para orientar os agentes de navegação sobre como usar o site. Junto do llms.txt e da marcação Schema.org, ele é agrupado na categoria de "sinais legíveis por agentes" (agent-readable signals) e, diferentemente do robots.txt, que trata de permitir ou não a coleta por IA, ele trata de "o que um agente autorizado pode fazer e como".

Implicações na ótica do GEO

A medida que o centro de gravidade do GEO se expande de "conteúdo que a IA cita" para "site no qual a IA consegue trabalhar", os arquivos que fornecem instruções explícitas aos agentes vao se tornando uma nova camada de otimização. Para equipes que mantém ferramentas de desenvolvimento ou documentação de API, quanto mais o AGENTS.md reduz a tentativa e erro do agente, maior a probabilidade de o seu produto ser adotado no fluxo de trabalho do agente. Vale lembrar, porém, que o AGENTS.md é apenas uma orientação, sem poder de imposição; por isso, a qualidade da estruturação do próprio conteúdo continua sendo o fundamento.

Sources:

Como o inblog Ajuda

Se você mantém um blog de produto ou conteúdo de documentação no inblog, lembre-se da divisão de papéis entre os sinais. Enquanto arquivos do tipo llms.txt cuidam da apresentação do conteúdo e o AGENTS.md cuida das instruções de trabalho, o corpo do blog deve ter uma estrutura fácil de o agente citar e resumir. A marcação limpa e a estrutura clara de subtítulos do inblog tornam-se mais eficazes quando combinadas com esses sinais legíveis por agentes.