Files
le-mystere-professeur-zacus/docs/architecture/agent-matrix.md
T
L'électron rare 20aed903ba feat: AI integration — voice pipeline, hints engine, MCP server, analytics, security
- Voice pipeline: ESP32 WebSocket client → voice bridge → LLM → Piper TTS (Tower :8001)
- Hints engine: 3 puzzles (LA_440, LEFOU_PIANO, QR_FINALE), anti-cheat, 3 hint levels
- MCP hardware server: 6 tools (puzzle, audio, LED, camera, scenario, status), stdio transport
- Analytics: ESP32 module + 6 web endpoints + Dashboard UI with chat interface
- Security: auth middleware (Bearer NVS), rate limiting, input validation on 30 endpoints
- Frontend: code-split (1.1MB → 210KB initial), ErrorBoundary, API timeout, WS reconnect
- Tests: 24 Python + 38 TypeScript + 18 MCP = 80 project tests (+ 19 mascarade)
- Specs: AI_INTEGRATION_SPEC, MCP_HARDWARE_SERVER_SPEC, QA_TEST_MATRIX_SPEC
- Docs: SECURITY, DEPLOYMENT_RUNBOOK, voice pipeline guide, AI architecture map
- 6 AI agent definitions (.github/agents/ai_*.md)
- TUI orchestration script (tools/dev/zacus_tui.py)
- Docker compose TTS for Tower + KXKM-AI
- CHANGELOG, README, mkdocs.yml updated
- Cycle detection (DFS) in runtime3 validator
- Sprint plan: plans/SPRINT_AI_INTEGRATION.md

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-22 13:52:45 +01:00

1.3 KiB

Agent Matrix

Agent Scope Inputs Outputs
PM / Architecture Global audit, sequencing, dependency map repo state, plans, docs plans/master-plan.md, architecture maps
Runtime / Compiler Runtime 3 schema, compiler, simulator YAML scenarios, runtime spec IR JSON, simulator traces, migration rules
Frontend Studio React + Blockly authoring studio Runtime 3 contract, API contract Studio UI, previews, lint/build gates
Firmware Adapter Runtime execution on device IR JSON, firmware APIs buildable firmware, runtime adapter
Content / Narrative Scenario migration and feature cards YAML canon, audio/printables manifests consistent scenario graph, content backlog
Tooling / TUI / Logs CLI/TUI wrappers and evidence scripts, CI, artifact dirs tools/dev/zacus.sh, validation entrypoints
Docs / Knowledge Specs, Mermaid maps, READMEs all workstreams updated docs, MkDocs site
QA / Release Gates, proofs, release readiness builds, logs, simulations validation matrix, release checklist

Coordination Rule

  • memory/project-memory.md stores cross-wave context.
  • plans/agents/*.md store agent-specific execution plans.
  • todos/*.md store the next concrete chain of work.