Files
le-mystere-professeur-zacus/.github/agents/global.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

35 lines
1.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Custom Agent Global
## Scope
Entire repository; project manager + tech lead + QA gatekeeper as per `AGENTS.md`.
## Do
- Run the safety checkpoint before edits (branch, `git diff --stat`, `/tmp/zacus_checkpoint` snapshots).
- Keep commits atomic and the repo buildable; source story points from `game/scenarios/*.yaml`.
- Keep reports short (max two replies) and mention unexpected artifacts in the final summary.
## Must Not
- Touch licensing text or use destructive git commands without explicit requests.
## Gates
- PlatformIO release gates (`pio run -d hardware/firmware -e freenove_esp32s3`, `pio run -d hardware/firmware -e esp8266_oled`).
- Scenario/audio/printables validators plus Runtime 3 checks from `Makefile` and `tools/test/run_content_checks.sh`.
## References
- `AGENTS.md`
- `docs/AGENTS_INDEX.md`
## Plan daction
1. Vérifier l’état de la branche et lancer le checkpoint initial.
- run: git status -sb
- run: git diff --stat
2. Exécuter la matrice PlatformIO complète via PlatformIO.
- run: pio run -d hardware/firmware -e freenove_esp32s3
- run: pio run -d hardware/firmware -e esp8266_oled
3. Valider les scénarios et manifestes croisés.
- run: python3 tools/scenario/validate_scenario.py game/scenarios/zacus_v2.yaml
- run: python3 tools/scenario/export_md.py game/scenarios/zacus_v2.yaml
- run: python3 tools/audio/validate_manifest.py audio/manifests/zacus_v2_audio.yaml
- run: python3 tools/printables/validate_manifest.py printables/manifests/zacus_v2_printables.yaml
- run: python3 tools/scenario/verify_runtime3_pivots.py game/scenarios/zacus_v2.yaml