Configuração de regras do Cursor: regras de projeto, de usuário e Team Rules, frontmatter .mdc, globs e AGENTS.md

• Project Rules: arquivos .mdc em .cursor/rules. Ficam sob controle de versão e com escopo no codebase. Subpastas são suportadas.
• User Rules: preferências globais definidas nas configurações de regras do Cursor. Valem em todos os projetos.
• Team Rules: gerenciadas pelo painel do Cursor nos planos Team e Enterprise.
• AGENTS.md: instruções em markdown simples, sem metadados.

Regras de projeto precisam usar a extensão .mdc. Um arquivo .md comum em .cursor/rules é ignorado pelo sistema de regras.

• Always Apply: alwaysApply: true. Incluída em toda sessão de chat.
• Apply to Specific Files: alwaysApply: false mais globs. Anexada quando um arquivo correspondente está no contexto.
• Apply Intelligently: alwaysApply: false mais description, sem globs. O Agent a puxa quando relevante.
• Apply Manually: sem description nem globs. Usada só quando você a menciona com @.

Separe vários padrões glob com vírgulas. Por exemplo, src/**/*.tsx corresponde a arquivos .tsx dentro de src/.

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

- Use named exports, not default exports
- Keep components under 200 lines
- Prefer composition over prop drilling

---
alwaysApply: true
---

- Read the relevant source files before proposing changes
- Never modify generated files in dist/ or build/

Uma referência @file dentro de uma regra diz ao Agent onde procurar. O arquivo não é incluído inline, então coloque no corpo da regra tudo que precisa estar sempre no contexto.

• Disponíveis nos planos Team e Enterprise. Admins as criam e gerenciam no painel do Cursor.
• Team Rules são texto livre e não usam a estrutura de pastas .cursor/rules.
• Cada regra pode ser obrigatória ou opcional. Usuários podem desativar uma Team Rule não obrigatória em Team Rules, no Customize. Uma regra obrigatória não pode ser desativada ali.
• Uma regra com padrão glob vale só quando arquivos correspondentes estão no contexto. Uma regra sem glob vale para toda conversa.
• Deixe a caixa de ativação desmarcada para salvar uma regra como rascunho, que não vale até você ativá-la.
• Team Rules ativadas são incluídas no contexto do Agent (Chat) em todos os repositórios e projetos do time.

O Cursor observa que orientações de IA não devem ser seu único controle de segurança, mesmo com regras obrigatórias.

Coloque o AGENTS.md na raiz do projeto. Arquivos AGENTS.md aninhados em subdiretórios valem ao trabalhar naquele diretório. Eles se combinam com os arquivos pai, e o arquivo mais específico vence.

• A precedência é Team Rules, depois Project Rules, depois User Rules. Todas as regras são mescladas, e as fontes anteriores vencem em conflitos.
• User Rules valem só para o Agent, não para o Inline Edit.
• As regras não afetam o Cursor Tab.
• Mantenha cada regra com menos de 500 linhas e divida as grandes em regras menores.