From 72593128f372c2962771f28ca3faa9157aca475b Mon Sep 17 00:00:00 2001
From: Tetardtek <kvnn64@gmail.com>
Date: Sat, 14 Mar 2026 02:31:03 +0100
Subject: [PATCH] =?UTF-8?q?feat:=20brain-compose.yml=20v0.2.0=20+=20regist?=
 =?UTF-8?q?re=20local=20+=20gitignore=20+=20README=20=C3=A9tape=202b?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .gitignore                      |  1 +
 README.md                       | 14 +++++++
 brain-compose.local.yml.example | 23 +++++++++++
 brain-compose.yml               | 72 +++++++++++++++++++++++++++++++++
 4 files changed, 110 insertions(+)
 create mode 100644 .gitignore
 create mode 100644 brain-compose.local.yml.example
 create mode 100644 brain-compose.yml

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..80316ed
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1 @@
+brain-compose.local.yml
diff --git a/README.md b/README.md
index cddfaf8..3f218f9 100644
--- a/README.md
+++ b/README.md
@@ -43,6 +43,20 @@ sed -i 's|<BRAIN_NAME>|prod|g' ~/.claude/CLAUDE.md
 # Ce nom identifie l'instance — critique si plusieurs brains sur la même machine
 ```
 
+### Étape 2b — Initialiser brain-compose
+
+```bash
+cp brain-compose.local.yml.example brain-compose.local.yml
+# Éditer brain-compose.local.yml :
+# - kernel_path → ton chemin réel
+# - instances.prod.path → ton chemin réel
+# - instances.prod.brain_name → même valeur que brain_name dans CLAUDE.md
+```
+
+> Si tu as plusieurs brains sur la même machine (prod + dev-laptop) :
+> ajouter chaque instance dans brain-compose.local.yml.
+> Switcher d'instance : `brain-compose, active l'instance dev-laptop`
+
 ### Étape 3 — Configurer PATHS.md
 
 Ouvrir `PATHS.md` et remplacer tous les placeholders :
diff --git a/brain-compose.local.yml.example b/brain-compose.local.yml.example
new file mode 100644
index 0000000..5831186
--- /dev/null
+++ b/brain-compose.local.yml.example
@@ -0,0 +1,23 @@
+# brain-compose.local.yml — Registre machine
+# NON VERSIONNÉ — gitignored. Spécifique à cette machine.
+# Copier depuis brain-compose.local.yml.example, remplir, NE PAS commiter.
+
+kernel_path: <BRAIN_ROOT>
+kernel_version: "0.2.0"
+last_kernel_sync: "<YYYY-MM-DD>"
+
+instances:
+  prod:
+    path: <BRAIN_ROOT>
+    brain_name: prod
+    feature_set: full
+    config_status: hydrated   # hydrated / partial / empty
+    active: true
+
+  # Exemple — instance client ou template-test :
+  # template-test:
+  #   path: <BRAIN_ROOT>-test
+  #   brain_name: template-test
+  #   feature_set: full
+  #   config_status: partial
+  #   active: false
diff --git a/brain-compose.yml b/brain-compose.yml
new file mode 100644
index 0000000..513a80c
--- /dev/null
+++ b/brain-compose.yml
@@ -0,0 +1,72 @@
+# brain-compose.yml — Kernel spec
+# Versionné dans le kernel. Schema + feature flags + registre agents.
+# Géré par l'agent brain-compose — ne pas éditer manuellement.
+
+version: "0.2.0"
+
+# ---
+# Feature sets — contrôlent les agents invocables par instance
+# Les agents "bloqués" existent dans le kernel, brain-compose contrôle l'accès.
+# ---
+
+feature_sets:
+
+  free:
+    description: "Agents fondamentaux — exploration et maintenance brain"
+    agents:
+      - coach
+      - scribe
+      - todo-scribe
+      - debug
+      - mentor
+      - helloWorld
+      - aside
+      - brainstorm
+      - interprete
+      - orchestrator
+      - recruiter
+      - agent-review
+
+  pro:
+    description: "Agents métier — développement complet"
+    extends: free
+    agents:
+      - code-review
+      - security
+      - testing
+      - refacto
+      - vps
+      - ci-cd
+      - monitoring
+      - pm2
+      - frontend-stack
+      - optimizer-backend
+      - optimizer-db
+      - optimizer-frontend
+      - toolkit-scribe
+      - coach-scribe
+      - git-analyst
+      - capital-scribe
+      - i18n
+      - doc
+      - migration
+      - mail
+
+  full:
+    description: "Accès complet — usage personnel sans restriction"
+    extends: pro
+    agents: "*"
+
+# ---
+# Changelog — semver
+# v0.x.x : kernel en évolution rapide, breaking changes possibles
+# v1.0.0 : interface contractuelle stable
+# ---
+
+changelog:
+  - version: "0.1.0"
+    date: "2026-03-13"
+    notes: "Initial — 30+ agents, config-scribe, brain-compose Phase 1, symlinks, feature flags"
+  - version: "0.2.0"
+    date: "2026-03-14"
+    notes: "BSI (BRAIN-INDEX.md), brain_name, brain-template, aside, brainstorm, brain-compose up"