Méthode

Fichiers de règles en vibe coding : CLAUDE.md, règles Cursor et AGENTS.md

CLAUDE.md, règles Cursor, AGENTS.md : quoi écrire dans le fichier que votre outil de vibe coding relit à chaque session, et un modèle commenté à copier.

Xavier
Xavier · mis à jour le
Fichier de règles d’un projet de vibe coding : produit, technique, conventions, interdits et méthode

Un fichier de règles est un texte que votre outil de vibe coding lit au début de chaque session : CLAUDE.md pour Claude Code, les règles du dossier .cursor/rules pour Cursor, AGENTS.md pour d’autres outils. On y écrit ce qui ne change pas d’une session à l’autre : le produit, la technique, les conventions, les interdits et la façon de travailler.

Sans lui, vos consignes vivent dans la conversation. Vous les tapez un lundi, l’outil les respecte trois messages, puis la conversation s’allonge et elles disparaissent. Le mardi, nouvelle session, tout est à redire.

Ce guide fait partie de la série sur l’organisation d’un projet de vibe coding dans Notion. Il montre quoi écrire dans ce fichier, quoi n’y jamais mettre, et comment ouvrir et fermer une session pour que vos règles tiennent.

Pourquoi votre outil oublie-t-il vos règles ?

Un assistant de code ne garde pas de mémoire d’une session à l’autre, sauf ce qu’on lui fait relire. Chaque nouvelle conversation repart d’une page blanche, avec le code sous les yeux et rien d’autre.

Même pendant une session, une consigne donnée au début pèse de moins en moins à mesure que la conversation s’allonge : elle est noyée sous les fichiers lus, les erreurs, les corrections. Ce n’est pas de la mauvaise volonté. C’est la façon dont ces outils travaillent.

La parade est simple : sortir les règles de la conversation et les mettre dans un fichier que l’outil relit à chaque fois. Une règle écrite une fois vaut mieux qu’une règle répétée dix fois.

Votre outil de vibe coding oublie vos règles à chaque session : la consigne retapée, puis le contrat à coller une fois

Quel fichier de règles pour quel outil ?

Chaque outil a son emplacement. Le contenu, lui, est le même partout : vous pouvez écrire un seul texte et le placer là où chaque outil le cherche.

OutilLe fichierOù
Claude CodeCLAUDE.mdÀ la racine du projet, lu au démarrage de chaque session. La commande /init en propose un premier jet à partir du code.
CursorLes règles de projetDans le dossier .cursor/rules. L’ancien fichier .cursorrules, à la racine, est l’ancêtre de ce dossier.
Plusieurs outilsAGENTS.mdÀ la racine du projet. Un format ouvert, lu par exemple par Codex.
Lovable, Bolt, v0Les instructions du projetDans les réglages du projet, sous un nom qui change d’un outil à l’autre.

Les noms et les emplacements évoluent avec les versions des outils. Avant de créer le fichier, vérifiez dans la documentation de votre outil où il le cherche : un fichier au mauvais endroit n’est jamais lu, et rien ne vous le signale.

Annoncede Xavier, un widget Horloge à volets L'heure qui bascule, comme sur un vieux tableau de gare. Gratuit Copier le widget

Que mettre dans un fichier de règles ?

Ce qu’on met dans un fichier de règles de vibe coding (produit, technique, conventions, interdits, méthode) et ce qu’on n’y met pas
Ce qu’on met dans un fichier de règles de vibe coding (produit, technique, conventions, interdits, méthode) et ce qu’on n’y met pas

Cinq rubriques suffisent. Chacune répond à une question que l’outil se pose sinon à chaque session, et à laquelle il répond seul, parfois mal.

  1. Le produit, en trois lignes. Pour qui est l’app, ce qu’elle fait, ce qui est hors périmètre. C’est le résumé de la fiche de l’app, pas la fiche entière.
  2. La technique. Le langage, le framework, la base de données, l’hébergement. Ce qui évite que l’outil ajoute une bibliothèque de plus pour un problème déjà réglé.
  3. Les conventions. Où ranger quoi, comment nommer, comment écrire un montant ou une date. Ce qui rend le code de la semaine prochaine cohérent avec celui d’aujourd’hui.
  4. Les interdits. Les fichiers à ne pas toucher, les données à ne jamais supprimer, les règles d’accès à ne jamais contourner. C’est la rubrique qui évite les catastrophes.
  5. La méthode. Comment vous voulez travailler : proposer un plan avant de coder, avancer par petites étapes, lancer les tests, finir par un compte rendu.

Que ne faut-il pas y mettre ?

  • Les secrets. Aucune clé, aucun mot de passe. Le fichier est lu par l’outil et souvent versionné avec le code.
  • La liste des tâches du jour. Elle change chaque session ; elle a sa place dans le journal de build ou le backlog, pas dans les règles.
  • L’historique du projet. Les décisions passées et leurs raisons vont dans un registre de décisions. Le fichier n’en garde que la conséquence, sous forme de règle.
  • Les règles vagues. « Écris du code propre » ne change rien. « Les montants sont stockés en centimes » change tout.
  • Trop de texte. Un fichier de dix pages se lit mal, par vous comme par l’outil. Gardez l’essentiel en haut, et renvoyez vers d’autres fichiers pour le détail.

Un modèle de fichier de règles, commenté

Voici le fichier que j’écrirais pour une app d’exemple, une plateforme où des artisans envoient des devis que leurs clients acceptent en ligne. Les commentaires entre crochets expliquent chaque choix ; supprimez-les dans votre version.

# Plateforme artisans : règles du projet

## Le produit
Des artisans envoient des devis ; leurs clients les acceptent en ligne par un lien.
Hors périmètre : facturation, paiement en plusieurs fois.
[Trois lignes. Le détail est dans la fiche de l'app.]

## La technique
- Application web, base de données Supabase.
- Pas de nouvelle dépendance sans me le proposer d'abord.
[La deuxième ligne évite les bibliothèques ajoutées en silence.]

## Les conventions
- Les montants sont stockés en centimes, affichés en euros.
- Les dates sont stockées en UTC.
- Un écran = un dossier, avec ses composants à l'intérieur.

## Les interdits
- Ne jamais supprimer de données sans me demander.
- Ne jamais modifier les règles d'accès de la base sans me le dire.
- Un client ne voit que ses propres devis : toute requête le vérifie.
[Écrits comme des règles qu'on peut vérifier, pas comme des souhaits.]

## La méthode
- Avant de coder : résumer la demande telle qu'elle a été comprise, et proposer un plan court.
- Avancer par petites étapes, une fonctionnalité à la fois.
- En fin de session : un compte rendu (fait, en cours, la suite, ce qui a été testé).
[Le compte rendu se recopie dans le journal de build.]

Ce fichier tient sur un écran. C’est voulu : une règle qu’on ne voit pas en ouvrant le fichier est une règle qu’on oublie de mettre à jour.

Comment ouvrir et fermer une session ?

Une session de vibe coding avec un fichier de règles : relire les règles, résumer, coder par petites étapes, compte rendu de fin
Une session de vibe coding avec un fichier de règles : relire les règles, résumer, coder par petites étapes, compte rendu de fin

Le fichier de règles fait la moitié du travail. L’autre moitié tient en deux habitudes, une au début, une à la fin.

Au début de la session, demandez à l’outil de relire les règles et la fiche de l’app, puis de résumer en quelques lignes ce qu’il va faire. Ce résumé vous montre en dix secondes s’il a compris. S’il propose de toucher à un fichier interdit, vous l’arrêtez avant la première ligne de code.

À la fin de la session, demandez un compte rendu : ce qui est fait, ce qui est en cours, la suite, ce qui a été testé. Vous le recopiez dans le journal de build, et la session suivante commence par lui.

Une troisième habitude, plus rare : quand une erreur se répète deux fois, elle devient une règle. L’outil a encore supprimé une table de test ? Ajoutez l’interdit au fichier. C’est ainsi qu’un fichier de règles grandit, à partir d’erreurs réelles et pas de bonnes intentions.

Comment savoir si vos règles fonctionnent ?

Le signe le plus simple : vous ne retapez plus les mêmes consignes. Si vous vous surprenez à redire une règle en cours de session, trois causes possibles.

  • La règle est vague. Réécrivez-la pour qu’on puisse vérifier qu’elle est respectée.
  • La règle est noyée. Remontez-la dans la rubrique des interdits, en haut du fichier.
  • Le fichier n’est pas lu. Vérifiez son nom et son emplacement, puis demandez à l’outil, en début de session, de citer les interdits du projet.

Si l’outil change de version ou si vous changez d’outil, refaites ce dernier test. Le contenu se garde ; c’est l’emplacement qui bouge. La méthode pour passer d’un outil à l’autre est dans le guide pour changer d’outil de vibe coding.

Partir d’un template

VibecodingOS vient avec une page Contrat IA : le contrat de travail, à coller une fois dans votre outil, et quatre textes prêts à copier, le début de session en version connectée et en version copier-coller, le compte rendu de fin de session et la revue de la semaine. Les règles du projet s’appuient sur la fiche de l’app de la base Produits, et le compte rendu de fin de session va dans le journal de build. Le tout dans Notion, quel que soit l’outil qui code.

Découvrir VibecodingOS

Questions fréquentes

Qu’est-ce qu’un fichier CLAUDE.md ?

C’est le fichier de règles de Claude Code. Placé à la racine du projet, il est lu au démarrage de chaque session : l’outil connaît ainsi le produit, la technique, les conventions et les interdits sans que vous les répétiez. La commande /init en propose un premier jet à partir du code existant.

Où mettre les règles d’un projet dans Cursor ?

Dans le dossier .cursor/rules du projet, qui remplace l’ancien fichier .cursorrules placé à la racine. Les règles y sont lues par l’assistant quand il travaille sur le projet. Vérifiez l’emplacement dans la documentation de votre version de Cursor, qui évolue.

Quelle différence entre CLAUDE.md, les règles Cursor et AGENTS.md ?

Le contenu est le même : produit, technique, conventions, interdits, méthode. Seul l’emplacement change selon l’outil qui le lit. AGENTS.md est un format ouvert lu par plusieurs outils. Vous pouvez écrire un seul texte et le placer là où chacun de vos outils le cherche.

Quelle longueur pour un fichier de règles ?

Assez court pour tenir sur un écran : une vingtaine de lignes suffit souvent au début. Le fichier grandit avec les erreurs répétées, une règle à la fois. Le détail (fiche de l’app, modèle de données, décisions) vit dans d’autres documents vers lesquels le fichier renvoie.

Faut-il un fichier de règles avec Lovable ou Bolt ?

Le principe est le même, même sans fichier : ces outils ont un champ d’instructions de projet dans leurs réglages. Collez-y le même texte que dans votre fichier de règles. Si vous passez plus tard à un éditeur, le texte vous suit tel quel.

Partager LinkedIn X
Le template de ce sujet : VibecodingOS
Gardez la main sur vos apps vibe codées : ce qui est décidé, testé et prêt à mettre en ligne.

À lire ensuite

© 2026 Digi Lab Factory · SIRET 934 947 268 00017 · Chaville (92) Confidentialité & mentions légales CGV Cookies Gérer les cookies
Échap
↑ ↓ naviguer · ↵ ouvrir · Échap fermer