Fichier .cursorrules (Règles du projet pour l'IA)
Fichier de configuration spécial à la racine du dépôt (.cursorrules). Il transmet automatiquement au modèle les règles de style de code, la stack technologique, les bibliothèques interdites et les contraintes architecturales avant chaque génération.
1. Aperçu du concept et de sa finalité
Lorsque vous collaborez avec une IA sur un projet, vous remarquerez rapidement ses mauvaises habitudes :
- Elle décide soudainement d'installer une version obsolète d'une bibliothèque abandonnée depuis trois ans.
- Elle écrit du code en JavaScript au lieu d'utiliser TypeScript strict.
- Elle invente sa propre structure de dossiers, cassant l'architecture de votre site.
Le fichier .cursorrules est la loi de votre projet. Il s'agit d'un ensemble concis de règles, au format texte brut ou Markdown, que vous placez une fois pour toutes à la racine du projet. À chaque tentative de l'IA pour écrire ou modifier ne serait-ce qu'une ligne de code, elle doit impérativement se conformer à ce fichier.
Principe d'ingénierie clé : la méthode la plus simple pour maintenir le code propre et ordonné sans prodiguer des directives ennuyeuses quotidiennes au modèle.
2. Anatomie du fichier .cursorrules idéal
Voici un modèle prêt à l'emploi, que vous pouvez copier dans votre projet dès maintenant :
# Stack technologique et standards du projet
- Langage : TypeScript (mode strict activé : strict: true)
- Framework : Next.js (App Router)
- Styles : Tailwind CSS (aucun style inline ni CSS classique)
- Base de données : Drizzle ORM + PostgreSQL / SQLite
# Règles pour l'agent :
1. Écrivez toujours des implémentations complètes des fichiers. Ne laissez jamais de commentaires paresseux du type "// ... le reste du code ici".
2. Tous les textes destinés à l'utilisateur et tous les boutons doivent être en ukrainien.
3. Avant d'ajouter un nouveau paquet npm, vérifiez si un équivalent n'est pas déjà installé dans package.json.
4. Si vous détectez une erreur architecturale, expliquez d'abord le risque, puis proposez des modifications.
3. Quatre interdits absolus
- Interdiction des commentaires paresseux : Le pire scénario survient lorsque le modèle efface le milieu de votre code fonctionnel pour insérer
// ... keep existing code. Interdisez explicitement cette pratique. - Verrouillage des versions de bibliothèques : Précisez par exemple : « Utilisez uniquement Lucide-React pour les icônes », afin d'éviter que le modèle n'importe simultanément FontAwesome et HeroIcons.
- Règles de nommage des composants : Indiquez : « Les noms de composants sont en PascalCase, les utilitaires en camelCase ».
- Exigences de typage : Interdisez l'utilisation du type
anyen TypeScript.
4. Pourquoi cela vous fait gagner des heures de débogage
Grâce à .cursorrules, le modèle se comporte dès la première seconde comme un développeur expérimenté de votre équipe, maîtrisant parfaitement les standards internes. Vous obtenez un code qui compile du premier coup, sans conflits syntaxiques !
FAQ: Fichier .cursorrules (Règles du projet pour l'IA)
Termes associés
Règles d'agent (.cursorrules / CLAUDE.md / AGENTS.md)
Fichiers de spécifications architecturales et de contraintes lisibles par machine dans le dépôt, montés automatiquement dans le contexte système des agents IA pour prévenir la dégradation de la base de code.
Cursor Composer (Édition agentique multi-fichiers)
Mode d'édition agentique phare de l'éditeur de code Cursor (Ctrl+I / Cmd+I). Permet à l'intelligence artificielle de créer, modifier et relier simultanément des dizaines de fichiers du projet, d'exécuter des commandes dans le terminal et de vérifier les erreurs.
Spécification avant le code (Vibe Coding Spec-First)
Méthodologie d'ingénierie de développement assisté par IA (Spec-Driven Development). Au lieu d'une génération de code immédiate et chaotique, le développeur demande d'abord au modèle de créer un fichier SPEC.md structuré contenant l'architecture, les types de données et les étapes de mise en œuvre.