151 lines
4.2 KiB
Markdown
151 lines
4.2 KiB
Markdown
# 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.
|