Pular para o conteúdo
AI Security

Seu agente pode estar lendo o arquivo de instrução errado: AGENTS.md, CLAUDE.md e os mitos de 2026

O Antigravity não lê .antigravity.md, o Aider não lê AGENTS.md sozinho e um CLAUDE.md esquecido desliga o seu AGENTS.md. O que a documentação oficial diz em outubro de 2026.

Por que isso importa

A regra de segurança que você escreveu para o agente só vale se ele carregar o arquivo. Revisando a documentação oficial de cada ferramenta em outubro de 2026, achei instrução circulando por aí que simplesmente não funciona.

Os mitos mais comuns

"O Antigravity lê .antigravity.md." Não lê. A documentação do Antigravity lista AGENTS.md, GEMINI.md e regras em .agents/rules/*.md. As regras dessa pasta precisam de frontmatter com trigger; sem ele, a regra é descartada em silêncio. Rode agy inspect para ver o que foi carregado.

"O Claude Code ignora AGENTS.md." Era verdade. Desde a versão 2.1.277 ele lê AGENTS.md quando não existe CLAUDE.md na pasta ou acima. Se existir um CLAUDE.md, ou até um CLAUDE.local.md, ele passa na frente e o AGENTS.md fica de fora. Para carregar os dois, ponha @AGENTS.md na primeira linha do CLAUDE.md.

"O Aider lê AGENTS.md." A documentação do Aider só carrega arquivo que você passa com --read ou lista em read: no .aider.conf.yml.

"O Zed lê o AGENTS.md." Lê, mas usa o primeiro arquivo que encontrar numa lista que começa em .rules e passa por .cursorrules e .windsurfrules antes do AGENTS.md. Um .cursorrules esquecido passa na frente.

"Subagent do Claude Code é só um markdown." Sem o frontmatter com name e description, o arquivo é tratado como documentação e não carrega.

"Arquivo .md solto em .cursor/rules funciona." A documentação do Cursor diz que .md sem frontmatter nessa pasta é ignorado. A regra precisa ser .mdc.

Menos é mais

Um estudo da ETH Zurich (2026) comparou agentes sem arquivo de contexto, com arquivo gerado por IA e com arquivo escrito por humano. O gerado por IA baixou a taxa de sucesso e subiu o custo em mais de 20%. Escreva você mesmo, curto, só com o que o agente não descobre lendo o código.

Como conferir em 2 minutos

  • Claude Code: /context mostra os arquivos de memória carregados.
  • Antigravity: agy inspect.
  • Nas outras: comece a sessão com "liste as instruções de projeto que você carregou" e confira se a regra de segurança aparece.

O RET Promptbook mantém a tabela de caminhos por ferramenta conferida na documentação oficial de outubro de 2026.

Fontes

  • Documentação oficial: Antigravity Rules, Claude Code memory, Aider conventions, Zed instructions, Cursor rules
  • InfoQ, cobertura do estudo da ETH Zurich sobre arquivos de contexto (março de 2026)
Tags:#AGENTS.md#CLAUDE.md#Antigravity#Claude Code#Cursor#agentes de código
Gabriel Ferreira
Gabriel Ferreira

Fundador e pentester líder

Gabriel Ferreira revisa SaaS em produção com foco em login, cobrança, dados e evidência que o founder entende.

Quanto custa testar o seu sistema?

Responda quatro perguntas e veja o pacote, o preço e o prazo do seu caso, sem cadastro. Devolvemos 50% se o teste não encontrar nenhuma falha.

Ver preço e prazo do meu caso
Leia também
Ver todos