Cursor Project Rules (.cursor/rules/*.mdc): onde fica e como as ferramentas o leem

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.

Onde fica

• .cursor/rules/**/*.mdc; subpastas são permitidas. Arquivos .md simples em .cursor/rules são ignorados.
• AGENTS.md na raiz e em pastas aninhadas.
• User Rules, configuradas nas definições do Cursor.
• Team Rules, configuradas no painel da equipe.

Formato

Markdown com frontmatter YAML; a extensão .mdc é obrigatória. alwaysApply: true inclui sempre a regra; globs com alwaysApply: false incluem a regra quando um arquivo correspondente está no contexto; somente uma description deixa a decisão a cargo do Agent. Sem nenhum desses campos, a regra só se aplica quando você a menciona com @.

Chaves do frontmatter: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Precedência e combinação

Team Rules, depois Project Rules e, por fim, User Rules. Todas as regras aplicáveis são combinadas, e a fonte anterior prevalece em caso de conflito; não é possível desativar Team Rules impostas. Arquivos AGENTS.md aninhados são combinados com os arquivos ancestrais, e o arquivo mais específico prevalece.

Ferramentas que o leem

Dicas

• Separe vários globs com vírgulas no campo globs.
• Mantenha cada regra com menos de 500 linhas e referencie arquivos com @filename em vez de colá-los.
• As regras não afetam o Cursor Tab, e as User Rules não se aplicam ao Inline Edit.
• O arquivo legado .cursorrules não é mais mencionado na documentação do Cursor; mova-o para .cursor/rules/.

Outros arquivos de instruções