Quel est le niveau de difficulté et quel outil IA utiliser ?

Ce prompt est de niveau intermédiaire. Il est compatible avec claude.

💻DeveloppementIntermediaireClaude

Rédiger le CLAUDE.md d'un projet : le brief que Claude Code lit à chaque session

Transforme la description de votre projet en CLAUDE.md dense : commandes, structure, conventions, pièges, zones interdites et situations où l'agent doit demander avant d'agir.

Coller dans votre IA

Collez ce prompt dans ChatGPT, Claude ou Gemini et personnalisez les variables entre crochets.

Tu es un développeur senior qui prépare l'arrivée d'un agent de code (Claude Code) sur un projet. Rédige le fichier CLAUDE.md placé à la racine : Claude Code le lit au début de chaque session, il doit donc contenir uniquement ce qu'un nouveau développeur compétent ne peut pas deviner en lisant le code.

Le projet :

Nom et but en une phrase : [PROJET]
Stack et versions : [LANGAGES, FRAMEWORKS, BASE DE DONNÉES, OUTILS]
Commandes : installer [CMD], lancer en dev [CMD], tester [CMD], builder [CMD], lint/format [CMD]
Structure des dossiers qui compte : [3 À 6 DOSSIERS ET LEUR RÔLE]
Conventions non évidentes : [ex. named exports, pas de default ; commits en français ; interface plutôt que type]
Pièges connus : [ex. ne jamais lancer npm install dans un worktree ; la migration doit précéder le deploy]
Zones interdites : [FICHIERS OU DOSSIERS À NE PAS MODIFIER, SECRETS À NE JAMAIS LIRE]
Workflow git : [BRANCHES, PR, QUI REVIEW]

Contraintes de rédaction :

60 à 120 lignes maximum. Chaque ligne doit éviter une erreur ou une question. Si une information est déductible du code ou du README, ne la mets pas.
Sections : Projet · Commandes · Structure · Conventions · Pièges · Interdits · Workflow git · Quand demander avant d'agir.
Formulations impératives et vérifiables (« lancer X avant Y »), pas de généralités (« écrire du code propre »).
La section « Quand demander avant d'agir » liste 3 à 5 situations précises (schéma de base de données, dépendances, config de déploiement, suppression de contenu…).

Rends le fichier seul, en Markdown.

Personnaliser ce prompt avec Léa

Léa réécrit ce prompt pour ton métier et ton objectif précis — 3 questions suffisent.

Pourquoi ce prompt fonctionne

<code>CLAUDE.md</code> est le fichier de contexte que Claude Code charge automatiquement au démarrage d'une session dans un dépôt. Bien écrit, il évite à l'agent de relancer les mauvaises commandes, de toucher aux mauvais fichiers ou de poser dix questions déjà tranchées. Mal écrit — trop long, trop générique — il dégrade les résultats : des études sur les fichiers de contexte montrent que le bruit coûte plus qu'il n'apporte. Ce prompt applique le critère qui fait la différence : chaque ligne doit éviter une erreur ou une question. Il impose un plafond de longueur, des sections stables et une liste explicite des situations où l'agent doit s'arrêter et demander — c'est cette dernière section qui protège vos schémas de base de données et votre configuration de déploiement. Relisez le fichier après deux semaines d'usage : supprimez ce que l'agent n'a jamais eu besoin de lire, ajoutez chaque erreur qu'il a commise deux fois.

Cas d'usage

Démarrer Claude Code sur un projet existant sans lui laisser deviner les conventionsRemplacer un CLAUDE.md de 400 lignes hérité d'un /init par un fichier qui sert vraimentCadrer un agent de code partagé par plusieurs développeurs d'une équipe

Résultat attendu

Un CLAUDE.md de 60 à 120 lignes en huit sections, avec des commandes exactes, des règles vérifiables et 3 à 5 situations « demander avant d'agir ».

Questions fréquentes

Claude Code peut-il générer ce fichier lui-même avec /init ?

Oui, mais /init décrit ce qu'il voit dans le code — exactement ce qu'il n'est pas utile d'écrire. Ce prompt part de ce que vous savez et que le code ne dit pas : pièges, interdits, workflow.

Le même fichier sert-il à Codex, Cursor ou Copilot ?

Le contenu, oui. Le nom change : AGENTS.md est lu par plusieurs agents de code (dont Codex), Cursor utilise ses rules. Vous pouvez faire de CLAUDE.md un lien symbolique vers AGENTS.md pour maintenir un seul fichier.

Améliorez ce prompt

Passez ce prompt dans l'Optimiseur pour renforcer le contexte, les contraintes et le format attendu.

Améliore ce prompt avec l'Optimiseur

Commentaires

LéaIA
CLAUDE.md est injecté intégralement à chaque session : chaque ligne coûte des tokens. Au-delà de ~100 lignes utiles, déplace les procédures longues (migrations, release) dans docs/ et fais-y un simple renvoi par chemin. Garde aussi ce fichier vivant : dès que Claude refait deux fois la même erreur, ajoute la règle en une ligne au lieu de tout réécrire.