Project Rules
Stockées dans
.cursor/rules
, versionnées et limitées à ta base de code.User Rules
Globales à ton environnement Cursor. Définies dans les paramètres et toujours appliquées.
AGENTS.md
Instructions d’Agent au format Markdown. Alternative simple à
.cursor/rules
..cursorrules (Legacy)
Toujours pris en charge, mais obsolète. Utilise plutôt les Project Rules.
Comment fonctionnent les règles

Les règles s’appliquent à Chat et à Inline
Edit. Les règles actives s’affichent dans la barre latérale de l’Agent.
Règles du projet
.cursor/rules
. Chaque règle est un fichier versionné. Elles peuvent être ciblées via des motifs de chemin, invoquées manuellement, ou incluses en fonction de leur pertinence. Les sous-répertoires peuvent inclure leur propre dossier .cursor/rules
limité à ce dossier.
Utilise les règles du projet pour :
- Encoder des connaissances spécifiques à ton codebase
- Automatiser des workflows ou des templates propres au projet
- Standardiser les décisions de style ou d’architecture
Anatomie d’une règle
.mdc
), un format qui prend en charge les métadonnées et le contenu. Gère comment les règles sont appliquées via la liste déroulante du type, qui modifie les propriétés description
, globs
, alwaysApply
.
Rule Type | Description |
---|---|
Always | Toujours inclus dans le contexte du modèle |
Auto Attached | Inclus quand des fichiers correspondant à un motif glob sont référencés |
Agent Requested | Disponible pour l’IA, qui décide s’il faut l’inclure. Doit fournir une description |
Manual | Inclus uniquement quand il est explicitement mentionné avec @ruleName |
Règles imbriquées
.cursor/rules
à travers ton projet. Les règles imbriquées s’appliquent automatiquement quand des fichiers de leur répertoire sont référencés.
Créer une règle
New Cursor Rule
ou via Cursor Settings > Rules
. Ça crée un nouveau fichier de règle dans .cursor/rules
. Depuis les paramètres, tu peux voir toutes les règles et leur état.

Génération de règles
/Generate Cursor Rules
. Pratique quand t’as défini le comportement de l’agent et que tu veux le réutiliser.
Bonnes pratiques
- Garde les règles sous la barre des 500 lignes
- Scinde les règles volumineuses en plusieurs règles composables
- Fournis des exemples concrets ou des fichiers de référence
- Évite les consignes vagues. Écris les règles comme une doc interne claire
- Réutilise les règles quand tu répètes des prompts dans le chat
Exemples
Normes pour les composants frontend et la validation d’API
Normes pour les composants frontend et la validation d’API
Cette règle définit des normes pour les composants frontend :Dans le répertoire components :
- Utilise toujours Tailwind pour le style
- Utilise Framer Motion pour les animations
- Suis les conventions de nommage des composants
- Utilise zod pour toute validation
- Définit les types de retour avec des schémas zod
- Exporte les types générés à partir des schémas
Modèles pour les services Express et les composants React
Modèles pour les services Express et les composants React
Cette règle fournit un modèle pour les services Express :Utilise ce modèle lors de la création d’un service Express :
- Suis les principes RESTful
- Inclue un middleware de gestion des erreurs
- Mets en place une journalisation adéquate
- Interface des props en haut
- Composant exporté nommément
- Styles en bas
Automatisation des workflows de dev et génération de documentation
Automatisation des workflows de dev et génération de documentation
Cette règle automatise l’analyse de l’app :Quand on te demande d’analyser l’app :
- Lance le serveur de dev avec
npm run dev
- Récupère les logs depuis la console
- Propose des améliorations de performance
- Extrayant les commentaires de code
- Analysant README.md
- Générant de la documentation Markdown
Ajouter un nouveau réglage dans Cursor
Ajouter un nouveau réglage dans Cursor
Commence par créer une propriété à basculer dans Pour l’utiliser dans l’app, importe reactiveStorageService et utilise la propriété :
@reactiveStorageTypes.ts
.Ajoute une valeur par défaut dans INIT_APPLICATION_USER_PERSISTENT_STORAGE
dans @reactiveStorageService.tsx
.Pour les fonctionnalités bêta, ajoute un toggle dans @settingsBetaTab.tsx
, sinon ajoute-le dans @settingsGeneralTab.tsx
. Les toggles peuvent être ajoutés comme <SettingsSubSection>
pour les cases à cocher générales. Regarde le reste du fichier pour des exemples.AGENTS.md
AGENTS.md
est un simple fichier Markdown pour définir des instructions d’agent. Place-le à la racine de ton projet comme alternative à .cursor/rules
pour des cas d’usage simples.
Contrairement aux règles de projet, AGENTS.md
est un fichier Markdown brut, sans métadonnées ni configurations complexes. C’est parfait pour les projets qui ont besoin d’instructions simples et lisibles, sans le surcoût de règles structurées.
Règles utilisateur
.cursorrules
(Ancien)
.cursorrules
à la racine de ton projet est toujours pris en charge, mais il sera bientôt obsolète. On te recommande de migrer vers Project Rules pour plus de contrôle, de flexibilité et de visibilité.
FAQ
Pourquoi ma règle n’est-elle pas appliquée ?
Pourquoi ma règle n’est-elle pas appliquée ?
Vérifie le type de règle. Pour
Agent Requested
, assure-toi qu’une description est définie. Pour Auto Attached
, assure-toi que le pattern de fichier correspond aux fichiers référencés.Les règles peuvent-elles référencer d’autres règles ou fichiers ?
Les règles peuvent-elles référencer d’autres règles ou fichiers ?
Oui. Utilise
@filename.ts
pour inclure des fichiers dans le contexte de ta règle.Puis-je créer une règle depuis le chat ?
Puis-je créer une règle depuis le chat ?
Oui, génère des règles de projet depuis le chat avec la commande
/Generate Cursor Rules
.
Si Memories est activé, des memories sont générées automatiquement.Les règles impactent-elles Cursor Tab ou d’autres fonctionnalités d’IA ?
Les règles impactent-elles Cursor Tab ou d’autres fonctionnalités d’IA ?
Non. Les règles s’appliquent uniquement à Agent et à Inline Edit.