Rules Cursor (.mdc)
Propre à Cursor : une rule est un fichier .mdc de .cursor/rules/ qui porte les consignes d'un domaine. Son en-tête dit quand la charger : toujours, selon le chemin ou selon sa description.
- cursor
- rules
- mdc
- alwaysApply
- globs
- frontmatter
Syntaxe
.cursor/rules/<domaine>.mdc---description: <quand la rule est utile, pour un chargement à la demande>globs: <chemins qui déclenchent la rule, par exemple prisma/**>alwaysApply: <true = chargée à chaque session, à réserver à deux ou trois rules>---<consignes en puces>Exemple
---description: Conventions Prisma de Central Campus (schéma, migrations, imports)globs: prisma/**,src/lib/prisma.tsalwaysApply: false---- Importer le client depuis @/generated/prisma/client- Après une modification du schéma : npx prisma generateRésultat attendu : la rule est chargée quand on modifie prisma/schema.prisma,et ignorée quand on modifie une page.À retenir
- alwaysApply n'indique pas l'importance d'une rule : c'est un coût en tokens payé à chaque session.
- Une rule par domaine (Prisma, tests, styles) : une rule « tout le dépôt » n'est qu'un AGENTS.md mal rangé.
- Quand un comportement surprend, pensez aux User Rules personnelles : elles s'ajoutent aux rules du projet et sont une source fréquente de conflit.
- Piège : une rule sans globs avec une description vague. Elle est alors chargée au hasard, ou jamais.
Voir aussi
- Les quatre couches d'instructionsLes consignes d'un agent viennent de quatre couches : vos règles personnelles, le fichier du projet, les rules ciblées par chemin et les skills chargés à la demande. Chaque consigne a sa place.
- Un AGENTS.md courtPlus le fichier d'instructions est long, moins chaque consigne est suivie. Un bon AGENTS.md tient en quelques dizaines de lignes de puces et renvoie vers la documentation au lieu de la copier.
- .cursorignorePropre à Cursor : .cursorignore liste les fichiers que l'éditeur ne doit ni indexer ni fournir à l'IA, comme les secrets. Ce que l'agent ne lit pas, il ne peut pas le divulguer.