Arquivos de instruções para agentes
Todo agente de programação carrega um arquivo do projeto com instruções permanentes antes de começar a trabalhar. Veja onde cada ferramenta procura esse arquivo, quais frontmatter entende e como combina cópias globais, do projeto e aninhadas. Informações verificadas na documentação dos fornecedores em 2026-10-01.
Qual ferramenta lê cada arquivo
| Ferramenta | Lê | AGENTS.md |
|---|---|---|
| OpenAI Codex | AGENTS.mdAGENTS.override.md~/.codex/AGENTS.md | Nativo |
| Claude Code | CLAUDE.mdCLAUDE.local.md.claude/rules/*.md~/.claude/CLAUDE.mdAGENTS.md | Nativo |
| Cursor | .cursor/rules/*.mdcAGENTS.md | Nativo |
| GitHub Copilot | .github/copilot-instructions.md.github/instructions/*.instructions.mdAGENTS.mdCLAUDE.mdGEMINI.md | Nativo |
| Gemini CLI | GEMINI.md~/.gemini/GEMINI.md.gemini/settings.json | Via configuração |
| Devin Desktop (anteriormente Windsurf) | .devin/rules/*.md.windsurf/rules/*.md.windsurfrules~/.codeium/windsurf/memories/global_rules.mdAGENTS.md | Nativo |
| Cline | .clinerules/*.md.cline/rules/*.mdAGENTS.md.cursorrules.windsurfrules | Nativo |
| Aider | .aider.conf.yml | Via configuração |
| OpenClaw | AGENTS.mdSOUL.mdIDENTITY.mdUSER.mdMEMORY.md | Nativo |
Use um único AGENTS.md como fonte da verdade e aponte as demais ferramentas para ele. Sete das nove ferramentas acima o leem sem configuração adicional; Gemini CLI e Aider precisam de uma linha de configuração, e um CLAUDE.md que contenha apenas @AGENTS.md mantém versões mais antigas do Claude Code em sincronia. Use o formato de regras próprio de cada ferramenta apenas para regras específicas por caminho que não possam ser expressas em AGENTS.md.
Todos os arquivos de instruções
AGENTS.mdAGENTS.md
AGENTS.md é um arquivo Markdown simples com instruções para o projeto, lido pela maioria dos agentes de programação sem configuração adicional. A OpenAI o apresentou à Agentic AI Foundation, da Linux Foundation, e mais de 60k projetos de código aberto o utilizam.
CLAUDE.mdCLAUDE.md (Claude Code)
CLAUDE.md é o arquivo de memória que o Claude Code carrega ao iniciar, a partir do diretório pessoal, do projeto e de cada diretório pai. As regras associadas a caminhos em .claude/rules/ adicionam orientações carregadas apenas quando arquivos correspondentes são lidos.
GEMINI.mdGEMINI.md (Gemini CLI)
GEMINI.md é o arquivo de contexto que o Gemini CLI envia com cada prompt. Ele também pode ler AGENTS.md ou qualquer outro nome definido em context.fileName.
.cursor/rules/*.mdcCursor Project Rules (.cursor/rules/*.mdc)
As Project Rules do Cursor são arquivos .mdc em .cursor/rules/ cujo frontmatter define quando cada regra é incluída. O Cursor também lê AGENTS.md, além das User Rules e Team Rules configuradas fora do repositório.
.github/copilot-instructions.mdGitHub Copilot custom instructions
O GitHub Copilot lê um arquivo para todo o repositório, .github/copilot-instructions.md, além de arquivos .instructions.md específicos para caminhos. Ele também respeita AGENTS.md ou um único CLAUDE.md ou GEMINI.md na raiz.
.devin/rules/*.mdDevin Desktop (Windsurf) rules
Devin Desktop, novo nome do Windsurf desde 2026-06-02, lê arquivos de regras em .devin/rules/ e ainda aceita .windsurf/rules/ e o arquivo legado .windsurfrules. O trigger de cada regra determina se ela está sempre ativa, se é selecionada por glob, pelo modelo ou manualmente.
.clinerules/Cline Rules (.clinerules/)
As Cline Rules são arquivos Markdown em .clinerules/ que o Cline combina com as regras globais e com AGENTS.md. O frontmatter opcional paths limita uma regra aos arquivos correspondentes.
~/.openclaw/workspace/AGENTS.mdOpenClaw workspace bootstrap files
O OpenClaw monta o contexto de cada agente a partir de arquivos Markdown de inicialização no workspace, começando por um AGENTS.md obrigatório. Esses arquivos são inseridos no prompt de sistema no primeiro turno de cada nova sessão.