As regras fornecem instruções de nível de sistema para o Agent e Inline Edit. Pense nelas como contexto persistente, preferências ou fluxos de trabalho para seus projetos. O Cursor suporta três tipos de regras:

Regras de Projeto

Armazenadas em .cursor/rules, controladas por versão e com escopo definido para sua base de código.

Regras de Usuário

Globais para seu ambiente Cursor. Definidas nas configurações e sempre aplicadas.

.cursorrules (Legado)

Ainda suportado, mas descontinuado. Use Regras de Projeto em vez disso.

​
Como as regras funcionam

Modelos de linguagem grandes não mantêm memória entre completions. As regras fornecem contexto persistente e reutilizável no nível do prompt. Quando aplicadas, o conteúdo das regras é incluído no início do contexto do modelo. Isso dá ao AI orientação consistente para gerar código, interpretar edições ou ajudar com fluxos de trabalho.
Regra aplicada no contexto com chat
As regras se aplicam ao Chat e Edição Inline. Regras ativas aparecem na barra lateral do Agent.

​
Regras do projeto

As regras do projeto ficam em .cursor/rules. Cada regra é um arquivo e é controlada por versão. Elas podem ser definidas usando padrões de caminho, invocadas manualmente ou incluídas com base na relevância. Subdiretórios podem incluir seu próprio diretório .cursor/rules com escopo para essa pasta. Use regras do projeto para:
  • Codificar conhecimento específico do domínio sobre sua base de código
  • Automatizar fluxos de trabalho ou templates específicos do projeto
  • Padronizar decisões de estilo ou arquitetura

​
Anatomia da regra

Cada arquivo de regra é escrito em MDC (.mdc), um formato que suporta metadados e conteúdo. Controle como as regras são aplicadas através do dropdown de tipo que altera as propriedades description, globs, alwaysApply.
Tipo de RegraDescrição
AlwaysSempre incluída no contexto do modelo
Auto AttachedIncluída quando arquivos que correspondem a um padrão glob são referenciados
Agent RequestedDisponível para a IA, que decide se deve incluí-la. Deve fornecer uma descrição
ManualIncluída apenas quando explicitamente mencionada usando @ruleName
---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts
Arquivos referenciados como @service-template.ts são incluídos como contexto adicional quando a regra é acionada.

​
Regras aninhadas

Organize regras colocando-as em diretórios .cursor/rules por todo o seu projeto. Regras aninhadas se anexam automaticamente quando arquivos em seu diretório são referenciados. 
project/
  .cursor/rules/        # Regras do projeto inteiro
  backend/
    server/
      .cursor/rules/    # Regras específicas do backend
  frontend/
    .cursor/rules/      # Regras específicas do frontend

​
Criando uma regra

Crie regras usando o comando New Cursor Rule ou indo para Cursor Settings > Rules. Isso cria um novo arquivo de regra em .cursor/rules. Nas configurações você pode ver todas as regras e seu status.
Comparison of concise vs long rules

​
Gerando regras

Gere regras diretamente em conversas usando o comando /Generate Cursor Rules. Útil quando você tomou decisões sobre o comportamento do agente e quer reutilizá-las.

​
Melhores práticas

Boas regras são focadas, acionáveis e bem definidas.
  • Mantenha as regras com menos de 500 linhas
  • Divida regras grandes em múltiplas regras compostas
  • Forneça exemplos concretos ou arquivos de referência
  • Evite orientações vagas. Escreva regras como documentação interna clara
  • Reutilize regras ao repetir prompts no chat

​
Exemplos

Muitos exemplos disponíveis de provedores e frameworks. Regras contribuídas pela comunidade são encontradas em coleções colaborativas e repositórios online.

​
Regras do Usuário

As regras do usuário são preferências globais definidas em Cursor Settings → Rules que se aplicam a todos os projetos. Elas são texto simples e perfeitas para definir estilo de comunicação preferido ou convenções de codificação: 
Please reply in a concise style. Avoid unnecessary repetition or filler language.

​
.cursorrules (Legado)

O arquivo .cursorrules na raiz do seu projeto ainda é suportado, mas será descontinuado. Recomendamos migrar para as Regras do Projeto para ter mais controle, flexibilidade e visibilidade.

​
FAQ