L'Architecture

Les briques fondamentales d'un OS personnel. Chaque décision est tracée dans un commit réel.

L'arc de construction

J1

Knowledge Base

"j'ai des projets et de la connaissance"

b0bb88a
J2

Modules cognitifs

"j'ai des régions spécialisées et je suis portable"

29 agents
J3

Identité & continuité

"j'ai une conscience de soi et je coordonne"

BSI v1
J4

Constitution

"j'ai des lois et je ne peux pas les enfreindre"

Layer 0
J7+

Multi-machine

"je tourne sur deux machines et je me synchronise"

BSI v4

Loi des zones

Chaque fichier du brain vit dans une zone. Chaque zone a un niveau de protection. Chaque agent sait automatiquement ce qu'il peut toucher.

KERNEL
Absolu — humain uniquement
KERNEL.md, constitution, CLAUDE.md, agents/, profil/
PROFIL
Fort — confirmation requise
SATELLITES
Standard — scribe propriétaire
toolkit/, progression/, todo/, reviews/, handoffs/
INSTANCE
Libre — configuration machine
focus.md, projets/, brain-compose.local.yml
WORK
Externe — le brain documente, ne possède pas
GitHub, Gitea, repos projets
Règle d'or

Satellite → kernel = promotion possible. Kernel → satellite = contamination interdite. Le flux est unidirectionnel.

BSI — Brain Session Index

Locking optimiste. Pas de blocage, mais déclaration de qui travaille sur quoi. Le watchdog détecte les conflits.

Claims

Chaque session ouvre un claim avec son sess-id@machine. Le claim déclare le scope — quels fichiers sont touchés.

sess-20260319-0434-navigate@laptop

Signals

Bus inter-sessions. Une session peut envoyer un CHECKPOINT, HANDOFF, BLOCKED_ON à une autre session.

CHECKPOINT HANDOFF BLOCKED_ON INFO

Tiered Close

Trois niveaux de fermeture selon la criticité.

Atomic — commit + close, 10 secondes
Validated — metabolism + todos + brain update
Orchestrated — coach rapport + intentions + push

Évolution BSI

v1Claims markdown
v1.1instance@machine
v2Claims YAML
v3Satellites, exit triggers
v4SQLite + réseau

BHP — Brain Hydration Protocol

Comment charger un brain trop grand pour tenir en mémoire ? En classifiant chaque fichier.

L0 — Invariant ~4%

Toujours chargé. KERNEL.md, PATHS.md, brain-compose. Non négociable.

L1 — Session type ~12%

Déterminé par le manifest. Même signal + même tier = même chargement.

L2 — Project scope ~2%

Conditionnel. Silencieux si fichier absent. Template interpolé.

L3 — On demand 0%

Réactif — jamais proactif. L'agent demande, on charge.

always — chargé à chaque boot
hot — chargé si domaine détecté
warm — chargé sur invocation
cold — référence uniquement

Système d'agents

79 agents. 8 scribes. Chacun a un territoire exclusif. La non-contamination est une invariante.

Kernel

helloWorld
coach
secrets-guardian
session-orchestrator
recruiter
brain-guardian

Scribes

scribe
todo-scribe
coach-scribe
toolkit-scribe
metabolism-scribe
orchestrator-scribe
capital-scribe
kanban-scribe

Metier

code-review
security
testing
debug
vps
ci-cd
frontend-stack
migration
monitoring

Contenu & croissance

storyteller
mentor
brainstorm
interprete
doc
aside
Scribe Pattern

Un agent metier ne commit jamais directement. Il signal → le scribe competent ecrit → dans sa zone uniquement.

Agent metier → signal → Scribe → write → Zone

Constitution

Layer 0 immuable. Ne peut pas etre modifie a runtime. Prime sur tout.

01

Identite

Le brain a un nom, un owner, une version. Il sait ce qu'il est.

02

Invariants

Regles non-negociables. Anti-hallucination. Scribe system. Zones.

03

Autonomie

Irreversible → escalade humaine. Le brain ne s'endommage jamais lui-meme.

04

North Star

"Reduire la dependance a Claude au fil du temps." L'autonomie est la direction.

Metriques reelles

746 commits
79 agents
8 scribes
11 modes
41 ADRs
2 machines
v0.8.0 kernel
<2min cold start KPI

Commit ownership

kernel:
feat:
fix:
bsi:
scribe:
metabolism:
todo:
toolkit:
config:
integrator:

Chaque prefixe = une zone. Chaque zone = un scribe proprietaire. Le git prouve qui a ecrit quoi.

Ces decisions n'existaient pas le 12 mars 2026. Elles ont ete construites depuis des frictions — des blocages qui, une fois traverses, deviennent des regles.