Chapter 1 · L'essentiel
Quoi écrire dedans
Follow this course in your space: your progress is saved, and the community answers your questions.
Follow for freeUn bon CLAUDE.md répond à une seule question : qu'est-ce que Claude Code doit savoir à chaque fois pour bien travailler sur ce projet ?
Les sections utiles
- Le projet : ce que c'est, en une ou deux phrases.
- Le public : pour qui tu travailles, ce qu'ils cherchent.
- Le ton : tutoiement ou vouvoiement, trois adjectifs, ce que tu détestes lire.
- Les règles : formats, couleurs, longueurs, organisation des fichiers.
- Les interdits : ce qui ne doit jamais arriver.
- Les commandes : comment prévisualiser, vérifier, mettre en ligne, si tu en as.
Le modèle à copier
# [Nom du projet]
## Projet
Site vitrine de [ton activité] à [ta ville].
## Public
[Qui sont tes clients], souvent sur téléphone.
## Ton
Tutoiement, chaleureux, phrases courtes. Jamais de mots comme « incontournable ».
## Règles
- Couleurs : [code 1], [code 2]. Police : [nom].
- Images optimisées, textes alternatifs sur chaque image.
## Interdits
- Aucun chiffre, avis ou témoignage inventé.
- IMPORTANT : me demander avant de publier, d'envoyer ou de supprimer quoi que ce soit.
## Sécurité
- Les clés et mots de passe vivent dans un fichier .env, jamais envoyé sur Git.
Les quatre qualités d'une bonne ligne
- Courte. Vise moins de 200 lignes au total, comme le conseille la documentation. Au-delà, les règles importantes se perdent.
- Utile. Pour chaque ligne, demande-toi : « si je l'enlève, Claude fera-t-il une erreur ? » Si non, supprime-la.
- Concrète. « Phrases de 15 mots maximum » marche mieux que « écris bien ».
- Hiérarchisée. Mets « IMPORTANT » sur la règle qui compte le plus, et seulement celle-là. Si tout est important, plus rien ne l'est.
Les deux règles de sécurité à ne jamais oublier
Même pour un petit projet, ajoute toujours ces deux lignes : les secrets dans un .env hors de Git, et une validation de ta part avant toute action publique ou irréversible. Ce sont elles qui t'évitent les vraies mauvaises surprises.
Pour remplir le modèle sans te creuser la tête, fais-toi interviewer :
Je veux créer le CLAUDE.md de ce projet. Interviewe-moi : pose-moi une question à la fois sur le projet, le public, le ton, les règles et les interdits.
Quand tu as tout, rédige un fichier de 40 lignes maximum, avec les deux règles de sécurité (.env hors de Git, validation avant toute publication ou suppression).
Montre-le-moi avant de l'enregistrer.
À toi de jouer
Lance ce prompt et réponds aux questions. Relis ensuite le fichier proposé et barre au moins une ligne inutile avant de l'enregistrer.