Aller au contenu
Chapitre 7

Le cerveau sort des fichiers

18 mars 2026

Chapitre 7 — Le cerveau sort des fichiers

Sources vérifiées : git log 2026-03-18 (130 commits) Commits clés : 942371d (Cosmos dans la nav) · 6e876cb (brain-guardian) · 5e643d7 (BSI v4 intentions) · cadafc6 (pre-flight gate) · ffabc10 (swarm foundation) · 9a8a955 (Cosmos heatmap nébuleuse)

Le 18 mars 2026. Six jours que le brain se construit. Les agents sont forgés. Le kernel est verrouillé. L’API est en ligne. Le MCP parle. Mais le brain reste prisonnier des fichiers texte et du terminal. Ce jour-là, il en sort.

Cosmos atterrit

La nuit commence là où la précédente s’est arrêtée. Cosmos — la carte 3D des embeddings, née comme vision au chapitre 4 — doit devenir réelle. Pas une démo dans un notebook. Un composant dans brain-ui, accessible depuis le navigateur, avec les vrais fragments de mémoire du brain.

À 01h20, le deploy commence. À 01h42 :

942371d — feat: Cosmos 🌌 dans la nav brain-ui — separator + lazy load

Cosmos est dans la navigation. Mais il ne fonctionne pas encore — 401 sur le fetch, coordonnées UMAP hors cadre, canvas qui ne remplit pas la page. Le genre de bugs qu’on ne trouve qu’en intégration réelle.

À 04h56, fix de l’authentification. À 05h07, normalisation des coordonnées UMAP vers [-2, 2]. À 05h09, canvas full-height. À 05h12, shader pour les points ronds (clamp 1.5-5px). À 05h14, bouton fullscreen. À 05h18, position absolute chain.

Sept commits en 22 minutes. Chaque fix chirurgical, chaque commit isolé. Le pattern du brain — un problème, un commit, une preuve.

À 05h20 :

d8d1cd9 — bsi: cosmos-deploy intention — done ✅

Cosmos est live. Les fragments de mémoire du brain flottent en 3D dans le navigateur. Chaque point est un chunk d’embedding. Les clusters émergent — les agents se regroupent, les projets forment des constellations.

Puis à 08h00, le geste esthétique :

9a8a955 — feat: cosmos heatmap — mode nébuleuse toggle ⬡ (AdditiveBlending, soft gaussian)

Le mode nébuleuse. Les points deviennent des halos lumineux. Additive blending — les zones denses brillent plus fort. Rotation automatique. Le brain vu comme une galaxie. Ce n’est plus un dashboard — c’est un fond d’écran vivant qui montre l’état de la connaissance.

Le brain apprend à se méfier de lui-même

À 03h44, entre deux fix de Cosmos, un agent discret mais fondamental :

6e876cb — feat: brain-guardian — auto-méfiance structurelle quand brain opère sur lui-même

brain-guardian. Pas secrets-guardian — celui-ci protège les secrets. Brain-guardian protège le brain de lui-même. Quand le brain opère sur ses propres fichiers kernel, quand il modifie ses propres règles, un garde-fou s’active. Auto-méfiance structurelle.

La question n’est pas “est-ce que l’agent est compétent ?“. La question est “est-ce qu’un système qui se modifie lui-même a besoin d’un contrôle supplémentaire ?“. La réponse est oui. Toujours.

À 03h51 :

99e4f2b — feat: session-kernel + session-edit-brain — séparation workflow brain/kernel effective

Deux modes de session séparés. session-edit-brain : écriture autorisée sur le brain. session-kernel : lecture seule sur le kernel, toute tentative d’écriture refusée. La distinction est architecturale — pas une convention qu’on peut oublier, un mode qui s’applique au boot.

BSI v4 — les intentions comme unité

À 04h35 :

5e643d7 — feat: BSI v4 — intentions/ comme unité de session multi-sessions

Les intentions. Pas des todos — des directions. Pas des tickets — des engagements. Chaque intention a un cycle de vie qui traverse les sessions. Une intention ouverte aujourd’hui peut être travaillée dans trois sessions différentes sur deux machines. Le BSI v4 en fait une unité de pilotage.

À 04h36, le TTL check au boot : si une intention n’a pas été touchée depuis plus longtemps que son TTL, alerte stale. Le brain sait ce qu’il a promis de faire — et il sait quand il oublie.

Le pre-flight gate

À 04h02 :

cadafc6 — feat: pre-flight — gate boot step 4.5 BHP, enforce tier_required + write_lock + kerneluser

Le pre-flight. Un contrôle qui s’exécute au boot, après le chargement du contexte mais avant que la session commence à travailler. Il vérifie trois choses : le tier de l’utilisateur est suffisant pour ce qui va être chargé. Les write locks sont respectés. Le kerneluser est identifié.

Si le pre-flight échoue, la session ne démarre pas. Pas de dégradation silencieuse — un refus explicite avec la raison. Le brain préfère ne pas démarrer que démarrer dans un état incohérent.

La wiki s’écrit

Entre 06h43 et 07h34, la wiki du brain passe de 20 pages à 26. Page après page, chaque concept du brain reçoit sa documentation.

90f29ef (06:43) — cold-start fix, MCP onboarding, context-loading, brain-access, audit véracité. 1e1a49a (07:15) — Cosmos.md + 21 pages. e5ceb8b (07:19) — brain-engine + tier enforcement + 23 pages. 2977fdf (07:23) — BSI reference + 24 pages. 08566a8 (07:26) — ADR index + 25 pages. e5da2ac (07:34) — integration-schema + 26 pages.

Une heure. 26 pages. Le brain ne se contente plus de savoir — il se documente. Et chaque page passe un audit de véracité : ce qui est écrit doit être vrai dans le repo, vérifiable par commit.

L’après-midi des audits

Le brain se réveille à 17h05 après une pause — la première vraie pause depuis des jours. L’après-midi est consacrée à l’entretien.

À 18h18 :

6d19bec — audit: CATALOG.yml sync — 6 agents manquants ajoutés

Le CATALOG — la liste officielle de tous les agents — est synchronisé. 73 agents sur 74. Six manquaient : coach-boot, time-anchor, audit, pattern-scribe, brain-guardian, pre-flight. Tous forgés récemment, aucun indexé. Le genre de drift silencieux qui s’accumule quand on construit vite.

Swarm foundation

À 18h49, un commit qui regarde loin devant :

ffabc10 — feat: workflows/_template enrichi — execution_mode (ADR-032) + contrats I/O + swarm_ready flag

Le swarm. L’idée que les workflows du brain ne devraient pas être exécutés un par un, séquentiellement, avec un humain qui copie-colle entre les fenêtres. Ils devraient pouvoir se coordonner — agents autonomes qui se lancent, échangent des résultats, et convergent.

ADR-032 définit trois modes d’exécution : manual (l’humain pilote), assisted (le coach pilote, l’humain valide les gates), agentic (les agents se coordonnent, l’humain n’intervient qu’en exception). Le swarm_ready flag dans le template de workflow dit : “ce workflow est prêt pour le mode agentic.”

La fondation est posée. Le swarm ne sera pas construit aujourd’hui — mais quand il le sera, l’architecture sera prête.

La review guidée

L’après-midi se termine par un audit musclé. Un plan de revue étendu aux 74 agents, batch par batch ; une vingtaine reçoivent un patch. Les IPC corrigés — sends_to, receives_from rendus explicites. Les chemins contexts/ corrigés. Le coach reçoit ADR-032 dans ses connaissances. Le brain-ui-scribe est mis à jour — Sprint 2 livré, 13 composants, 8 hooks.

Huit commits de patches en 40 minutes. Pas du nouveau — de l’entretien. Le brain qui prend soin de lui-même.

La wiki finit la journée à 36 ADRs indexées, 26 pages, version 0.9.4.

130 commits. Le brain est sorti des fichiers texte et du terminal. Cosmos flotte dans un navigateur. brain-guardian protège le kernel de lui-même. Les intentions sont des unités de pilotage multi-sessions. Le pre-flight refuse de démarrer en état incohérent. La wiki documente tout. Et le swarm attend son heure.

Le titre de ce chapitre n’a pas changé — “Le cerveau sort des fichiers.” Mais maintenant, il sort pour de vrai.

Ce qui a été construit

  • Cosmos live — deploy complet, 6 fix en 22 min, heatmap nébuleuse (942371d→9a8a955, 01:42→08:00)
  • brain-guardian — auto-méfiance structurelle quand brain opère sur lui-même (6e876cb, 03:44)
  • session-kernel + session-edit-brain — séparation modes brain/kernel (99e4f2b, 03:51)
  • BSI v4 — intentions/ comme unité multi-sessions + TTL check boot (5e643d7, 04:35)
  • pre-flight gate — enforcement tier + write_lock + kerneluser au boot (cadafc6, 04:02)
  • Wiki 26 pages — documentation complète en une heure (06:43→07:34)
  • CATALOG sync 73/74 — 6 agents manquants ajoutés (6d19bec, 18:18)
  • Swarm foundation — ADR-032, execution_mode, swarm_ready flag (ffabc10, 18:49)
  • Review guidée — 21 fichiers agents patchés IPC + chemins + composition (19:09→20:20)

Décisions clés

  • brain-guardian : auto-méfiance. Un système qui se modifie lui-même a besoin d’un garde-fou dédié. Pas parce qu’il est incompétent — parce que la modification de ses propres règles est structurellement dangereuse.
  • pre-flight : refus > dégradation. Le brain préfère ne pas démarrer que démarrer en état incohérent. Le pre-flight vérifie les prérequis avant que la session commence.
  • BSI v4 : les intentions traversent les sessions. Un todo se termine dans une session. Une intention peut vivre sur dix sessions et deux machines. Le TTL détecte l’abandon.
  • ADR-032 : trois modes d’exécution. Manual → assisted → agentic. L’architecture prépare le swarm avant que le swarm existe.
  • L’entretien est du travail. Une vingtaine d’agents patchés, CATALOG synced, wiki enrichie. Les jours de ménage ne sont pas des jours perdus — ce sont les jours qui empêchent le drift de devenir dette.