feat(template): 17 agents manquants — couverture complète kernel v1.0

brain-hypervisor, workflow-auditor, feature-gate, kernel-orchestrator, ux-architect, pattern-scribe, decision-scribe, diagram-scribe, infra-scribe, pre-flight, scriptwriter, key-guardian, brain-ui-scribe, content-strategist, bact-scribe, seo-youtube, secrets-injector Dépersonnalisation : diagram-scribe, infra-scribe, key-guardian, brain-ui-scribe
2026-03-18 22:39:40 +01:00
parent 8c95b70314
commit 0d2ac03d8e
17 changed files with 3139 additions and 0 deletions
--- a/agents/brain-ui-scribe.md
+++ b/agents/brain-ui-scribe.md
@@ -0,0 +1,150 @@
+---
+name: brain-ui-scribe
+type: agent
+context_tier: warm
+status: active
+brain:
+  version:   1
+  type:      scribe
+  scope:     project
+  owner:     human
+  writer:    coach
+  lifecycle: permanent
+  read:      trigger
+  triggers:  [brain-ui, dashboard, react-flow, workflow-board, secrets-zone, infra-view, sprint-ui]
+  export:    false
+  ipc:
+    receives_from: [orchestrator, human]
+    sends_to:      [orchestrator]
+    zone_access:   [project]
+    signals:       [SPAWN, RETURN, ESCALATE]
+---
+
+# Agent : brain-ui-scribe
+
+> Dernière validation : 2026-03-17
+> Domaine : Contexte technique + produit brain-ui — injecté dans tout agent travaillant sur l'interface
+> **Type :** Scribe — chargé avant tout agent qui touche brain-ui
+
+---
+
+## boot-summary
+
+Donne le contexte précis de brain-ui à tout agent qui doit travailler dessus.
+Sans ce scribe, les agents re-découvrent l'architecture à chaque session.
+
+---
+
+## État actuel (2026-03-18)
+
+### Déploiement
+- **URL** : https://brain.<OWNER_DOMAIN>/ui/ (Basic Auth actif)
+- **Repo** : git.l'owner.com:Tetardtek/brain-ui.git
+- **VPS** : /home/l'owner/gitea/brain-ui/ → dist/ servi par Apache
+- **Local** : `npm run dev` → localhost:5173
+
+### Stack
+- React 18 + Vite + TypeScript + Tailwind
+- React Flow (reactflow ^11) — WorkflowBoard
+- **Three.js + @react-three/fiber + @react-three/drei** — Cosmos 3D live
+- **Zustand ^5** — state management installé
+- lucide-react — icônes
+- base Vite : `/ui/` (obligatoire — path VPS)
+
+### Composants existants
+| Composant | Statut | Notes |
+|-----------|--------|-------|
+| `WorkflowBoard` | ⚠️ partiel | ReactFlow, gates visuelles, `onGateApprove` = console.log |
+| `WorkflowBuilder` | ✅ présent | Builder de workflows |
+| `StepNode` | ✅ complet | Losange gate + rect step, couleurs statuts |
+| `SecretsZone` | ✅ complet | Eye/EyeOff, génération auto, feedback post-save |
+| `GatesDrawer` + `GateDrawer` | ✅ présent | Overlay gate approve/reject |
+| `CommandPalette` | ✅ présent | Accès rapide actions |
+| `LogDrawer` | ✅ présent | Logs pm2 |
+| `InfraRegistry` | ✅ présent | Vue Infra — plus vide |
+| `ToastProvider` | ✅ présent | Alertes et notifications |
+| `TeamSelector` | ✅ présent | Sélection équipe |
+| `TierGate` | ✅ présent | Enforcement tier feature |
+| `cosmos/` | ✅ live | CosmosView, CosmosScene, CosmosBackground, CosmosControls, CosmosInfoPanel, CosmosMetrics, CosmosPoints, GateOctahedron, StepSphere, WorkflowConstellation — nébuleuse 3D avec autoRotate |
+| `workspace/` | ✅ présent | WorkspaceView, WorkspaceInfoPanel, WorkspaceMetrics |
+
+### Hooks existants
+| Hook | Rôle |
+|------|------|
+| `useWebSocket` | Real-time events workflow — WebSocket natif ✅ |
+| `useWorkflows` | Liste workflows + statuts |
+| `useCosmosData` | Data pour la vue Cosmos |
+| `useInfra` | Statut services infra |
+| `useLogs` | Streaming logs pm2 |
+| `useTeams` | Sélection équipe |
+| `useTier` | Enforcement tier |
+| `useWorkspaceData` | Data workspace |
+
+### Ce qui reste à faire
+- `onGateApprove` → toujours console.log — pas branché sur API
+- Kernel heartbeat → à vérifier si live ou encore statique
+- `StatusDot` — indicateur pulsant live → non créé
+
+---
+
+## Architecture cible (Sprint 3+)
+
+### API locale (backend brain)
+```
+GET  /workflows              → liste workflows + statuts
+POST /gate/:wfId/:stepId/approve|reject
+GET  /logs/:project          → logs pm2 (polling 2s)
+GET  /health                 → statut services (pm2, MySQL, Apache)
+```
+
+### Prochaines priorités
+1. Brancher `onGateApprove` sur l'API gate réelle
+2. `StatusDot` — indicateur pulsant live kernel/services
+3. Cosmos heatmap mode nébuleuse → déjà livré ✅
+
+---
+
+## Références design
+- Netdata — status indicators pulsants + densité info
+- Vercel Dashboard — workflow steps + log viewer inline
+- Grafana — command palette + alert banners
+
+---
+
+## Règles pour les agents qui travaillent sur brain-ui
+
+```
+- base Vite = '/ui/' — ne jamais changer
+- Tailwind uniquement — pas de CSS inline sauf React Flow overrides
+- Tokens brain-* dans tailwind.config.js — utiliser ces tokens, pas des hex orphelins
+- nodeTypes React Flow défini HORS du composant (référence stable)
+- WorkflowBoard doit toujours accepter workflows: Workflow[] en prop
+- Jamais de logique métier dans les composants UI — dans les hooks
+- VITE_USE_MOCK=true en dev, false en prod
+```
+
+---
+
+## Sources à lire pour contexte complet
+- `content/brain-ui/product-audit.md` — leviers + monitoring
+- `content/brain-ui/design-system.md` — tokens + composants inventaire
+- `content/brain-ui/sprint2-specs.md` — API + state + plan migration
+
+---
+
+## Invocation
+
+```
+brain-ui-scribe, donne le contexte complet avant de travailler sur brain-ui
+brain-ui-scribe, qu'est-ce qui est branché vs mock dans l'UI actuelle ?
+brain-ui-scribe, quelles dépendances sont déjà installées ?
+```
+
+---
+
+## Changelog
+
+| Date | Changement |
+|------|------------|
+| 2026-03-17 | Création — contexte brain-ui injecté avant tout agent UI |
+| 2026-03-18 | État mis à jour — Sprint 2 livré (cosmos 3D, WebSocket, GatesDrawer, CommandPalette, InfraRegistry, 8 hooks, zustand) — review audit guidé Batch B |