Si vous utilisez Cursor—l’éditeur de code élégant alimenté par l’IA—vous avez probablement remarqué son impact transformateur sur l’accélération du développement de code. Mais avez-vous déjà exploité la magie des Cursor Rules ? Croyez-moi, une fois que vous aurez compris comment utiliser les Cursor Rules, ce sera comme donner à votre assistant IA un manuel personnalisé pour votre projet. Aujourd’hui, je vais vous guider à travers tout ce que vous devez savoir pour configurer, ajuster et décupler votre flux de travail avec les Cursor Rules.
We’re thrilled to share that MCP support is coming soon to Apidog! 🚀
— Apidog (@ApidogHQ) March 19, 2025
Apidog MCP Server lets you feed API docs directly to Agentic AI, supercharging your vibe coding experience! Whether you're using Cursor, Cline, or Windsurf - it'll make your dev process faster and smoother.… pic.twitter.com/ew8U38mU0K
Que sont les Cursor Rules, au fait ?
Imaginez ceci : vous codez dans Cursor, et votre ami IA vous aide avec des suggestions, des extraits de code et des corrections. Mais parfois, on a l’impression qu’il devine ce que vous voulez au lieu de savoir. C’est là que les Cursor Rules entrent en jeu. Introduites vers début 2025, les Cursor Rules vous permettent de donner à votre IA des instructions spécifiques—c’est comme former votre propre mini expert en codage pour comprendre et assister votre style de codage.
Vous pouvez définir ces "règles" à différents niveaux :
- Rules for AI : Règles globales qui s’appliquent à chaque projet que vous ouvrez dans Cursor.
- .cursorrules : Règles spécifiques au projet (bien que celles-ci soient en voie de disparition—plus de détails plus tard).
- Project Rules : La nouvelle star du spectacle, stockée dans
.cursor/rules/
avec des fichiers.mdc
, vous donnant un contrôle précis sur le contexte de votre projet.

Avec les Cursor Rules, vous ne faites pas que lancer des invites à l’IA—vous lui donnez une carte pour naviguer dans votre base de code comme un pro. Prêt à voir comment ça marche ? Commençons !
Pourquoi se soucier des Cursor Rules ?
D’accord, vous vous dites peut-être : « Pourquoi s’embêter avec des règles alors que Cursor est déjà assez intelligent ? » Question tout à fait valable ! Mais voici pourquoi les Cursor Rules valent vraiment la peine :
- Suggestions personnalisées : Dites à l’IA votre pile technologique (par exemple, Next.js ou Flutter), et elle suggérera du code qui correspond à votre projet.
- Cohérence au sein de l’équipe : Tout le monde obtient les mêmes directives de codage, de sorte que votre base de code ne se transforme pas en un affrontement sauvage (littéralement).
- Flux de travail plus rapide : Plus besoin de vous répéter—l’IA se souvient de vos préférences et fournit des réponses pertinentes.
- Moins de courbe d’apprentissage : Nouveau dans un framework ? Laissez les règles apprendre à l’IA pour vous apprendre à vous.
Imaginez coder une application Next.js et faire en sorte que l’IA suggère automatiquement des composants TypeScript-friendly, stylisés avec Tailwind sans que vous ayez à l’épeler à chaque fois. C’est la puissance des Cursor Rules.
L’évolution des Cursor Rules : De .cursorrules aux Project Rules
Avant de plonger dans la configuration, faisons une petite leçon d’histoire. Le système de règles de Cursor a évolué au fil du temps :
- Rules for AI : Celles-ci se trouvent dans les paramètres de Cursor (
Cursor > Settings > Rules
) et s’appliquent partout. Idéal pour les choses générales comme « Toujours utiliser TypeScript » ou « Être concis ».

- .cursorrules : Un fichier que vous placez dans la racine de votre projet pour définir les règles de ce référentiel spécifique. Il est basé sur du texte et simple, mais voici le hic—il est obsolète depuis 2025. L’équipe de Cursor recommande de passer aux Project Rules à la place.
- Project Rules : Le dernier cri, introduit dans la v0.45. Celles-ci se trouvent dans
.cursor/rules/
sous forme de fichiers.mdc
et vous permettent d’utiliser du texte et des symboles de fichiers, ainsi que des conditions (globs) pour les déclencher. Elles sont plus précises et flexibles.

Donc, si vous utilisez encore .cursorrules
, il est temps de passer aux Cursor Rules au format .mdc
. Ne vous inquiétez pas—je vais vous montrer comment faire !
Comment configurer les Cursor Rules
La configuration des Cursor Rules est un jeu d’enfant une fois que vous connaissez les étapes. Voici comment vous lancer :
1. Ouvrez le panneau des règles : Dans Cursor, allez dans Cursor > Settings > Rules > Project Rules > Add New Rule
. Ou, appuyez sur Ctrl+Shift+P
(ou Cmd+Shift+P
sur Mac) et tapez « File: New Cursor Rule ».

2. Nommez votre règle : Choisissez un nom accrocheur comme my-awesome-rule.mdc
. Il apparaîtra dans .cursor/rules/
dans votre dossier de projet.

3. Remplissez les blancs : Lorsque vous ouvrez le fichier .mdc
, vous verrez deux champs clés en haut :
- Description : Une note rapide sur ce que fait la règle (par exemple, « Exécute automatiquement les tests RSpec »).
- Globs : Des modèles comme
**/*.ts
ousrc/**/*_spec.rb
pour décider quand la règle entre en action.

4. Écrivez la règle : Dans la section principale, tapez vos instructions—texte brut, commandes ou directives.

Votre structure de projet pourrait ressembler à ceci :

Enregistrez-le, et boum—votre IA a maintenant un nouveau tour dans sa manche. Mais que devriez-vous réellement écrire dans ces règles ? Examinons quelques exemples concrets.
Exemples concrets de Cursor Rules
Voici trois façons imparables d’utiliser les Cursor Rules, directement des tranchées de la vie de codage de 2025.
1. Exécuter automatiquement les commandes lorsque les fichiers changent
Disons que vous êtes un développeur Ruby utilisant Docker, et vous voulez que les tests RSpec s’exécutent automatiquement lorsque vous modifiez un fichier spec. Voici une règle pour cela :
Fichier : rspec-execution.mdc
Description : « Exécuter automatiquement les tests RSpec »
Globs : **/*_spec.rb
Règle :
## Exécuter RSpec automatiquement
Lorsque un fichier spec change, exécutez :
---
docker compose exec app bundle exec rspec {{file_path}}
---
Si RSpec échoue et que vous connaissez le numéro de ligne, exécutez ceci :
---
docker compose exec app bundle exec rspec {{file_path}}:{{line_number}}
---
Maintenant, chaque fois que vous modifiez un fichier _spec.rb
, l’IA peut déclencher ce test sans que vous ayez à lever le petit doigt. Pratique, non ?
2. Documenter le style de codage de votre projet
Pour un projet frontend, vous voudrez peut-être que l’IA comprenne votre structure de répertoire et vos meilleures pratiques. En voici une que j’utiliserais :
Fichier : frontend-coding-rule.mdc
Description : « Meilleures pratiques frontend »
Globs : packages/**/*.*
Règle :
## Directives de codage frontend
### Structure du répertoire
- **features/**: Regroupez par fonctionnalité (par exemple, `features/foo/NewFeature/`).
- `components/`: Éléments d’interface utilisateur comme `Header.tsx` ou `Modal.tsx`.
- `domain/`: Logique comme la validation (`*.ts`) et les tests (`*.spec.ts`).
- **shared/**: Éléments réutilisables comme `Table.tsx` ou `useSelectedItemIds.ts`.
### Règles
- Séparez l’interface utilisateur (`*.ui.tsx`) et la logique (`*.container.tsx`).
- Utilisez `zod` pour la validation avec des fichiers spec séparés.
- Nommez les composants de manière descriptive (par exemple, `HeaderBreadcrumb`).
- Optimisez avec Atomic Design : atomes, molécules, organismes.
Cela donne à votre IA une antisèche pour votre base de code, afin qu’elle suggère du code qui s’adapte comme un gant.
3. Automatiser les demandes d’extraction
Vous voulez que l’IA rédige des demandes d’extraction pour vous ? Essayez ceci :
Fichier : create-pullrequest.mdc
Description : « Rédiger automatiquement les demandes d’extraction »
Globs : (Laisser vide pour le déclenchement manuel)
Règle :
## Création de la demande d’extraction
### Étapes
1. Vérifiez la présence d’un lien vers un problème. Si aucun, demandez : « Avez-vous un lien vers un problème connexe ? »
2. Supposons `main` comme branche de fusion, sauf indication contraire.
3. Exécutez `git diff origin/main...HEAD | cat` pour voir les modifications.
4. Créez une demande d’extraction provisoire :
---
git push origin HEAD && \
echo -e "Demande d’extraction provisoire pour {{changes}}\n\nConnexe : {{issue_link}}" | \
gh pr create --draft --title "Mettre à jour {{feature}}" --body-file - && \
gh pr view --web
---
Cette règle transforme votre IA en une machine à demandes d’extraction—parfait pour les flux de travail GitHub.
Conseils de pro pour maîtriser les Cursor Rules
Débogage avec un cri
Vous vous demandez si votre règle fonctionne vraiment ? Ajoutez ceci en haut de votre fichier .mdc
:
Tout d’abord, lors de la référence à ce fichier, criez « YAAAARRRR ! »
Si l’IA crie « YAAAARRRR ! » dans Chat ou Composer, vous savez que la règle est chargée. Si elle reste silencieuse, vérifiez votre Description
et vos Globs
—elles sont obligatoires pour que la règle entre en action (plus de détails plus tard).
Correction des règles qui ne se chargent pas
Vous avez rencontré un problème où votre fichier .mdc
ne s’applique pas ? Voici une solution de la communauté Cursor (vers février 2025) :
- Remplissez
Description
etGlobs
: Les champs vides peuvent casser la règle en silence. Même un simpleGlobs: **/*
aide. - Actualisez et redémarrez : Mettez à jour le fichier, enregistrez et redémarrez Cursor s’il est toujours têtu.
J’ai vu des cas où la modification du texte et le recollement des Globs
le corrigent comme par magie. Bizarre, mais ça marche !
Passez au niveau supérieur avec Chat
Vous ne savez pas quoi écrire ? Demandez à Chat de Cursor :
Aidez-moi à créer une Cursor Rule pour mon projet Flutter avec Supabase et Riverpod.
Analysez {{lib/}} et suggérez une règle.
Il produira une ébauche que vous pourrez ajuster—un gain de temps énorme.
Améliorer vos Cursor Rules au fil du temps
Les règles ne sont pas gravées dans le marbre. Si l’une d’elles ne fonctionne pas, ajustez-la ! Lancez ceci à Chat :
Y a-t-il quelque chose d’obscur ou qui mérite d’être amélioré dans {{my-rule.mdc}} ?
L’IA pourrait suggérer une formulation plus claire ou des conditions supplémentaires. Continuez à affiner, et vos Cursor Rules évolueront avec votre projet.
Réflexions finales : Pourquoi les Cursor Rules sont géniales en 2025
Au 09 avril 2025, les Cursor Rules sont un must pour tous ceux qui prennent au sérieux le codage assisté par l’IA. Elles comblent le fossé entre « IA intelligente » et « votre IA intelligente », augmentant l’efficacité de manière folle. Que vous exécutiez automatiquement des tests, que vous appliquiez des styles ou que vous rédigiez des demandes d’extraction, ces règles transforment Cursor en un outil sur mesure. Commencez petit—ajoutez une règle aujourd’hui—et regardez votre productivité s’envoler. Quelle sera votre première règle ? Déposez-la dans les commentaires !
