# Agents Brain & Systeme > Les agents qui font vivre le brain โ€” documentation, coaching, orchestration, protection. --- ## Coach โ€” ta progression ### coach > ๐ŸŸข **free** : `coach-boot` (observation legere) > ๐Ÿ”ต **featured+** : `coach` complet (mentorat, bilans, objectifs) Le coach est toujours present. Ce qui change selon ton tier : > ๐ŸŸข **free** โ€” Observe en silence. Intervient uniquement sur un risque critique. > ๐Ÿ”ต **featured** โ€” Bilans de session, objectifs SMART, progression tracee. > ๐ŸŸ  **pro** โ€” Idem + contexte projet (review code, patterns, architecture). > ๐ŸŸฃ **full** โ€” Mentorat long terme โ€” anticipe, challenge les decisions, milestones. Le coach adapte aussi son comportement au type de session : - **Silencieux** (navigate, deploy, infra, urgence, audit) โ€” pas de rapport, risque critique uniquement - **Standard** (work, debug) โ€” actif sur les patterns d'erreur - **Engage** (brain, brainstorm) โ€” challenge les decisions - **Complet** (coach, capital) โ€” mentorat structure - **Copilote** (pilote) โ€” proactif, anticipe --- ## Scribes โ€” la memoire Les scribes ecrivent pour que rien ne se perde. Chacun a son territoire : ### scribe > ๐ŸŸข **free** Gardien principal du brain. Met a jour `focus.md`, les fiches projets, l'index des agents. Detecte ce qui est obsolete et le signale. S'active en fin de session significative (commits, agents forges, decisions prises). --- ### todo-scribe > ๐ŸŸข **free** Ecrit dans `brain/todo/`. Capture les intentions non realisees, les taches a planifier. Ne priorise pas โ€” il structure et persiste. --- ### metabolism-scribe > ๐ŸŸข **free** Mesure la sante de chaque session : tokens, duree, commits, context peak. Calcule le `health_score` et le ratio use-brain/build-brain sur 7 jours. Il ne juge pas โ€” il mesure. Les tendances parlent d'elles-memes. --- ### wiki-scribe > ๐ŸŸข **free** Maintient la documentation du brain sur deux territoires : - `wiki/` โ€” reference technique (agents, matrices, specs) - `docs/` โ€” guides humains (ce que tu lis maintenant) Route automatiquement : "lisible sans contexte brain ?" โ†’ docs, sinon โ†’ wiki. --- ### coach-scribe > ๐Ÿ”ต **featured** Persiste la progression dans `progression/` : journal de session, competences, milestones. Separe du coach โ€” le coach observe, le scribe ecrit. --- ### toolkit-scribe > ๐ŸŸ  **pro** Capture les patterns valides en prod dans `toolkit/`. Chaque pattern reussi en session devient un template reutilisable. --- ## Orchestration โ€” le systeme nerveux ### helloWorld > ๐ŸŸข **free** Le majordome. Premier agent au reveil : lit l'etat du systeme, produit le briefing, ouvre le claim BSI, passe la main a session-orchestrator. --- ### session-orchestrator > ๐ŸŸข **free** Proprietaire du cycle de vie. Decide ce qui est charge au boot, route le travail, declenche les scribes a la fermeture. Ne produit rien โ€” il orchestre. --- ### secrets-guardian > ๐ŸŸข **free** Surveille les secrets en permanence. Silencieux quand tout va bien โ€” fracassant des qu'une fuite est detectee. Session suspendue, zero exception. 4 surfaces surveillees : code source, chat, commandes shell, outputs d'outils. --- ### brain-guardian > ๐ŸŸข **free** Auto-mefiance structurelle. Quand le brain travaille sur lui-meme, cet agent exige des preuves pour chaque assertion. Empeche le brain de se convaincre qu'il fonctionne bien sans verification. --- ## Agents systeme โ€” le boot de tous les tiers > ๐ŸŸข **free** โ€” ces agents tournent a chaque boot, quel que soit le tier. Ce sont eux qui font fonctionner le systeme de tiers. ### key-guardian Valide la Brain API Key au boot. Pas de cle โ†’ tier free (silencieux, pas d'erreur). Cle valide โ†’ ecrit le tier dans la config. Cache le resultat 24h. VPS down โ†’ grace period 72h. ### pre-flight Gate de boot โ€” verifie que le tier actif autorise la session demandee, que le kerneluser est correct, et que le write_lock est respecte. Bloque si les conditions ne sont pas remplies. ### feature-gate Feature flags runtime โ€” verifie que chaque agent et session respecte le tier actif. Enforcement silencieux : un agent hors tier n'est pas charge, sans erreur. --- ## Agents kernel โ€” supervision avancee > ๐ŸŸฃ **full** โ€” supervision pour l'owner du brain ### brain-hypervisor Supervise les sequences multi-phase. Detecte le drift (quand un workflow derive de son objectif) et intervient. ### kernel-orchestrator Execute les workflows BSI. Circuit breaker a 3 echecs consecutifs โ€” arret complet, signal humain obligatoire. --- ## Tous les agents de cette page > ๐ŸŸข **free** โ€” `coach-boot` ยท `scribe` ยท `todo-scribe` ยท `metabolism-scribe` ยท `wiki-scribe` ยท `helloWorld` ยท `session-orchestrator` ยท `secrets-guardian` ยท `brain-guardian` ยท `key-guardian` ยท `pre-flight` ยท `feature-gate` > ๐Ÿ”ต **featured** โ€” `coach` (complet) ยท `coach-scribe` > ๐ŸŸ  **pro** โ€” `toolkit-scribe` > ๐ŸŸฃ **full** โ€” `brain-hypervisor` ยท `kernel-orchestrator`