docs: satellites guide + brain-engine guide + sidebar mise a jour

docs/satellites.md

@@ -0,0 +1,150 @@
+# Les satellites — tes repos dans le brain
+
+> Pourquoi le brain a des sous-dossiers qui sont des repos Git separés.
+
+---
+
+## C'est quoi un satellite ?
+
+Le brain a un **kernel** (le repo principal) et des **satellites** (des repos Git independants qui vivent dans des sous-dossiers).
+
+```
+~/Dev/Brain/              ← kernel (repo principal)
+  agents/                 ← dans le kernel
+  profil/                 ← dans le kernel
+  todo/                   ← SATELLITE (son propre repo Git)
+  toolkit/                ← SATELLITE (son propre repo Git)
+  progression/            ← SATELLITE (son propre repo Git)
+  reviews/                ← SATELLITE (son propre repo Git)
+```
+
+Chaque satellite a sa propre histoire Git, ses propres commits, ses propres branches. Le kernel les ignore (`.gitignore`).
+
+---
+
+## Pourquoi ne pas tout mettre dans un seul repo ?
+
+**Isolation.** Tes todos n'ont pas besoin d'etre dans le meme historique que tes agents. Ta progression est privee — elle ne doit pas etre dans le template distribue. Ton toolkit peut etre partage independamment.
+
+**Permissions.** Le kernel est protege (confirmation humaine). Les satellites sont libres — les scribes ecrivent dedans sans gate.
+
+**Distribution.** Quand tu forkes le brain-template, tu recois le kernel propre. Tes satellites sont a toi — tu les crées.
+
+---
+
+## Les 4 satellites
+
+### todo/ — tes intentions
+
+Ce que tu veux faire, ce qui reste a faire, ce qui est planifie.
+
+```
+todo/
+  README.md       ← index des fichiers actifs
+  brain.md        ← todos du brain lui-meme
+  <projet>.md     ← todos par projet
+```
+
+Ecrit par : `todo-scribe` en fin de session.
+
+### toolkit/ — tes patterns valides
+
+Les patterns, templates, et snippets que tu as valides en prod. Reutilisables d'une session a l'autre.
+
+```
+toolkit/
+  _template.md    ← template de pattern
+  docker/         ← patterns Docker
+  apache/         ← templates vhost
+  github-actions/ ← pipelines CI/CD
+```
+
+Ecrit par : `toolkit-scribe` quand un pattern est valide.
+
+### progression/ — ton parcours
+
+Ta progression, tes skills, ton metabolisme de sessions. Le coach ecrit ici.
+
+```
+progression/
+  README.md           ← niveau actuel + objectifs
+  metabolism/         ← metriques de chaque session
+  skills/             ← competences par domaine
+  journal/            ← observations de session
+```
+
+Ecrit par : `metabolism-scribe`, `coach-scribe`.
+
+### reviews/ — tes audits d'agents
+
+Les audits faits par `agent-review` — comment chaque agent performe en conditions reelles.
+
+```
+reviews/
+  _template.md    ← template de review
+  <Projet>/       ← reviews par projet
+```
+
+Ecrit par : `agent-review`.
+
+---
+
+## Comment les creer
+
+### Option 1 — Dossiers locaux (le plus simple)
+
+Le `setup.sh` cree les dossiers automatiquement au premier lancement. Ils fonctionnent comme des dossiers normaux. Pas de repo Git separe.
+
+C'est suffisant pour commencer. Tu peux les versionner plus tard.
+
+### Option 2 — Repos Git separes (recommande a terme)
+
+Si tu veux versionner chaque satellite independamment :
+
+```bash
+# Creer un repo pour todo/
+cd ~/Dev/Brain/todo
+git init
+git add .
+git commit -m "init: todo satellite"
+# Optionnel : push vers ton Gitea/GitHub
+git remote add origin <URL_DU_REPO>
+git push -u origin main
+```
+
+Repete pour chaque satellite (toolkit/, progression/, reviews/).
+
+> Le `.gitignore` du kernel ignore deja ces dossiers — pas de conflit.
+
+### Option 3 — Cloner des satellites existants
+
+Si tu reprends un brain existant ou tu veux partir d'un satellite pre-rempli :
+
+```bash
+git clone <URL> ~/Dev/Brain/todo
+git clone <URL> ~/Dev/Brain/toolkit
+git clone <URL> ~/Dev/Brain/progression
+git clone <URL> ~/Dev/Brain/reviews
+```
+
+---
+
+## Ce qui se passe si un satellite est absent
+
+**Rien ne casse.** Le brain fonctionne sans satellites. Le briefing signale ce qui manque :
+
+```
+⚠️ Alertes
+  - progression/ satellite non clone
+  - todo/ satellite non clone
+```
+
+C'est informatif, pas bloquant. Les scribes ne peuvent juste pas ecrire dans des dossiers qui n'existent pas.
+
+---
+
+## Regle d'or
+
+> Le kernel ne depend jamais des satellites. Les satellites dependent du kernel.
+> Un satellite peut etre supprime et recree sans impact sur le brain.
+> Le kernel, lui, est sacre.