escape_game/CLAUDE.md

19 lines
1.3 KiB
Markdown

# 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.