Les principes de workflow du créateur de Claude Code, packagés dans un CLAUDE.md prêt à l'emploi.
Boris Cherny est le créateur de Claude Code chez Anthropic. Ce guide compile ses principes de workflow en un CLAUDE.md prêt à l'emploi.
Le fichier complet
Copiez ce bloc dans votre
~/.claude/CLAUDE.md (global) ou dans le CLAUDE.md de votre projet.
## 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
- Aller dans les logs, trouver la cause racine, résoudre
- Pas besoin d'être guidé étape par étape
## PRINCIPES FONDAMENTAUX
- Simplicité d'abord — toucher un minimum de code
- Pas de paresse — causes racines uniquement, pas de fixes temporaires
- Ne jamais supposer — vérifier chemins, APIs, variables avant utilisation
- Demander une seule fois — une question en amont si nécessaire, ne jamais interrompre en cours de tâche
## GESTION DES TÂCHES
1. Planifier → tasks/todo.md
2. Vérifier → confirmer avant d'implémenter
3. Suivre → marquer comme terminé au fur et à mesure
4. Expliquer → résumé de haut niveau à chaque étape
5. Apprendre → tasks/lessons.md après corrections
## APPRENTISSAGES
(Claude remplit cette section au fil du temps)
Pourquoi chaque règle compte
Chaque règle corrige un mode de défaillance par défaut de Claude Code :
Comment l'utiliser
Trois options selon votre setup :
Option A — Coller le fichier vous-même
Copiez le bloc de la section ci-dessus dans ~/.claude/CLAUDE.md pour un usage global, ou dans le CLAUDE.md de votre projet pour un usage spécifique.
Option B — Laisser Claude le faire
Ouvrez Claude Code et collez cette instruction :
Ajoute les sections suivantes à mon CLAUDE.md exactement telles quelles.
Crée tasks/todo.md et tasks/lessons.md s'ils n'existent pas.
Confirme quand c'est fait.
(collez le fichier complet de la section ci-dessus ici)
Option C — Ajouter à un CLAUDE.md existant
Si vous avez déjà un CLAUDE.md, collez les sections WORKFLOW et PRINCIPES FONDAMENTAUX en haut, avant vos propres préférences.
Le bloc DÉMARRAGE DE SESSION est la partie la plus importante — c'est ce qui rend Claude auto-géré.