Règles et instructions Officiel

Cursor Rules

Instructions persistantes pour Cursor Agent : règles .mdc de projet, règles utilisateur, AGENTS.md.

Auteur
Cursor (Anysphere)
Compatible avec
Cursor
Documenté
Oct 2, 2026

Ce qu'est Cursor Rules

Les règles fournissent un contexte réutilisable inclus au début du contexte du modèle. Les règles de projet se trouvent dans .cursor/rules sous forme de fichiers .mdc versionnés avec frontmatter. Cursor prend aussi en charge les User Rules, les Team Rules et AGENTS.md comme alternative plus simple.

Ce qu'il fait

Comment Cursor Rules s'intègre : quels agents l'exécutent et ce qu'il ajouteS'EXÉCUTE DANSVotre agentCursorun hôte documentéRULES · OFFICIELCursor RulesInstructions de projet lues par l…4 étapes d'installationaucune autorisation supplémentair…CE QU'IL AJOUTECe qu'il faitRègles de projet dans .cursor/rul…Quatre modes d'application : Alwa…User Rules (globales), Team Rules…/create-rule dans le chat Agent g…agent → extension → nouvelle capacité · depuis le dépôt ou la documentation officielle
Où Cursor Rules s'exécute et ce qu'il ajoute, d'après sa documentation
  • Règles de projet dans .cursor/rules sous forme de fichiers .mdc avec frontmatter description, globs et alwaysApply
  • Quatre modes d'application : Always, Intelligently (selon la description), Specific Files (globs), Manual (@-mention)
  • User Rules (globales), Team Rules (dashboard, offres Team/Enterprise) et AGENTS.md
  • /create-rule dans le chat Agent génère un fichier de règle

Quand l'utiliser

Bonne adéquation

  • Encoder les conventions de la base de code que Agent doit suivre à chaque session
  • Limiter les consignes à certains chemins avec des globs
  • Partager des règles avec une équipe via les Team Rules

Pas pour

  • Fichiers .md simples dans .cursor/rules : ils sont ignorés ; utilisez .mdc ou AGENTS.md
  • Copier des guides de style entiers : utilisez plutôt un linter

Comment installer Cursor Rules

Il vous faut : Cursor

  1. Tapez /create-rule dans Agent et décrivez la règle, ou ouvrez Customize > Rules > Add Rule
  2. La règle est enregistrée dans .cursor/rules/.mdc
  3. Définissez le frontmatter : description, globs, alwaysApply
  4. Commitez le dossier pour que l'équipe le partage
Exemple de configuration (tiré de la documentation officielle)
---
globs: src/components/**/*.tsx
alwaysApply: false
---
- Use named exports, not default exports

Limites

  • La doc recommande de garder les règles sous 500 lignes
  • Les Team Rules nécessitent une offre Team ou Enterprise

Outils qu'il étend

Questions fréquentes

Quelle extension de fichier les règles de projet Cursor exigent-elles ?

Elles doivent être en .mdc ; un .md simple dans .cursor/rules est ignoré. source

Comment Cursor décide-t-il quand appliquer une règle ?

alwaysApply true l'inclut toujours ; les globs l'attachent automatiquement aux fichiers correspondants ; une description seule laisse Agent décider ; sans rien, @-mention uniquement. source

Cursor prend-il en charge AGENTS.md ?

Oui, comme alternative simple à .cursor/rules. source

Comment créer rapidement une règle Cursor ?

Tapez /create-rule dans le chat Agent. source

Guides associés

Sources et lacunes

Non précisé par les mainteneurs : Cursor est en source fermée ; repo_url est un espace réservé pour l'organisation publique getcursor, pas un repo de règles vérifié; docs.cursor.com/en/context/rules servait une coquille SPA ; contenu lu depuis cursor.com/docs/rules; Dépôt source public (source fermée ou non vérifiée).

Autres extensions à découvrir