Comment utiliser les règles du curseur : l’arme secrète de votre assistant de codage IA

Découvrez les règles Cursor ! Guide 2025 : configurer, utiliser et ajuster les règles de projet pour coder avec l'IA.

Louis Dupont

Louis Dupont

5 June 2025

Comment utiliser les règles du curseur : l’arme secrète de votre assistant de codage IA

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.

💡
Avant de commencer, voici une astuce rapide : Obtenez Apidog gratuitement ! C’est un outil puissant pour les développeurs afin de simplifier le MCP, de tester les modèles d’IA et de rationaliser les tests d’API. Essayez-le dès aujourd’hui For Free !
button

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 :

cursor rules display image

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 :

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 :

cursor rules
project rules structure

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 ».

project rules

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.

add a custom name

3. Remplissez les blancs : Lorsque vous ouvrez le fichier .mdc, vous verrez deux champs clés en haut :

provide a description

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

write a rule

Votre structure de projet pourrait ressembler à ceci :

project structure

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) :

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 !

button
Apidog Ui image

Explore more

Fathom-R1-14B : Modèle de raisonnement IA avancé d'Inde

Fathom-R1-14B : Modèle de raisonnement IA avancé d'Inde

L'IA en expansion rapide. Fathom-R1-14B (14,8 milliards de paramètres) excelle en raisonnement mathématique et général, conçu par Fractal AI Research.

5 June 2025

Mistral Code : L'assistant de codage le plus personnalisable basé sur l'IA pour les entreprises

Mistral Code : L'assistant de codage le plus personnalisable basé sur l'IA pour les entreprises

Découvrez Mistral Code, l'IA d'aide au code la plus personnalisable pour les entreprises.

5 June 2025

Comment Claude Code transforme le codage de l'IA en 2025

Comment Claude Code transforme le codage de l'IA en 2025

Découvrez Claude Code en 2025 : codage IA révolutionné. Fonctionnalités, démo, et pourquoi il gagne du terrain après Windsurf d'Anthropic. Indispensable !

5 June 2025

Pratiquez le Design-first d'API dans Apidog

Découvrez une manière plus simple de créer et utiliser des API