O que e AGENTS.md? | Glossario GEO

AGENTS.md e um arquivo Markdown colocado na raiz de um repositorio ou site que diz aos agentes de IA como construir o projeto, quais comandos de teste usar, qual o estilo de codigo e quais regras seguir durante o trabalho - tornando-se o arquivo de instrucoes padrao de fato. Chamado de "README para agentes", ele e lido automaticamente no inicio da tarefa pelos principais agentes de codigo, incluindo o OpenAI Codex.

Por que importa

Os agentes de IA de codigo sao poderosos, mas nao conhecem o conhecimento tacito do projeto. Com qual comando se rodam os testes, em quais diretorios nao se deve mexer - tudo isso precisava ser explicado de novo a cada prompt. O AGENTS.md fixa esse contexto em um unico 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, ja era adotado por mais de 60 mil projetos de codigo 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 governanca neutra.

Estrutura e como escrever

AGENTS.md e Markdown puro, sem campos obrigatorios. Em vez de um schema fixo, ele contem instrucoes em linguagem natural que o agente pode ler e seguir. A composicao recomendada e a seguinte:

Visao geral do projeto: um ou dois paragrafos sobre o que a base de codigo faz
Comandos de build e teste: instalacao de dependencias, servidor de desenvolvimento, execucao de testes
Estilo de codigo: nomenclatura, formatacao, convencoes do framework
Seguranca e limites: arquivos em que nao se deve mexer, regras de tratamento de segredos
Regras de commit e PR: formato das mensagens, processo de revisao

Em monorepos grandes, coloca-se um AGENTS.md aninhado por pacote, e o agente aplica primeiro o arquivo mais proximo do local em que esta trabalhando.

Diferenca em relacao ao llms.txt

Se o llms.txt e o folheto que informa "qual conteudo existe" para a IA, o AGENTS.md e o manual de operacao que informa "como se trabalha aqui". Ele surgiu originalmente nos repositorios de codigo, mas, recentemente, tambem apareceu o padrao de coloca-lo na raiz do site (/agents.md) para orientar os agentes de navegacao sobre como usar o site. Junto do llms.txt e da marcacao Schema.org, ele e agrupado na categoria de "sinais legiveis por agentes" (agent-readable signals) e, diferentemente do robots.txt, que trata de permitir ou nao a coleta por IA, ele trata de "o que um agente autorizado pode fazer e como".

Implicacoes na otica do GEO

A medida que o centro de gravidade do GEO se expande de "conteudo que a IA cita" para "site no qual a IA consegue trabalhar", os arquivos que fornecem instrucoes explicitas aos agentes vao se tornando uma nova camada de otimizacao. Para equipes que mantem ferramentas de desenvolvimento ou documentacao 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, porem, que o AGENTS.md e apenas uma orientacao, sem poder de imposicao; por isso, a qualidade da estruturacao do proprio conteudo continua sendo o fundamento.

Sources:

Como o inblog Ajuda

Se voce mantem um blog de produto ou conteudo de documentacao no inblog, lembre-se da divisao de papeis entre os sinais. Enquanto arquivos do tipo llms.txt cuidam da apresentacao do conteudo e o AGENTS.md cuida das instrucoes de trabalho, o corpo do blog deve ter uma estrutura facil de o agente citar e resumir. A marcacao limpa e a estrutura clara de subtitulos do inblog tornam-se mais eficazes quando combinadas com esses sinais legiveis por agentes.