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>
35 lines
1.6 KiB
Markdown
35 lines
1.6 KiB
Markdown
# 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 d’action
|
||
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
|