Read AGENTS.md first — it is the canonical continuation guide for this
project (architecture map, hard rules, sharp edges, quality bar). This file
only adds the Claude-specific workflow notes.
- The user tests in their own browser and reports back with screenshots —
do not browser-test unless explicitly asked. Hand over files that pass:
node --checkon every.jsfile (game + dev scripts)node validate.js
- Fold all work into the existing single root commit:
git add -A && git commit --amend --no-edit. Never push — the user force-pushes themselves after a history rewrite. - Use the Edit/Write tooling for source changes. Avoid PowerShell
Set-Contentround-trips on source files — they have mangled UTF-8 punctuation in comments before (grep forâif you must). - When picking coordinates out of downloaded sprite sheets, verify them by rendering labeled contact-sheet crops (System.Drawing works on this machine) and re-pick anything that lands wrong — do not ship guessed source rects.
- Keep
README.md(including its "single-shot prompt" section) andAGENTS.mdin sync with behavior changes — the user treats README drift as a bug.
| Task | Start in |
|---|---|
| Gameplay/balance data | js/data/{species,moves,items,maps}.js |
| Battle behavior | js/battle.js |
| Movement/NPC/interaction | js/overworld.js |
| Menus/dialog/input | js/ui.js |
| Image assets & renderer glue | js/data/assets.js + download scripts |
| Mobile/scaling/PWA | js/main.js + css/style.css + index.html head |