Cursor Project Rules (.cursor/rules/*.mdc) : emplacement et lecture par les outils

Les Project Rules de Cursor sont des fichiers .mdc dans .cursor/rules/ ; leur frontmatter détermine quand chaque règle est ajoutée au contexte. Cursor lit également AGENTS.md, ainsi que les User Rules et Team Rules définies en dehors du dépôt.

Emplacement

• .cursor/rules/**/*.mdc ; les sous-répertoires sont autorisés. Les fichiers .md simples dans .cursor/rules sont ignorés.
• AGENTS.md à la racine et dans les sous-répertoires.
• User Rules, définies dans les paramètres de Cursor.
• Team Rules, définies dans le tableau de bord de l’équipe.

Format

Markdown avec frontmatter YAML ; l’extension .mdc est obligatoire. alwaysApply: true inclut toujours la règle. Avec alwaysApply: false, les globs l’appliquent lorsqu’un fichier correspondant est présent dans le contexte. Avec description uniquement, l’Agent décide. Si aucun de ces champs n’est défini, la règle ne s’applique que si vous la mentionnez avec @.

Clés du 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é et fusion

Team Rules, puis Project Rules, puis User Rules. Toutes les règles applicables sont fusionnées ; en cas de conflit, la source antérieure l’emporte. Les Team Rules imposées ne peuvent pas être désactivées. Les fichiers AGENTS.md imbriqués se combinent avec ceux de leurs répertoires parents, le fichier le plus spécifique l’emportant.

Outils qui le lisent

Conseils

• Séparez plusieurs globs par des virgules dans le champ globs.
• Limitez chaque règle à 500 lignes et référencez les fichiers avec @filename au lieu de les copier.
• Les règles ne s'appliquent pas à Cursor Tab, et les règles utilisateur ne s'appliquent pas à Inline Edit.
• Le fichier historique .cursorrules n'est plus mentionné dans la documentation de Cursor ; déplacez-le dans .cursor/rules/.

Autres fichiers d’instructions