Prologue — Le dossier CLAUDE/

Sources vérifiées : commit 623a7d3 (SuperOAuth, 18 novembre 2025) · commit b0bb88a (12 mars 2026, 02:09)

Novembre 2025 — Mars 2026

En novembre 2025, 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 255 lignes de markdown dès le premier commit. Soigné. Bien structuré.

Ce dossier n’est pas sorti d’un seul jet. Il est venu de plusieurs jours d’allers-retours avec l’IA, jamais commités — dont des sessions arrêtées faute de tokens. Je me demandais « pourquoi je crame mes tokens comme ça ». Je n’étais pas sûr que ce que je faisais avait un sens. Mais je « sentais que c’était important » : en cherchant comment donner du contexte à l’IA, je découvrais l’architecture qu’il y avait derrière — sans trop savoir ce que je construisais.

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 19 novembre, le dossier est élagué : 1 043 lignes retirées, 506 ajoutées (b32bd9d). Puis plus rien. Entre le 20 novembre et le 11 mars, SuperOAuth avance de neuf commits ; le guide, d’aucun. Une documentation statique ne suit pas le projet qu’elle décrit.

---

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.

Dix jours plus tard, le 22 mars, CLAUDE/ disparaît de SuperOAuth. Le commit qui le supprime l’appelle déjà un « proto-brain » (26a046c).