Cursor Project Rules (.cursor/rules/*.mdc): dove si trova e come lo leggono gli strumenti

Le regole di progetto di Cursor sono file .mdc in .cursor/rules/; il loro frontmatter stabilisce quando applicare ciascuna regola. Cursor legge anche AGENTS.md, oltre alle User Rules e alle Team Rules configurate al di fuori del repository.

Dove si trova

• .cursor/rules/**/*.mdc; sono ammesse le sottocartelle. I normali file .md in .cursor/rules vengono ignorati.
• AGENTS.md nella directory radice e nelle sottocartelle.
• User Rules, configurate nelle impostazioni di Cursor.
• Team Rules, configurate nella dashboard del team.

Formato

Markdown con frontmatter YAML; l'estensione .mdc è obbligatoria. alwaysApply: true include sempre la regola; con alwaysApply: false, globs la applica quando nel contesto è presente un file corrispondente; se è presente solo description, la decisione spetta all'Agent. Se non è presente nessuno di questi campi, la regola si applica solo quando la richiami con @-mention.

Chiavi del 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.

Priorità e unione

Team Rules, poi Project Rules e infine User Rules. Le regole applicabili vengono unite; in caso di conflitto prevale la fonte precedente. Le Team Rules imposte non possono essere disattivate. I file AGENTS.md nelle sottocartelle si combinano con quelli delle directory genitrici; prevale il file più specifico.

Strumenti che lo leggono

Suggerimenti

• Separa più glob con virgole nel campo globs.
• Mantieni ogni regola sotto le 500 righe e fai riferimento ai file con @filename invece di incollarne il contenuto.
• Le regole non influiscono su Cursor Tab e le User Rules non si applicano a Inline Edit.
• Il file legacy .cursorrules non è più menzionato nella documentazione di Cursor: spostalo in .cursor/rules/.

Altri file di istruzioni