Guias

Arquivos de regras e instruções em todo agente de IA para programação: .cursor/rules, CLAUDE.md, AGENTS.md, GEMINI.md, instruções do Copilot e mais (2026)

Qual arquivo de regras ou instruções cada agente de IA para programação lê, e o AGENTS.md funciona em todos?

O Cursor lê arquivos .mdc em .cursor/rules, além do AGENTS.md. O Claude Code lê o CLAUDE.md e recorre ao AGENTS.md quando não há CLAUDE.md. Codex, Amp, Kiro e Junie leem o AGENTS.md nativamente. O Gemini CLI lê o GEMINI.md e pode ser apontado para o AGENTS.md com context.fileName. O GitHub Copilot lê .github/copilot-instructions.md, .github/instructions/*.instructions.md e AGENTS.md. O Cline lê .clinerules/ e também detecta .cursorrules, .windsurfrules e AGENTS.md. Um único AGENTS.md na raiz do repo cobre a maioria dos agentes.

Esta página é uma tradução do guia em inglês. Comandos, chaves de configuração e código não foram alterados; em caso de diferença, vale a versão em inglês. Ler em inglês → · Outros idiomas: 简体中文 · 日本語 · 한국어 · Español

Saiba quando a configuração mudar

Quando uma configuração, flag ou regra de permissão dessas ferramentas mudar, você recebe um e-mail semanal (em inglês), conferido na documentação oficial.

Resposta rápida: o arquivo que cada agente lê

  • Cursor: as regras do projeto são arquivos .mdc em .cursor/rules (um arquivo .md comum ali é ignorado). As User Rules ficam em Customize, depois Rules. As Team Rules vêm do dashboard nos planos Team e Enterprise. O AGENTS.md funciona na raiz e em subpastas.
  • Claude Code: ./CLAUDE.md ou ./.claude/CLAUDE.md para a equipe, ~/.claude/CLAUDE.md para você, ./CLAUDE.local.md para notas privadas do projeto. Execute /init para gerar um.
  • OpenAI Codex: AGENTS.md em ~/.codex para hábitos globais, depois um AGENTS.md (ou AGENTS.override.md) por diretório, da raiz do repo até onde você trabalha.
  • Gemini CLI: ~/.gemini/GEMINI.md globalmente e GEMINI.md no seu projeto. /memory show mostra o que está carregado.
  • GitHub Copilot: .github/copilot-instructions.md para o repo inteiro, .github/instructions/NAME.instructions.md com um glob applyTo para alguns arquivos, e AGENTS.md em qualquer lugar do repo.
  • Cline: arquivos markdown em .clinerules/ ou .cline/rules/ no projeto, e ~/Documents/Cline/Rules para regras globais.
  • Kiro: arquivos markdown de steering em .kiro/steering/ (workspace) ou ~/.kiro/steering/ (global), além do AGENTS.md.
  • Junie: .junie/AGENTS.md, depois um AGENTS.md na raiz, depois o legado .junie/guidelines.md. Diretrizes globais vão em ~/.junie/AGENTS.md.
  • Amp: AGENTS.md no diretório de trabalho e nos diretórios pais, além de ~/.config/amp/AGENTS.md.
  • goose: AGENTS.md e .goosehints, globalmente em ~/.config/goose/.goosehints ou por projeto.
  • Zed: ~/.config/zed/AGENTS.md para você, depois o primeiro arquivo do projeto que ele encontrar em uma lista que começa com .rules, .cursorrules e .windsurfrules e inclui AGENTS.md e CLAUDE.md.
  • Aider: nenhum arquivo especial. Escreva um CONVENTIONS.md e carregue-o com aider --read CONVENTIONS.md ou read: no .aider.conf.yml.

O AGENTS.md funciona em todos?

Quase. Estes agentes leem o AGENTS.md sem configuração extra: Cursor, Codex, GitHub Copilot, Cline, Kiro, Junie, Amp, goose e Zed. O Claude Code lê o AGENTS.md só quando o repo não tem CLAUDE.md. Se você mantiver os dois, adicione @AGENTS.md dentro do CLAUDE.md para que o Claude Code o importe. O Gemini CLI precisa de context.fileName no settings.json.

CLAUDE.md que reaproveita o AGENTS.md

@AGENTS.md

## Claude Code only
- Use plan mode for changes that touch more than three files.

Gemini CLI: .gemini/settings.json

{
  "context": {
    "fileName": ["AGENTS.md", "GEMINI.md"]
  }
}

E o .cursorrules?

A documentação atual de regras do Cursor descreve arquivos .mdc em .cursor/rules, User Rules, Team Rules e AGENTS.md. Ela não documenta um arquivo .cursorrules na raiz. Outras ferramentas ainda leem esse nome de arquivo: o Cline detecta .cursorrules automaticamente, e o Zed verifica .cursorrules em segundo lugar na sua lista de arquivos de instruções do projeto. Em projetos novos, coloque instruções compartilhadas no AGENTS.md e o escopo específico do Cursor em .cursor/rules.

Limitar uma regra a alguns arquivos

  • Cursor: globs no frontmatter do .mdc, com alwaysApply: false.
  • Claude Code: um campo paths em um arquivo markdown em .claude/rules/.
  • GitHub Copilot: applyTo no frontmatter de um arquivo .instructions.md.
  • Cline: uma lista paths no frontmatter YAML.
  • Kiro: inclusion: fileMatch com um fileMatchPattern.
  • Amp: globs no front matter de um arquivo que você @-menciona a partir do AGENTS.md.
  • Codex: coloque um AGENTS.md ou AGENTS.override.md na subpasta que precisa de regras diferentes.

.cursor/rules/components.mdc

---
globs: src/components/**/*.tsx
alwaysApply: false
---

- Use named exports, not default exports

.github/instructions/python.instructions.md

---
applyTo: "**/*.py"
---

Use type hints on every public function.

Guia completo de regras para cada agente

Fontes

Documentação oficial (em inglês) usada para conferir este guia. Versão em inglês revisada em: 2026-10-18

Mais guias em português