AGENTS.md, CLAUDE.md e Cursor Rules: um formato para cada ferramenta
Cada agente de código lê um formato de instrução diferente. Entenda as diferenças entre AGENTS.md, CLAUDE.md e Cursor Rules — e como manter todos alinhados.
Resumo rápido
- AGENTS.md, CLAUDE.md e Cursor Rules cobrem propósitos parecidos, mas cada ferramenta lê o seu próprio formato.
- Manter os três sincronizados manualmente é o tipo de trabalho repetitivo que vale automatizar.
- O conteúdo (convenções, decisões, exceções) importa mais do que o formato específico de cada arquivo.
As diferenças entre os formatos
AGENTS.md é lido por ferramentas como Codex; CLAUDE.md é o formato do Claude Code; Cursor Rules vive em .cursor/rules e é específico do Cursor. O conteúdo costuma se sobrepor bastante — o que muda é o arquivo que cada ferramenta procura.
Mantendo os formatos alinhados
Escrever o mesmo conteúdo três vezes à mão é o tipo de trabalho que tende a divergir com o tempo. Gerar os três a partir da mesma base de conhecimento evita que um fique desatualizado enquanto os outros são revisados.
Leve contexto ao time e aos agentes
Base viva, wiki, chat e artefatos — e o mesmo conhecimento exposto via MCP.
Agentes de IAAGENTS.mdCursor