escape_game/CLAUDE.md

1.3 KiB

Consignes pour Claude : projet Escape Game

Escape game point & click 3D (three.js, caméras fixes), piloté par src/scenarios/<chapitre>/scenario.json. Voir le README pour le format.

Vérifier une modification (du plus rapide au plus lent)

  1. npm run check (~5 s) : typage, tests de logique, build. À lancer après chaque modification.
  2. npm run smoke (~1 min) : la solution de référence rejouée avec de vrais clics 3D. À lancer seulement si la modification touche le monde 3D (src/worlds/), le rendu, les caméras ou l'UI.
  3. Captures ciblées : npm run smoke -- --shots, puis regarder seulement les vues concernées dans tests/shots/.

Règles

  • Ne jamais rejouer une partie à la main avec des scripts ad hoc : passer par walkthrough.json et tests/smoke.cjs.
  • En environnement sans GPU, toujours utiliser ?test=1 (pas d'animation, basse qualité). Le rendu 3D est très lent en logiciel.
  • Délais d'attente courts (smoke : 20 s par action) : un test bloqué est un test en échec.
  • Si l'enchaînement des énigmes change, mettre à jour walkthrough.json dans le même changement.
  • Un nouveau type de mini-jeu doit avoir un contrôle dans tests/scenarios.test.ts (checkPuzzle) et une résolution dans tests/smoke.cjs.
  • Le jugement visuel final (lumière, ombres, fluidité) revient à l'utilisateur, sur sa machine.