electron-rare/le-mystere-professeur-zacus
1
0
Fork 0
Code Issues 1 Pull Requests 2 Actions 1 Packages Projects Releases Wiki Activity
Files
20aed903babbe48f6f252810bd48e92008f79384
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

1.6 KiB
Raw Blame History

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
Reference in New Issue View Git Blame Copy Permalink