Prologue

Le dossier CLAUDE/

Novembre 2024 — Mars 2026

Prologue — Le dossier CLAUDE/

Novembre 2024 — Mars 2026

En novembre 2024, il y avait un dossier CLAUDE/ dans SuperOAuth. L’idée : donner du contexte à l’IA une fois pour toutes, ne pas réexpliquer l’architecture à chaque session. 3 092 lignes de markdown. Soigné. Bien structuré.

Le problème : ça ne fonctionnait pas vraiment.

Pas parce que c’était mal écrit — c’était bien écrit. Le problème c’est qu’une session Claude repart de zéro. Tu charges le guide, Claude lit, mais il n’y a pas de persistance de raisonnement, pas de mémoire des décisions précédentes, pas de contexte sur “pourquoi on a fait ça plutôt que ça”. Chaque session, je réexpliquais les choix architecturaux. Chaque session, Claude oubliait les bugs qu’on avait débogués la veille.


Le changement mental : la documentation statique et la mémoire de contexte sont deux problèmes différents. Le premier, on peut le résoudre avec du markdown bien rangé. Le second, non — il faut une architecture.

Et si on appliquait la même logique que git — où chaque décision est versionnée, traçable, réversible — à la connaissance elle-même ? Pas des fichiers de doc, mais un système où chaque décision est un commit, chaque agent est un micro-service calibré sur ce corpus, et le contexte survit aux reboots de session.

C’est le jour où j’ai arrêté de demander “comment écrire un meilleur prompt” et commencé à demander “comment construire la couche de coordination par-dessus git” que le brain a commencé.

Le 12 mars 2026, à 2h09 du matin. Commit b0bb88a.