sync: kernel v0.8.0 → template

2026-03-21 19:57:40 +01:00
parent 667e84aa30
commit e40e22c949
14 changed files with 346 additions and 40 deletions
--- a/docs/README.md
+++ b/docs/README.md
@@ -1,6 +1,7 @@
 # docs/ — Documentation humaine

 > Guides lisibles sans contexte brain. Pour forks, onboarding, ou quand tu veux comprendre comment ca marche.
+> L'histoire du projet → [story.tetardtek.com](https://story.tetardtek.com)

 ---

--- a/docs/agents.md
+++ b/docs/agents.md
@@ -1,8 +1,12 @@
 # Le brain en 30 secondes

-Un brain, c'est un systeme de **specialistes IA** qui travaillent ensemble. Chaque specialiste (agent) fait une chose bien : debugger, reviewer du code, deployer, ecrire des tests. Tu n'en charges jamais plus de 5 a la fois — le brain sait lesquels activer selon ce que tu fais.
+## Pourquoi un brain plutot que Claude seul ?

-Tu forkes le brain, tu codes. Les agents se chargent automatiquement.
+Claude est puissant. Mais a chaque session, il repart de zero. Tu re-expliques ton projet, ta stack, tes conventions. Tu repetes les memes consignes. Tu perds du contexte a chaque compaction.
+
+Le brain resout ca : **un systeme de specialistes IA qui persistent entre sessions.** Chaque specialiste (agent) fait une chose bien — debugger, reviewer du code, deployer, ecrire des tests. Ils connaissent tes regles, ta stack, tes decisions passees. Tu n'en charges jamais plus de 5 a la fois — le brain sait lesquels activer selon ce que tu fais.
+
+Tu forkes le brain, tu codes. Les agents se chargent automatiquement. Ton contexte survit aux sessions.

 ---

@@ -10,25 +14,25 @@ Tu forkes le brain, tu codes. Les agents se chargent automatiquement.

 > 🟢 **free — Tu forkes, ca marche**
 >
-> **14 agents + 8 systeme. 6 sessions.** Pas de cle API, pas de config.
+> **17 agents + 9 systeme. 6 sessions.** Pas de cle API, pas de config.
 >
-> Debug, brainstorm, scribes automatiques, protection secrets, creation d'agents custom. Le coach observe en arriere-plan.
+> Debug, brainstorm, scribes automatiques, protection secrets, creation d'agents custom. 3 agents d'onboarding (guide, catalogist, pathfinder) pour t'orienter. Le coach observe en arriere-plan.

 > 🔵 **featured — Le brain te connait**
 >
-> **18 agents + systeme. 8 sessions.** Le coach se reveille.
+> **21 agents + systeme. 8 sessions.** Le coach se reveille.
 >
 > Bilans de session, objectifs concrets, progression tracee. Le brain se souvient de tes acquis entre sessions grace a la distillation RAG.

 > 🟠 **pro — L'atelier complet**
 >
-> **40 agents + systeme. 12 sessions.** Tu ship en prod.
+> **42 agents + systeme. 14 sessions.** Tu ship en prod.
 >
 > Code review (7 priorites), audit securite (8 priorites OWASP), tests automatises, 3 optimiseurs perf, deploy VPS + CI/CD + SSL, sessions urgence et infra.

 > 🟣 **full — Ton brain, tes regles**
 >
-> **75 agents (tous). 15 sessions.** Tu es owner.
+> **81 agents (tous). 15 sessions.** Tu es owner.
 >
 > Modification du kernel, copilotage long (mode pilote), supervision multi-phase (hypervisor), coach proactif qui anticipe.

@@ -66,6 +70,11 @@ Charge les agents security et code-review

 **Ils ne chargent que l'essentiel.** Un agent de 200 lignes → ~25 lignes au boot. Le reste se charge quand tu en as besoin.

+**Premier fork ? 3 agents t'orientent.**
+- `guide` — presente le systeme, repond a "c'est quoi ce truc ?"
+- `catalogist` — explore ce qui est disponible (agents, tiers, features)
+- `pathfinder` — t'oriente vers la bonne session selon ce que tu veux faire
+
 ---

 ## Explore les agents par famille
@@ -80,10 +89,19 @@ Charge les agents security et code-review

 ---

+## Pour aller plus loin
+
+**L'histoire du projet** — [story.tetardtek.com](https://story.tetardtek.com) raconte le pourquoi, le parcours, les decisions. Si tu veux comprendre la vision avant de fork.
+
+---
+
 ## Nouveautes

 | Date | Quoi de neuf |
 |------|-------------|
+| 2026-03-21 | 3 agents onboarding (guide, catalogist, pathfinder) — le brain accueille les nouveaux |
+| 2026-03-21 | Docs live — git pull = docs a jour, zero rebuild |
+| 2026-03-21 | VPS scission — vitrine template publique separee du brain prod |
 | 2026-03-20 | Agents 87% plus legers au boot |
 | 2026-03-20 | Coach adaptatif — 5 comportements selon la session |
 | 2026-03-20 | Fermeture fiable — sequence deterministe |
--- a/docs/architecture.md
+++ b/docs/architecture.md
@@ -10,7 +10,7 @@ Le brain c'est 3 couches :

 **1. Le kernel** — l'identite
 - Les regles qui ne changent pas (KERNEL.md, constitution, PATHS.md)
- Les agents specialises (~75 fichiers .md)
+- Les agents specialises (~81 fichiers .md)
 - Le profil de collaboration
 - Le brain-compose.yml (config, tiers, modes)

--- a/docs/getting-started.md
+++ b/docs/getting-started.md
@@ -1,6 +1,7 @@
 # Demarrer avec le brain — le vrai tuto

 > Du fork au premier `brain boot`. 10 minutes.
+> Envie de comprendre le projet avant de fork ? → [story.tetardtek.com](https://story.tetardtek.com)

 ---

@@ -55,7 +56,7 @@ bash setup.sh
 Le script fait tout automatiquement :

 1. **Cree `brain-compose.local.yml`** — ta config machine (chemins auto-detectes)
-2. **Cree les dossiers satellites** — todo/, progression/, toolkit/, reviews/, workspace/ ([pourquoi ?](satellites.md))
+2. **Cree les dossiers satellites** — todo/, progression/, toolkit/, reviews/, workspace/
 3. **Copie `profil/collaboration.md`** — regles de travail
 4. **Build le dashboard** — `brain-ui/` (npm install + vite build)
 5. **Init brain-engine** — cree l'environnement Python + brain.db
@@ -98,45 +99,48 @@ Brain-engine c'est le serveur local qui fait tourner l'API, le dashboard, et la
 ### Demarrer

 ```bash
+cd ~/Dev/Brain
 bash brain-engine/start.sh
 ```

-Brain-engine demarre en arriere-plan. Tu vois :
+Tu vois :

 ```
-✅ brain-engine demarre (PID 12345)
-   Logs    : tail -f brain-engine/brain-engine.log
-   Arreter : bash brain-engine/stop.sh
+=== Lancement brain-engine sur port 7700 ===
+  Health : http://localhost:7700/health
+  Dashboard : http://localhost:7700/ui/
 ```

+> **Le terminal reste occupe** — brain-engine tourne au premier plan. Ouvre un autre terminal pour la suite.
+
 ### Verifier

-```bash
-bash brain-engine/status.sh
-```
-
-Ou ouvre ton navigateur : `http://localhost:7700/ui/`
+Ouvre ton navigateur : `http://localhost:7700/ui/`
 Tu vois le dashboard avec l'onglet Docs — c'est cette documentation.

 ### Arreter

-```bash
-bash brain-engine/stop.sh
-```
-
-### Mode debug (optionnel)
-
-Si tu veux voir les logs en direct dans le terminal :
-
-```bash
-bash brain-engine/start.sh --foreground
-```
-
-`Ctrl+C` pour arreter.
+Reviens dans le terminal ou brain-engine tourne et fais `Ctrl+C`. C'est tout.

 > Brain-engine n'est pas obligatoire pour utiliser le brain avec Claude Code.
 > C'est un bonus (dashboard, search, API). Tu peux faire `brain boot` sans.

+### Lancer en arriere-plan (optionnel)
+
+Si tu ne veux pas bloquer un terminal :
+
+```bash
+cd ~/Dev/Brain
+nohup bash brain-engine/start.sh > /tmp/brain-engine.log 2>&1 &
+echo $! > /tmp/brain-engine.pid
+```
+
+Pour l'arreter :
+
+```bash
+kill $(cat /tmp/brain-engine.pid)
+```
+
 ---

 ## Etape 6 — Premier brain boot
@@ -220,11 +224,8 @@ claude

 ### Brain-engine tourne encore en fond, comment l'arreter ?

-```bash
-bash brain-engine/stop.sh
-```
-
-Pour verifier s'il tourne : `bash brain-engine/status.sh`
+Si tu l'as lance au premier plan : `Ctrl+C` dans son terminal.
+Si tu l'as lance en arriere-plan : `kill $(cat /tmp/brain-engine.pid)`
 En dernier recours : `pkill -f 'python3.*server.py'`

 ### Je vois "MYSECRETS absent" — c'est grave ?
@@ -243,6 +244,20 @@ git fetch upstream
 git merge upstream/main
 ```

+### J'utilise Gitea self-hosted et git clone echoue ?
+
+Gitea en Docker ecoute souvent sur un port SSH non standard (2222 au lieu de 22). Ajoute dans `~/.ssh/config` :
+
+```
+Host git.example.com
+    HostName git.example.com
+    Port 2222
+    User git
+    IdentityFile ~/.ssh/id_ed25519
+```
+
+Puis ajoute la host key : `ssh-keyscan -p 2222 git.example.com >> ~/.ssh/known_hosts`
+
 ### Ou est la documentation complete ?

 - Dashboard : `http://localhost:7700/ui/` → onglet Docs
--- a/docs/vue-free.md
+++ b/docs/vue-free.md
@@ -1,6 +1,6 @@
 # 🟢 free — Ce que tu as

-> 🟢 **14 agents invocables + 8 systeme. 6 sessions. Pas de cle, pas de config.**
+> 🟢 **17 agents invocables + 9 systeme. 6 sessions. Pas de cle, pas de config.**

 ---

@@ -36,6 +36,12 @@
 - `pattern-scribe` — detection patterns recurrents
 - `time-anchor` — conscience temporelle, recontextualisation

+**S'orienter**
+
+- `guide` — presentation du systeme, accueil fresh fork
+- `catalogist` — exploration des registres (agents, tiers, features)
+- `pathfinder` — routage intentionnel, oriente vers la bonne session
+
 ---

 ## Agents systeme
--- a/docs/vue-tiers.md
+++ b/docs/vue-tiers.md
@@ -7,7 +7,7 @@

 ## 🟢 free — Ce que tu as

-> 🟢 **14 agents invocables + 8 systeme. 6 sessions.**
+> 🟢 **17 agents invocables + 9 systeme. 6 sessions.**

 ### Sessions

@@ -37,6 +37,11 @@
 - `pattern-scribe` — detection patterns recurrents
 - `time-anchor` — conscience temporelle, recontextualisation

+**S'orienter**
+- `guide` — presentation du systeme, accueil fresh fork
+- `catalogist` — exploration des registres (agents, tiers, features)
+- `pathfinder` — routage intentionnel, oriente vers la bonne session
+
 ### Agents systeme (tournent a chaque boot)

 - `helloWorld` — briefing, claim BSI