Un système pour que Claude Code apprenne votre projet au fil du temps

Un développeur sur r/ClaudeAI a partagé un système pour résoudre le manque de contexte persistant de Claude Code entre les sessions. Au lieu de repartir de zéro à chaque fois, cette configuration aide Claude à apprendre les conventions, l'architecture et les erreurs passées de votre projet.

Le problème et la solution

Lors de l'utilisation de Claude Code, chaque nouvelle session perd tout le contexte précédent. Claude relit les fichiers qu'il avait déjà compris, répète les erreurs corrigées et ignore les modèles établis, nécessitant une réexplication constante.

La solution consiste à ajouter quelques fichiers à n'importe quel dépôt :

• CLAUDE.md - Un court ensemble de règles indiquant à Claude comment se comporter. Par exemple : "demandez avant de procéder si quelque chose n'est pas clair" et "ne lancez pas les tests vous-même, dites-moi quoi exécuter à la place" (ce qui économise de l'argent en évitant le gaspillage de tokens pour chasser les erreurs).
• Dossier docs/ - Contient de courts fichiers (5-10 lignes chacun) capturant les conventions, modèles et architecture du projet, organisés en sous-dossiers. Un fichier d'index (docs/README.md) aide Claude à trouver rapidement le bon document au lieu de deviner.

Trois invites clés

• bootstrap - Collée une fois lors de l'adoption d'une base de code existante. Claude lit votre code et écrit la documentation initiale.
• refine - Collée à la fin d'une session. Claude réfléchit à ce qui s'est passé et met à jour la documentation avec les nouveaux apprentissages.
• factory - Collée lorsque Claude fait quelque chose que vous souhaitez répéter. Elle capture le modèle sous forme d'invite réutilisable.

La boucle de travail

Le processus crée un cycle d'apprentissage continu : Vous codez avec Claude → la session se termine → vous collez l'invite refine → Claude met à jour la documentation → vous validez → la session suivante commence plus intelligemment. Comme la documentation est stockée dans git, toute votre équipe en bénéficie, et cela fonctionne avec n'importe quelle pile technologique.

Conseils pratiques de mise en œuvre

• Dites explicitement à Claude de ne pas exécuter les commandes de construction/test pour éviter de brûler des tokens à chasser des erreurs. Demandez-lui plutôt de vous indiquer quelles commandes exécuter.
• Utilisez des nombres spécifiques dans les règles (par exemple, "mettez en pause si vous modifiez 3+ fichiers") plutôt que des termes vagues comme "mettez en pause pour les tâches complexes", car Claude perd du temps à interpréter l'ambiguïté.
• Un fichier d'index pour votre dossier docs est immédiatement rentable en empêchant Claude d'ouvrir des fichiers au hasard en espérant trouver des informations pertinentes.

Le système est gratuit et open source, disponible sur saas-vibe.