Version open source de CLAUDE.md garde les agents Claude Code productifs pendant des heures, sans boucles

Si vous avez mené des sessions autonomes avec Claude Code, vous avez heurté le mur : l'agent commence bien, dérive dans la narration au bout de 2 heures, boucle sur le même correctif à la 3e heure, puis meurt sans rien livrer. Un développeur qui a brûlé des centaines de sessions a découvert que le coupable n'était ni un framework ni un outil — c'était l'absence d'un fichier CLAUDE.md à la racine du projet.

Ce que fait le fichier opératoire

Le fichier fait 70 lignes, sous licence MIT, et se trouve à ./CLAUDE.md. Claude Code le lit au démarrage et le comportement change immédiatement. Les directives clés :

• Impose l'action plutôt que la narration. Si l'agent se surprend à écrire "Je vais maintenant" au lieu d'appeler un outil, il s'arrête et exécute cet outil.
• Exige des preuves avant de déclarer terminé. Pas de "devrait être corrigé" sans résultat de test.
• Élimine le langage de planification. Les seules sorties valides sont des actions terminées, des questions ou des résumés.
• Auto-évaluation sous pression de contexte au lieu de se dégrader silencieusement.

Impact sur les sessions

Avec le fichier en place, les sessions sont passées de boucles de narration de 3 heures à des cycles de productivité complets. L'agent livre du code, vérifie qu'il est bien en place, et continue jusqu'à ce que la pression du contexte se fasse sentir. Puis il sauvegarde l'état et la session suivante reprend proprement.

Comment l'utiliser

Copiez le fichier depuis le dépôt GitHub dans la racine de votre projet. Aucune configuration, aucune dépendance. Claude Code le lit automatiquement. Le dépôt contient le CLAUDE.md exact — récupérez-le et déposez-le.