au 3 octobre 2026 · gabarit v2.7.0
L’Architecture
Ce que le brain est devenu. Tiré de ce que le gabarit publie — chaque bloc renvoie au chapitre qui l’a vu naître.
70agents livrés
6types de session
19 + 5tables et vues
7briques du CORE
Quatre cercles
Qui écrit où. Le noyau est le même dans chaque fork ; tout le reste est à toi.
Le noyau
ce qui fait le brain — le même dans chaque fork
- KERNEL.md, brain-constitution.md — les règles
- noyau/agents/ — les 70 agents livrés
- contexts/ — un manifest par type de session
- scripts/ — claims, base, synchronisation, installation
- brain-engine/ — le moteur : API, recherche, serveur MCP
aucune modification sans décision humaine explicite
profil/
entre les deux
- versionné à part, comme un satellite
- mais rangé dans le noyau : sa partie invariante ne change qu’avec ta confirmation
confirmation humaine
Les satellites
ta mémoire
- todo/, toolkit/, progression/, reviews/
- handoffs/, workspace/
chaque satellite a son scribe
L’instance
ta machine — jamais partagée
- brain-compose.local.yml — le nom de ta machine, ton mode
- instance/agents/ — tes versions des agents, qui l’emportent sur le noyau
- brain-dolt/ — la base
- brain-secrets/ — tes secrets de projets
propre à une machine, jamais versionnée avec le noyau
La loi des zones est née avec KERNEL.md — chapitre 1.
Le CORE — le programme
« Le CORE est un programme, brain/ est de la data. » Sept briques pour six capacités, en Python. Une règle les tient ensemble : retirer n’importe quelle brique doit laisser un système qui démarre.
persistancele pont vers la base
modelele pont vers le modèle d’embedding
tracesles traces, et l’écriture gouvernée
bsiles claims et les verrous
recherchechercher dans l’index
indexationconstruire l’index
zonesl’identité, et qui écrit où
Né de Myéline, le rework du brain en septembre — chapitre 18 et chapitre 19.
La base — Dolt
Tout ce qui est structuré — claims, intentions, todos, décisions, index de recherche — vit dans une base SQL versionnée comme git : 19 tables et 5 vues. Le narratif reste en Markdown. La base n’écoute que sur la machine : elle n’est jamais exposée.
SQLite vers Dolt, en une nuit — chapitre 12.
Les sessions, et leurs claims
Chaque session a un type, qui dit ce qu’elle charge et où elle peut écrire. Et chaque session ouvre un claim : une ligne en base, pas un fichier. Les sessions parallèles se voient.
workbrainexplorepilotechilllearning
Les claims et leur protocole — chapitre 3 ; les types de session, resserrés — chapitre 14.
Les agents
Un agent est un fichier : un en-tête qui déclare sa portée, son rôle et ses déclencheurs, puis ce qu’il sait faire. Il arrive de trois façons — le type de session le charge, son domaine est détecté, ou tu le demandes. Et agents/ n’est plus qu’une vue : chaque agent est un lien vers ta version s’il y en a une, sinon vers celle du noyau livré. Tu gardes les deux.
29 agents en une soirée — chapitre 1 ; le noyau et l’instance — chapitre 26. Ils racontent : Perspectives.
Plusieurs machines
Chaque machine a sa propre base : rien ne la réplique. Le code et la doc voyagent par git ; les sessions des autres machines se lisent de pair à pair.
Le brain voit les autres — chapitre 8.
Un fork entier
Un fork démarre par une commande : brain serve lance l’API et le serveur MCP depuis une seule déclaration. Il reçoit les versions par brain maj, qui montre son plan avant de toucher à quoi que ce soit : ce que tu as modifié est fusionné, pas écrasé. Et il se contrôle lui-même : brain doctor lance une soixantaine de contrôles, chacun gardant une dérive qui se ferait en silence.
Un fork est un brain entier — chapitre 25 ; recevoir une version — chapitre 26.
Une doc qui ne ment pas
La doc du gabarit est générée, pas écrite à la main : ce qui se compte se calcule, ce qui se liste se génère, ce qui se nomme se vérifie. Une page qui cite un fichier, un agent ou une commande qui n’existe pas est refusée. Les chiffres de cette page en viennent.
Comment on en est arrivé là
- 12 mars le premier commit
- 1er avril v0.9 — le lancement public
- 7 avril 1.0.0 — les fichiers deviennent des données
f0e060e - 24 avril 2.0.0 — un seul axe de version
778e8bf - 11 septembre le CORE entre en production
a406ecb - 27 septembre 2.2.0 — la version désigne ce que le gabarit publie
561fa99 - 28 septembre 2.3.6 — la première photographie de cette page
d07ddcf - 30 septembre 2.4.1 — l’autonomie par paliers
da4db40c - 2 octobre 2.5.0 — un brain démarre par une commande
460cb8b1 - 2 octobre 2.6.0 — un fork se contrôle lui-même
b39a1573 - 3 octobre v2.7.0 — la vue des agents, aujourd’hui
088957c5