Regras do Cursor: arquivos .mdc, modos de aplicação e AGENTS.md em 2026

Como funciona

• Digite /create-rule no chat do Agent e descreva a regra, ou abra Customize > Rules > Add Rule.
• A regra é salva em .cursor/rules/<name>.mdc; defina description, globs e alwaysApply no frontmatter.
• Existem quatro modos de aplicação: Always, Intelligently (pela descrição), Specific Files (por globs) e Manual (menção com @).
• Faça commit da pasta .cursor/rules para que toda a equipe compartilhe as mesmas regras.
• Para uma configuração mais simples, coloque um AGENTS.md na raiz do repositório; arquivos AGENTS.md aninhados atendem pacotes de monorepo e vale o mais próximo.

Como é um arquivo de regras

Uma regra .mdc tem frontmatter (description, globs, alwaysApply) e instruções em texto simples. O AGENTS.md não tem frontmatter e é lido por vários agentes, não só pelo Cursor.

Arquivo: .cursor/rules/<name>.mdc (project) · AGENTS.md (repo root)

---
description: Como escrevemos componentes React neste repositório
globs: ["src/**/*.tsx"]
alwaysApply: false
---

- Use componentes de função e hooks; sem componentes de classe.
- Coloque os testes junto do componente como <Component>.test.tsx.
- Nunca importe de `../../..`; use o alias `@/`.

---
globs: src/components/**/*.tsx
alwaysApply: false
---
- Use named exports, not default exports

{
  "context": {
    "fileName": "AGENTS.md"
  }
}

A lista (2)

Perguntas frequentes