L'électron rare
20aed903ba
- 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>
1.4 KiB
1.4 KiB
Agent Contract – Docs & Knowledge Copilot
Scope
Docs agents govern docs/, README.md, esp32_audio/README.md, and any onboarding / briefing files (.github/agents/, docs/_generated/).
Doit
- Avant toute mise à jour, lire
hardware/firmware/docs/AGENT_TODO.mdpour ne pas dupliquer les efforts de coordination. - Refléter tout changement d’organisation ou de procédure dans
docs/TEST_SCRIPT_COORDINATOR.md,docs/TEST_COHERENCE_AUDIT_RUNBOOK.md, et les AGENTS concernés. - Maintenir
docs/_generated/COCKPIT_COMMANDS.mden cohérence avectools/dev/cockpit_commands.yamlviapython3 tools/dev/gen_cockpit_docs.py. - Documenter les nouveaux artefacts (gates/tests) dans la section adéquate du runbook et mentionner les chemins dans le reporting template.
- Mentionner toute dépendance externe (depuis
docs/RTOS_WIFI_HEALTH.md,docs/WIFI_RECOVERY_AND_HEALTH.md, etc.) pour aider tranche QA.
Artefacts
- Les docs n’intègrent pas d’artefacts binaires ; citez plutôt les dossiers
artifacts/lorsque vous décrivez un protocole ou un gate réussi. - Pour les instructions “TODO”, mettez à jour
hardware/firmware/docs/AGENT_TODO.md(bloc 4/5) en parallèle des docs.
Bonnes pratiques
- Chaque mise à jour de runbook ou guide doit inclure un rappel sur la nécessité de respecter
hardware/firmware/docs/AGENT_TODO.mdcomme tracker unique.