Le fichier CLAUDE.md de Boris Cherny

Le fichier CLAUDE.md de Boris Cherny

Boris Cherny est le créateur de Claude Code chez Anthropic. Cette ressource compile ses principes de workflow dans un fichier CLAUDE.md prêt à l'emploi. C'est une compilation de principes, pas son fichier personnel au mot près. En voici la plus grande partie, à copier directement.

En bref
  • Un CLAUDE.md compilé à partir des principes de workflow du créateur de Claude Code, pas son fichier perso verbatim.
  • Chaque règle corrige un comportement par défaut de Claude Code : il part sans plan, livre sans vérifier, bricole des fixes.
  • Le bloc DÉMARRAGE DE SESSION est le coeur : c'est lui qui rend Claude auto-géré d'une session à l'autre.
  • La structure complète est ci-dessous. Le fichier à télécharger la donne sans coupe, avec les trois méthodes d'installation détaillées.

Le fichier, en grande partie

Copie ce bloc dans ton ~/.claude/CLAUDE.md (global) ou dans le CLAUDE.md de ton projet. Le démarrage et le coeur du workflow y sont en entier.

## DÉMARRAGE DE SESSION
1. Lire tasks/lessons.md : appliquer toutes les leçons avant de toucher quoi que ce soit
2. Lire tasks/todo.md : comprendre l'état actuel
3. Si aucun des deux n'existe, les créer avant de commencer

## WORKFLOW

### 1. Planifier d'abord
- Passer en mode plan pour toute tâche non triviale (3+ étapes)
- Écrire le plan dans tasks/todo.md avant d'implémenter
- Si quelque chose ne va pas, STOP et re-planifier, ne jamais forcer

### 2. Stratégie sous-agents
- Utiliser des sous-agents pour garder le contexte principal propre
- Une tâche par sous-agent
- Investir plus de compute sur les problèmes difficiles

### 3. Boucle d'auto-amélioration
- Après toute correction : mettre à jour tasks/lessons.md
- Format : [date] | ce qui a mal tourné | règle pour l'éviter
- Relire les leçons à chaque démarrage de session

### 4. Standard de vérification
- Ne jamais marquer comme terminé sans preuve que ça fonctionne
- Lancer les tests, vérifier les logs, comparer le comportement
- Se demander : « Est-ce qu'un staff engineer validerait ça ? »

### 5. Exiger l'élégance
- Pour les changements non triviaux : existe-t-il une solution plus élégante ?
- Si un fix semble bricolé : le reconstruire proprement
- Ne pas sur-ingénieriser les choses simples

### 6. Correction de bugs autonome
- Quand on reçoit un bug : le corriger directement
  [la suite dans le fichier : aller dans les logs, cause racine, résoudre sans guidage]

## PRINCIPES FONDAMENTAUX
- Simplicité d'abord : toucher un minimum de code
  [trois autres principes dans le fichier : pas de paresse, ne jamais supposer,
   demander une seule fois]

## APPRENTISSAGES
(Claude remplit cette section au fil du temps)
Le coeur du fichier : le bloc DÉMARRAGE DE SESSION. C'est lui qui force Claude à relire ses leçons et son état avant d'agir, et donc à rester auto-géré d'une session à l'autre. Le reste calibre comment il travaille une fois lancé.

Comment l'installer

Chaque règle du fichier corrige un comportement par défaut de Claude Code. Trois méthodes, à toi de choisir celle qui colle à ton setup.

Option A : coller le fichier toi-même

Copie le bloc ci-dessus dans ~/.claude/CLAUDE.md pour un usage global, ou dans le CLAUDE.md de ton projet pour un usage spécifique. C'est la méthode la plus simple, et elle te laisse voir exactement ce que tu ajoutes.

Option B : laisser Claude le faire

Tu peux aussi coller une courte instruction dans Claude Code pour qu'il ajoute les sections et crée les fichiers tasks/ lui-même. L'instruction exacte à coller est dans le fichier à télécharger.

Option C : ajouter à un CLAUDE.md existant

Si tu as déjà un CLAUDE.md, l'ordre dans lequel tu insères les sections compte. La règle de placement est précisée dans le fichier.

Si tu ne fais qu'une seule chose : colle au moins le bloc DÉMARRAGE DE SESSION et crée un dossier tasks/. C'est le minimum qui transforme Claude Code en assistant qui se souvient.

Ce que le fichier complet ajoute

  • Le CLAUDE.md intégral, sans coupe, prêt à coller d'un bloc.
  • L'instruction exacte de l'option B à donner à Claude pour qu'il s'installe le fichier et crée les tasks/ tout seul.
  • La règle de placement de l'option C : où insérer les sections quand tu as déjà un CLAUDE.md, pour qu'elles priment sur tes préférences sans les écraser.

Le fichier complet, propre et prêt à copier, t'attend juste en dessous.

← Toutes les ressources IA · Nos formations IA