4.4 KiB
4.4 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.
Mode économe (par défaut)
Objectif : préserver les tokens de l'utilisateur. Le jugement visuel et les tests en jeu, c'est lui qui les fait.
- Une session par fonctionnalité. Le contexte utile est dans ce fichier, dans le README et dans la note du projet : ne pas relire tout le code, seulement les fichiers concernés.
- Vérification de ma part : uniquement
npx tsc --noEmit && npx vitest run(typage + tests, sans build :dist/ne peut pas être vidé depuis la VM, et l'utilisateur teste avecnpm run dev). Pas devite build, pas denpm run smoke, pas de captures d'écran, pas de navigateur, sauf demande explicite de l'utilisateur. Le build complet (npm run check), c'est l'utilisateur qui le lance au besoin. - Après chaque modification, dire précisément quoi tester en jeu (scène, action, résultat attendu). L'utilisateur teste avec
npm run devsur sa machine et remonte les problèmes, avec une capture si besoin. - Pas d'envoi de build
dist/: l'utilisateur lancenpm run devlui-même. - Modifications ciblées (Edit,
sed, petits scripts) plutôt que la réécriture de fichiers entiers ; lire seulement les portions utiles des gros fichiers (bureau.ts,ThreeRenderer.ts). - Réponses courtes. La note du projet n'est mise à jour que si une décision change.
- Commit uniquement sur demande explicite de l'utilisateur, une fois qu'il a testé et avant de passer à la suite. Ne jamais commiter de soi-même à la fin d'une modification, même si typage et tests sont verts. Push : c'est l'utilisateur qui le fait (le SSH sortant est bloqué depuis la VM).
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.
- Performance : tout est préparé au chargement par
ThreeRenderer.warmUp()(shaders, textures, géométries). Une lumière pilotée par les props s'éteint (intensité 0) au lieu d'être masquée, car changer le nombre de lumières recompile tous les shaders. Le smoke test échoue si un shader ou une texture est préparé en cours de partie.