4.2 KiB
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 :
# 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
.gitignoredu 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 :
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.