2.5 KiB
2.5 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.
Versionnage Git (règle n° 1)
Le dépôt de référence est le dossier de l'utilisateur (D:\Code\claude\escape_game, branche main, remote origin en SSH).
- Avant toute modification, lancer
git status:- si l'arbre est propre, on commence ;
- si des changements sont en cours et que la demande est un fix ou un ajustement de la fonctionnalité ou du bug en cours, on continue sur ces changements ;
- sinon, on ne commence pas : on signale les changements en cours et on demande de les versionner (commit) ou de les abandonner.
- Une modification = un commit, avec un message en français au format
type: résumé. Types :feat,fix,perf,refactor,test,docs,chore. - Avant de commiter :
npm run checkdoit être vert, etnpm run smokeaussi si la 3D, le rendu ou l'UI ont changé. - Essais risqués : sur une branche dédiée
essai/<nom>, pour revenir facilement en arrière. - Interdit sans accord explicite :
git push, ainsi que toute réécriture d'historique (reset --hard,rebase,push --force). dist/n'est pas versionné : il se régénère avecnpm run build.
Vérifier une modification (du plus rapide au plus lent)
npm run check(~5 s) : typage, tests de logique, build. À lancer après chaque modification.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.- Captures ciblées :
npm run smoke -- --shots, puis regarder seulement les vues concernées danstests/shots/.
Règles
- Ne jamais rejouer une partie à la main avec des scripts ad hoc : passer par
walkthrough.jsonettests/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.jsondans 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 danstests/smoke.cjs. - Le jugement visuel final (lumière, ombres, fluidité) revient à l'utilisateur, sur sa machine.