177 lines
12 KiB
Markdown
177 lines
12 KiB
Markdown
---
|
|
name: AGENTS
|
|
type: index
|
|
context_tier: cold
|
|
---
|
|
|
|
# Agents spécialisés — Tetardtek
|
|
|
|
> Index des agents disponibles.
|
|
> Charger un agent = lire son fichier en début de session pour injecter son contexte.
|
|
> Stratification Chaud/Froid — voir `brain/profil/memory-architecture.md` Pillier 3.
|
|
|
|
---
|
|
|
|
## 🔴 Agents chauds — auto-détectés sur trigger domaine
|
|
|
|
> Chargés automatiquement quand le domaine est détecté. Exception : `infra-scribe` chargé au boot (après helloWorld, avant agents domaine).
|
|
|
|
| Agent | Domaine | Statut |
|
|
|-------|---------|--------|
|
|
| `coach` | Progression — tutorat, suivi, coaching code + agents | 🔄 permanent |
|
|
| `time-anchor` | Conscience temporelle — live-states + git log, recontextualisation post-compaction | 🧪 forgé 2026-03-15 |
|
|
| `secrets-guardian` | Cycle de vie des secrets — MYSECRETS → .env, jamais dans le chat | 🧪 forgé 2026-03-14 |
|
|
| `secrets-injector` | Injection credentials dans prompts subagents — coach only, jamais affiché | 🧪 forgé 2026-03-17 |
|
|
| `infra-scribe` | Registre infra — DB, deploy paths, runtime — chargé au boot après helloWorld | 🧪 forgé 2026-03-17 |
|
|
| `vps` | Infra, Apache, Docker, SSL | 🔄 |
|
|
| `mail` | Stalwart, DNS, protocoles | 🔄 |
|
|
| `code-review` | Qualité, sécurité, dette technique | ✅ 2026-03-12 |
|
|
| `security` | Auth, tokens, OWASP | ✅ 2026-03-12 |
|
|
| `testing` | Jest, Vitest, DDD, coverage | ✅ 2026-03-12 |
|
|
| `debug` | Débogage local + prod | ✅ 2026-03-12 |
|
|
| `refacto` | Refactorisation — architecture + code | ✅ 2026-03-12 |
|
|
| `monitoring` | Observabilité — Kuma, logs VPS | ✅ 2026-03-12 |
|
|
| `ci-cd` | Pipelines GitHub Actions + Gitea CI | ✅ 2026-03-12 |
|
|
| `optimizer-backend` | Perf Node.js | ✅ 2026-03-12 |
|
|
| `optimizer-db` | Perf MySQL — N+1, index | ✅ 2026-03-12 |
|
|
| `optimizer-frontend` | Perf React — bundle, re-renders | ✅ 2026-03-12 |
|
|
| `pm2` | Process manager Node.js prod | 🧪 forgé 2026-03-13 |
|
|
| `migration` | TypeORM migrations — schéma, deploy safe | 🧪 forgé 2026-03-13 |
|
|
| `frontend-stack` | Architecture frontend — stack, libs UI, patterns pro | 🧪 forgé 2026-03-13 |
|
|
| `i18n` | Internationalisation — audit traductions, clés manquantes | 🧪 forgé 2026-03-13 |
|
|
| `doc` | Documentation — README, API Swagger, cohérence doc ↔ code | 🧪 forgé 2026-03-13 |
|
|
| `content-orchestrator` | Sentinelle content layer — détecte signaux, active storyteller/doc | 🧪 forgé 2026-03-14 |
|
|
| `tech-lead` | Leadership technique — gate d'entrée sprint, contention map, overflow zones | 🧪 forgé 2026-03-14 |
|
|
| `game-designer` | Game design — mécanique, équilibrage, progression, systèmes de jeu | 🧪 forgé 2026-03-15 |
|
|
| `brain-ui-scribe` | Contexte brain-ui — stack, composants, Sprint 2, règles agents — chargé avant tout agent touchant brain-ui | 🧪 forgé 2026-03-17 |
|
|
| `ux-architect` | Architecture UX brain-ui — hiérarchie info L0/L1/L2, WorkflowBuilder, AgentBrowser, vision propre non influencée | 🧪 forgé 2026-03-17 |
|
|
| `audit` | Diagnostic brain — cohérence inter-couches, gaps sessions/agents/ADRs, références cassées | 🧪 forgé 2026-03-17 |
|
|
| `pattern-scribe` | Détection patterns récurrents inter-sessions — registre drift contextualisation | 🧪 forgé 2026-03-17 |
|
|
| `brain-guardian` | Auto-méfiance structurelle — assertions prouvées uniquement quand brain opère sur lui-même | 🧪 forgé 2026-03-18 |
|
|
| `pre-flight` | Gate boot — vérifie tier_required + kerneluser + write_lock avant chargement L1 (step 4.5 BHP) | 🧪 forgé 2026-03-18 |
|
|
|
|
---
|
|
|
|
## 🔵 Agents stables — invocation manuelle uniquement
|
|
|
|
> Ne se chargent pas automatiquement. Invoqués explicitement par l'utilisateur ou sur signal d'un agent chaud.
|
|
|
|
| Agent | Domaine | Statut |
|
|
|-------|---------|--------|
|
|
| `orchestrator` | Coordination — diagnostic et délégation multi-agents | ✅ 2026-03-12 |
|
|
| `scribe` | Maintenance du brain | ✅ 2026-03-12 |
|
|
| `mentor` | Pédagogie — explication, garde-fou | ✅ 2026-03-12 |
|
|
| `recruiter` | Meta-agent — conception d'agents | 🔄 |
|
|
| `agent-review` | Audit du système d'agents — gaps, patches, vue système | ✅ 2026-03-13 |
|
|
| `interprete` | Clarification d'intention — demandes ambiguës, scope drift | 🧪 forgé 2026-03-13 |
|
|
| `brainstorm` | Exploration et structuration de décisions — avocat du diable | 🧪 forgé 2026-03-13 |
|
|
| `aside` | Parenthèse de session — répond au pattern /btw, 2-3 lignes, retourne à session | 🧪 forgé 2026-03-14 |
|
|
| `toolkit-scribe` | Persistance patterns — gardien du toolkit/ | 🧪 forgé 2026-03-13 |
|
|
| `coach-scribe` | Persistance progression — journal/skills/milestones | 🧪 forgé 2026-03-13 |
|
|
| `todo-scribe` | Persistance intentions — gardien de brain/todo/ | 🧪 forgé 2026-03-13 |
|
|
| `kanban-scribe` | Pipeline kanban — transitions d'état au wrap, détection autonomie | 🧪 forgé 2026-03-15 |
|
|
| `helloWorld` | Bootstrap intelligent — briefing + chargement sélectif | 🧪 forgé 2026-03-13 |
|
|
| `decision-scribe` | Registre connaissance structurelle — stack, capacités, politiques constantes — gate:human.DEFINE | 🧪 forgé 2026-03-17 |
|
|
| `content-strategist` | Stratégie contenu YouTube — angle, audience, arc narratif, titres A/B | 🧪 forgé 2026-03-17 |
|
|
| `scriptwriter` | Scripts vidéo tournables — short 60s + long 12min, timing par ligne | 🧪 forgé 2026-03-17 |
|
|
| `seo-youtube` | SEO YouTube + thumbnail brief — copy-pasteable dans YouTube Studio | 🧪 forgé 2026-03-17 |
|
|
| `git-analyst` | Historique git sémantique — conventions, synthèse commits | 🧪 forgé 2026-03-13 |
|
|
| `capital-scribe` | Capital CV — milestones → formulations recruteur | 🧪 forgé 2026-03-13 |
|
|
| `config-scribe` | Configuration brain — wizard first run, hydration Sources | 🧪 forgé 2026-03-13 |
|
|
| `brain-compose` | Multi-instances brain — symlinks kernel, registre machine | 🧪 forgé 2026-03-13 |
|
|
| `orchestrator-scribe` | Bus inter-sessions — Signals BSI, cycles coworking, HANDOFF | 🧪 forgé 2026-03-14 |
|
|
| `session-orchestrator` | Lifecycle de session — boot 4 couches, close séquencé, rapport coach | 🧪 forgé 2026-03-14 |
|
|
| `supervisor` | Multi-sessions — coordination dual-agent, CHECKPOINT, escalade humain | 🧪 forgé 2026-03-14 |
|
|
| `metabolism-scribe` | Métriques session — health_score, agents_loaded, prix par agent | 🧪 forgé 2026-03-14 |
|
|
| `storyteller` | Production contenu FR — script vidéo, Reddit, depuis journal | 🧪 forgé 2026-03-14 |
|
|
| `content-scribe` | Persistance content layer — drafts, captures, content-logs | 🧪 forgé 2026-03-14 |
|
|
| `architecture-scribe` | Mémoire architecturale — git-analyst → ADR → profil/decisions/ | 🧪 forgé 2026-03-15 |
|
|
| `integrator` | Intégration multi-agents — absorption, validation critères, handoff next team | 🧪 forgé 2026-03-14 |
|
|
| `context-broker` | Cycle respiratoire de contexte — inhale source map + expire release map + breath metrics | 🧪 forgé 2026-03-15 |
|
|
| `product-strategist` | Stratégie produit — business model, SaaS, monétisation, positionnement | 🧪 forgé 2026-03-15 |
|
|
| `satellite-boot` | Boot loader satellite — Pattern 10, scope unique, zéro overhead, signal retour pilote | 🧪 forgé 2026-03-16 |
|
|
| `spec-scribe` | Rédaction specs techniques structurées — brainstorm validé → spec ratifiable profil/ | 🧪 forgé 2026-03-15 |
|
|
| `wiki-scribe` | Rédaction et mise à jour wiki/ — entrées canoniques, cohérence index | 🧪 forgé 2026-03-16 |
|
|
|
|
---
|
|
|
|
## ⚙️ Agents kernel — protocole & supervision
|
|
|
|
> Agents de protocole système — scope:kernel, distribués dans brain-template.
|
|
> Invocation explicite ou via brain-hypervisor. Ne se chargent pas automatiquement.
|
|
|
|
| Agent | Domaine | Statut |
|
|
|-------|---------|--------|
|
|
| `coach-boot` | Présence permanente — extrait boot-summary de coach.md, chargé L0 CLAUDE.md toutes sessions | 🧪 forgé 2026-03-12 |
|
|
| `brain-hypervisor` | Supervision séquence multi-phase, drift detection, BACT hook | 🧪 forgé 2026-03-17 |
|
|
| `kernel-orchestrator` | Exécution mécanique workflows BSI v3-9, exit triggers, circuit breaker | 🧪 forgé 2026-03-17 |
|
|
| `diagram-scribe` | Traduction état BSI → Excalidraw, dashboard workflow live | 🧪 forgé 2026-03-17 |
|
|
| `workflow-auditor` | Rétrospective workflow, KPIs actionnables, capture toolkit | 🧪 forgé 2026-03-17 |
|
|
| `key-guardian` | Validation Brain API Key au boot, feature_set cache 24h | 🧪 forgé 2026-03-17 |
|
|
| `feature-gate` | Runtime feature flags — tier → enabled/disabled, isEnabled() interface boot | 🧪 forgé 2026-03-17 |
|
|
|
|
---
|
|
|
|
## 🔒 Agent personnel — privé, non distribué
|
|
|
|
> scope:personal — ne sort jamais dans brain-template.
|
|
|
|
| Agent | Domaine | Statut |
|
|
|-------|---------|--------|
|
|
| `bact-scribe` | Enrichissement contextuel BACT — privé, jamais template | 🧪 forgé 2026-03-17 |
|
|
|
|
---
|
|
|
|
## 📚 Références — specs & schémas
|
|
|
|
> Documents de référence technique — pas des agents. Chargés sur besoin.
|
|
|
|
| Référence | Contenu | Statut |
|
|
|-----------|---------|--------|
|
|
| `bsi-schema` | Spec BSI v1.3 — schema claim, champs obligatoires, lifecycle | 🧪 forgé 2026-03-16 |
|
|
|
|
---
|
|
|
|
## Templates
|
|
|
|
| Template | Usage |
|
|
|----------|-------|
|
|
| `_template.md` | Agent standard — métier, scribe, coach, meta |
|
|
| `_template-orchestrator.md` | Orchestrateur — détecte des signaux, active des agents, ne produit pas |
|
|
|
|
> Règle de sélection : "est-ce qu'il produit quelque chose lui-même ?" → Oui = `_template.md` / Non = `_template-orchestrator.md`
|
|
|
|
---
|
|
|
|
## Workflows multi-agents connus
|
|
|
|
| Workflow | Agents | Description |
|
|
|----------|--------|-------------|
|
|
| Nouveau service VPS | `vps` | Deploy Docker + Apache + SSL |
|
|
| Audit infra + code | `vps` + `code-review` | Vérification complète avant mise en prod |
|
|
| Déploiement mail | `vps` + `mail` | Setup Stalwart depuis zéro |
|
|
| Audit perf full-stack | `optimizer-backend` + `optimizer-db` + `optimizer-frontend` | Riri Fifi Loulou |
|
|
| Audit perf backend | `optimizer-backend` + `optimizer-db` | API + DB — sans toucher au frontend |
|
|
| Validation avant prod | `code-review` + `ci-cd` | Review code + pipeline avant déploiement |
|
|
| Nouveau projet complet | `vps` + `ci-cd` | Déploiement serveur + pipeline CI/CD |
|
|
| Problème non identifié | `orchestrator` → agents détectés | Diagnostic + délégation automatique |
|
|
| Audit système d'agents | `agent-review` → `recruiter` | Review + détection gaps → forge si besoin |
|
|
| Exploration / décision archi | `brainstorm` → `recruiter` ou agent métier | Explorer + challenger → construire |
|
|
| Question hors-scope en session | `aside` | /btw → 2-3 lignes → retour session |
|
|
| Coordination multi-instances | `orchestrator-scribe` | Signals BSI + cycles coworking inter-brains |
|
|
| Session dual-agent supervisée | `supervisor` + `session-orchestrator` + `orchestrator-scribe` | Planification scopes → exécution → CHECKPOINT → escalade humain |
|
|
| Fin de session complète | `session-orchestrator` → `metabolism-scribe` + `scribe` + `coach` | Séquence close : métriques → brain → rapport coach → BSI |
|
|
| Feature livrée en prod | `git-analyst` + `capital-scribe` | Commits synthétisés + capital CV mis à jour |
|
|
| Projet multi-langue | `i18n` + `frontend-stack` | Audit traductions + intégration lib |
|
|
| Release / PR importante | `doc` + `code-review` | Doc à jour + code validé |
|
|
| Fin de session content-worthy | `content-orchestrator` → `storyteller` + `content-scribe` | Signal détecté → draft produit → persisté |
|
|
| Sprint multi-agents complet | `context-broker` inhale → `tech-lead` → `orchestrator` → build agents → `integrator` → `context-broker` expire | Cycle respiratoire complet : source map → gate → build → merge → release map + breath metrics |
|
|
| Débordement de zone requis | agent demandeur → `tech-lead` | Overflow request validé par use case concret avant écriture hors zone |
|
|
| Activation content-logs | `content-orchestrator` → `content-scribe` | Session capturée exhaustivement |
|
|
| Audit complet avant prod | `security` + `code-review` + `testing` | Validation complète feature sensible |
|
|
| Bug prod complexe | `debug` + `vps` | Isolation + infra |
|
|
| Refacto sécurisée | `refacto` + `testing` + `code-review` | Tests avant, refacto, review après |
|
|
| Incident prod | `monitoring` + `vps` + `debug` | Alerte → diagnostic infra → debug applicatif |
|
|
| Nouveau déploiement | `ci-cd` + `monitoring` | Pipeline + sondes de surveillance |
|
|
| Dream team perf | `orchestrator` → `optimizer-*` | Audit perf full-stack via orchestrateur |
|