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>
2.7 KiB
2.7 KiB
Copilot Agent Index
Every .github/agents/*.md file is a focused briefing for Copilot/GUIs; chaque fiche inclut une section ## Plan d’action basée sur .github/agents/PLAN_TEMPLATE.md. Open the one matching your domain before editing. The table below summarizes each card.
| Agent file | Résumé rapide |
|---|---|
global.md |
Règles repo-wide (checkpoint, story points, PlatformIO/scénarios/audios/printables gate list). |
hardware.md |
Enclosure/BOM/wiring + validation via hardware/firmware builds and smoke gate scripts. |
audio.md |
Manifestes audio : validator + scenario export, pas de régénération binaire. |
game.md |
YAML scénarios/prompts; valider/exporter avec les scripts tools/scenario. |
printables.md |
Manifestes printables : validator PB, naming déterministe. |
tools.md |
Scripts/tools : --help, flags/timeout configurables, pas de paths machine. |
docs.md |
Docs/onboarding : updates concises, liens valides, structure préservée. |
kit.md |
GM kit station/export, lien jeu/printables, pas de renommage sans synchro. |
ci.md |
Workflows/templates : edits minimaux, CI impact reporté. |
firmware_core.md |
Firmware tree complet : PlatformIO builds, hardware/firmware/docs/AGENT_TODO.md, logs/artifacts hors git. |
firmware_tooling.md |
tools/dev/ helpers : --help, grep-friendly logs, ports/timeouts configurables. |
firmware_copilot.md |
Copilot-specific firmware duties (UI Link, LittleFS, I2S, artefact tracking, sprint/runbook refs). |
firmware_tests.md |
Smoke/stress scripts + artifact metadata (meta.json, commands.txt, summary.md) et reporting. |
firmware_docs.md |
Firmware docs/onboarding updates, command index regen, runbook mentions. |
ai_voice.md |
ESP-SR wake word + commandes vocales françaises, pipeline I2S → WakeNet → MultiNet → mascarade. |
ai_tts.md |
TTS serveur (Coqui XTTS-v2 / Piper), clonage voix Professeur Zacus, streaming audio ESP32. |
ai_vision.md |
Détection objets on-device (ESP-DL / ESPDet-Pico), comptage joueurs, reconnaissance props. |
ai_hints.md |
Indices adaptatifs LLM, personnalité NPC Professeur Zacus, anti-triche, analytics. |
ai_audio_gen.md |
Musique ambiante générative (AudioCraft MusicGen), SFX, soundscapes par salle. |
ai_mcp.md |
Serveur MCP hardware : bridge LLM → ESP32 via JSON-RPC 2.0, discovery, auth. |
ALIGNMENT_COMPLETE.md |
Checklist de pré-lancement : AGENT contracts, runbooks, onboarding, artefacts. |
PHASE_LAUNCH_PLAN.md |
Checkpoint de lancement de phase : gates, artefacts, reporting RC/AGENT_TODO. |
Pour chaque fiche, consulte la section “References” pour pointer vers le contrat AGENTS*.md correspondant et les runbooks à mettre à jour.