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:
/contextmostra 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)
