Regras & instruções Oficial

Cursor Rules

Persistent prompt-level instructions for Cursor Agent: project .mdc rules, user rules, team rules and AGENTS.md.

Autor
Cursor (Anysphere)
Funciona com
Cursor
Documentado
Oct 2, 2026

O que é Cursor Rules

Rules provide reusable context included at the start of the model context. Project rules live in .cursor/rules as version-controlled .mdc files with frontmatter. Cursor also supports User Rules, Team Rules and AGENTS.md as a simpler alternative.

O que ela faz

Como o Cursor Rules se integra: quais agentes o executam e o que ele acrescentaEXECUTA EMSeu agenteCursorum host documentadoRULES · OFICIALCursor RulesInstruções do projeto que o agent…4 etapas de instalaçãosem permissões extras listadasO QUE ELA ACRESCENTAO que ela fazProject rules in .cursor/rules as…Four apply modes: Always, Intelli…User Rules (global), Team Rules (…/create-rule in Agent chat genera…agente → extensão → nova capacidade · do repositório ou da documentação oficial
Onde Cursor Rules roda e o que acrescenta, segundo a documentação
  • Project rules in .cursor/rules as .mdc files with description, globs and alwaysApply frontmatter
  • Four apply modes: Always, Intelligently (by description), Specific Files (globs), Manual (@-mention)
  • User Rules (global), Team Rules (dashboard, Team/Enterprise plans) and AGENTS.md
  • /create-rule in Agent chat generates a rule file

Quando usar

Boa adequação

  • Encode codebase conventions that Agent should follow every session
  • Scope guidance to certain paths with globs
  • Share rules with a team via Team Rules

Não indicado para

  • Plain .md files in .cursor/rules: they are ignored; use .mdc or AGENTS.md
  • Copying whole style guides: use a linter instead

Como instalar o Cursor Rules

Você precisa de: Cursor

  1. Type /create-rule in Agent and describe the rule, or open Customize > Rules > Add Rule
  2. Rule is saved to .cursor/rules/.mdc
  3. Set frontmatter: description, globs, alwaysApply
  4. Commit the folder so the team shares it
Exemplo de configuração (da documentação oficial)
---
globs: src/components/**/*.tsx
alwaysApply: false
---
- Use named exports, not default exports

Limitações

  • Docs recommend keeping rules under 500 lines
  • Team Rules need Team or Enterprise plan

Ferramentas que ela estende

Perguntas frequentes

What file extension do Cursor project rules need?

They must be .mdc; a plain .md in .cursor/rules is ignored. fonte

How does Cursor decide when to apply a rule?

alwaysApply true always includes it; globs auto-attach on matching files; a description alone lets Agent decide; none means @-mention only. fonte

Does Cursor support AGENTS.md?

Yes, as a simple alternative to .cursor/rules. fonte

How do I create a Cursor rule quickly?

Type /create-rule in Agent chat. fonte

Guias relacionados

Fontes e lacunas

Não informado pelos mantenedores: Cursor is closed source; repo_url is a placeholder for the public getcursor org, not a verified rules repo; docs.cursor.com/en/context/rules served an SPA shell; content read from cursor.com/docs/rules; Public source repository (closed source or not verified).

Mais extensões para conhecer