Le fichier CLAUDE.md de Boris Cherny

Le fichier

À coller dans ~/.claude/CLAUDE.md pour un usage 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 vers 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 existe

Chacune corrige un défaut de comportement par défaut, et c'est ce qui les rend utiles plutôt que décoratives.

Planifier d'abord. La plupart des échecs viennent d'un début de code avant compréhension de la portée réelle. La planification attrape ça au moment où la correction est gratuite.

Sous-agents. Une session longue devient coûteuse et perd son cap. Isoler chaque tâche garde la fenêtre principale propre.

Boucle d'auto-amélioration. Sans elle, les mêmes erreurs reviennent indéfiniment. Avec, le taux d'erreur baisse pour de bon.

Standard de vérification. Le réflexe par défaut est d'annoncer terminé sans avoir vérifié. Cette règle exige une preuve.

Exiger l'élégance. Le premier résultat qui fonctionne n'est pas le meilleur. Cette règle force une seconde passe là où elle vaut le coup.

Correction autonome. Le comportement par défaut est de demander la marche à suivre. Cette règle l'annule : on donne un bug, on récupère un correctif.

Comment l'installer

Trois options, selon votre configuration.

Le coller vous-même dans ~/.claude/CLAUDE.md pour l'appliquer partout, ou dans le CLAUDE.md du projet pour le limiter à lui.

Laisser Claude le faire. Ouvrez Claude Code et demandez-lui d'ajouter les sections telles quelles, et de créer tasks/todo.md et tasks/lessons.md s'ils n'existent pas.

L'ajouter à un fichier existant. Collez les sections WORKFLOW et PRINCIPES FONDAMENTAUX en haut, avant vos propres préférences.

Si vous ne devez en garder qu'une partie, gardez le bloc DÉMARRAGE DE SESSION. C'est lui qui rend le reste automatique, parce qu'il force la relecture des leçons avant chaque travail.

Où ça se trouve

Cette ressource vit chez son auteur, et c'est mieux ainsi : elle y reste à jour. https://claude.ai/code