---
title: "Cursor Project Rules (.cursor/rules/*.mdc): caminhos e formato · DotsAgent"
description: "Onde .cursor/rules/*.mdc fica, seu formato e frontmatter, como cópias globais e aninhadas são combinadas e quais ferramentas o leem. Verificado em 2026-10-01."
url: https://dotsagent.io/pt/instructions/files/cursor-rules
---

.cursor/rules/*.mdc

# 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: `description``globs``alwaysApply`

`.cursor/rules/*.mdc`

```
---
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

| Ferramenta | Suporte |
| --- | --- |
| [Cline](https://docs.cline.bot/features/cline-rules) | Detecta um arquivo .cursorrules legado. |

## 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/.

Gere um AGENTS.md e arquivos de regras correspondentes para cinco ferramentas a partir de um único formulário. [Abrir o gerador de AGENTS.md →](https://dotsagent.io/pt/instructions)

## Outros arquivos de instruções

[AGENTS.md](https://dotsagent.io/pt/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/pt/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/pt/instructions/files/gemini-md)

[.github/copilot-instructions.md](https://dotsagent.io/pt/instructions/files/github-copilot-instructions)

[.devin/rules/*.md](https://dotsagent.io/pt/instructions/files/windsurf-rules)

[.clinerules/](https://dotsagent.io/pt/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/pt/instructions/files/openclaw-workspace)

## Fontes

1. [cursor.com](https://cursor.com/docs/context/rules)/docs/context/rules

Referência independente para quem cria agentes de IA. Não temos vínculo com nenhum dos fornecedores mencionados aqui.

© 2026 DotsAgent · Fatos verificados em 1 de outubro de 2026