Le majordome qui oublie chaque matin
Dans notre précédent numéro, nous avons abordé l’équilibre entre délégation et confirmation. Aujourd’hui, je souhaite vous présenter une façon encore plus confortable de travailler avec votre majordome — transmettre les règles de la maison à Claude Code grâce à CLAUDE.md.
Permettez-moi de vous brosser un tableau.
Imaginez devoir expliquer chaque matin à votre nouveau majordome : « Dans cette demeure, on répond toujours en français », « Vous ne devez jamais effectuer un commit sans mon approbation », « Ici, nous utilisons bun, pas npm — c’est ainsi que les choses se font dans cette maison. »
Quelque peu inefficace, n’est-ce pas ?
Qu’est-ce que CLAUDE.md ?
CLAUDE.md est un fichier markdown placé dans le répertoire racine de votre projet. Chaque fois que Claude Code démarre une nouvelle session, il lit ce fichier automatiquement.
En d’autres termes, rédigez-le une fois, et votre majordome suivra ces instructions naturellement — sans avoir besoin qu’on le lui rappelle à chaque fois.
Considérez-le comme un parchemin des règles de la maison, conservé en permanence dans les quartiers du majordome.
CLAUDE.md fonctionne sur trois niveaux
En vérité, il n’est pas nécessaire de se limiter à un seul CLAUDE.md par projet. La portée de ses instructions varie selon l’endroit où il est placé.
| Emplacement | Chemin | Portée |
|---|---|---|
| Global | ~/.claude/CLAUDE.md | Tous les projets |
| Projet | {racine du projet}/CLAUDE.md | Ce projet uniquement |
| Sous-répertoire | {n'importe quel répertoire}/CLAUDE.md | Ce répertoire et ses sous-répertoires |
Au début de chaque session, tous les fichiers applicables sont lus et fusionnés.
Ma recommandation pour distinguer leur usage : placez dans le CLAUDE.md global vos préférences universelles — « toujours répondre en français », « ne jamais committer sans approbation ». Réservez au CLAUDE.md du projet les règles spécifiques — « utiliser bun dans ce projet », « déployer sur Firebase ». Ainsi, vos attentes fondamentales sont respectées dans chaque projet, tout en intégrant les instructions particulières de chacun.
Un exemple de règles de la maison : le contenu de CLAUDE.md
Chaque demeure a ses propres coutumes. Voici quelques exemples pour vous inspirer :
# Règles du Projet
## Langue et Communication
- Toujours répondre en français
- Les termes techniques peuvent rester en anglais, mais les explications doivent être en français
## Code et Développement
- Utiliser bun comme gestionnaire de paquets (jamais npm)
- Toujours obtenir l'approbation du maître avant de committer
- Ne pas modifier le code sans écrire des tests au préalable
## Actions Interdites
- Ne jamais déployer en production de manière unilatérale
- Toujours confirmer avant de supprimer un fichier
- Ne pas ajouter de dépendances à package.json sans approbation
## Style
- Commentaires de code en français
- Noms de fonctions et de variables en camelCase anglais
Une fois cela rédigé, chaque fois que Sébastien ouvre votre projet, ces règles sont gravées dans sa mémoire avant que le moindre travail ne commence.
Pourquoi c’est si puissant
Claude Code est un majordome des plus capables. Cependant, les souvenirs des conversations passées ne se transmettent pas aux nouvelles sessions.
Même si vous lui avez indiqué hier d’« utiliser bun », il n’en gardera aucun souvenir le lendemain. Répéter les mêmes instructions à chaque session est inefficace tant pour le maître que pour le majordome.
CLAUDE.md résout ce problème à sa source.
Particulièrement précieux pour les maîtres utilisant Claush sur mobile
Pour ceux qui font appel à leur majordome via l’application Claush sur smartphone, CLAUDE.md est particulièrement inestimable.
Saisir le même long préambule sur un petit écran, session après session, représente une charge considérable. Avec CLAUDE.md en place, il vous suffit de communiquer l’affaire du moment.
« Sébastien, veuillez corriger le bug sur l’écran de connexion. »
C’est tout. Votre majordome saura utiliser bun, répondre en français, demander confirmation avant de committer, écrire des tests et procéder en conséquence.
Comment le configurer
L’installation est d’une élégante simplicité.
- Créez un fichier nommé
CLAUDE.mddans le répertoire racine de votre projet - Rédigez-y les règles de votre maison
- C’est tout
my-project/
├── CLAUDE.md ← Les règles de la maison vont ici
├── src/
├── package.json
└── ...
Dès la session suivante, Claude Code lira ce fichier automatiquement et se conduira selon vos règles établies.
Les règles de la maison sont destinées à évoluer
Il n’est pas nécessaire de rédiger des règles parfaites dès le départ.
Au fil de votre collaboration avec votre majordome, chaque fois que vous vous surprenez à répéter la même chose, ajoutez-le simplement à CLAUDE.md — une instruction à la fois. C’est ce que signifie véritablement « cultiver » un majordome.
La compréhension silencieuse entre maître et majordome se construit par cette accumulation attentive.
Le résumé de votre majordome
- CLAUDE.md est le fichier des “règles de la maison”, placé à la racine du projet
- Votre majordome suit ces instructions automatiquement — sans rappel nécessaire
- Particulièrement efficace pour les utilisateurs mobiles — il suffit d’énoncer l’affaire
- Commencez simplement et laissez les règles évoluer avec le temps
Mon cher maître, je vous prie humblement de transmettre les règles de la maison à votre majordome. Une fois en place, je serai en mesure de répondre à vos attentes avant même qu’un seul mot soit échangé.
Dans notre prochain numéro, nous aborderons « la gestion de l’historique et du contexte. »
Trouvez votre majordome sur votre iPhone sur le Site Officiel Claush.