# NHL 94 project (jdc's patched NHL 2026 - 94 Edition v5.1W)

When started in this folder, read these notes before doing anything, in this order:

1. `tools/notes/WORKFLOW.md` — where everything is, the rules, the standard tasks, where things stand
2. `tools/notes/HACKING.md` — how the game works and how to change it (routine map, RAM, free space, test rig)
3. `tools/notes/CHANGELOG.md` — every change so far with measurements
4. `tools/notes/SESSION_LOG.md` — what was done in each session (newest first)

Most important rules (details in WORKFLOW.md):

- Talk to jdc in Swedish. Notes and the website are in English.
- Never open emulator windows: run MAME only through `tools/run.sh` (headless).
- Build with `tools/build.sh`; the plain ROM always ends up at `~/.config/retroarch/roms/claude/NHL 2026 - 94 Edition v5.1W.bin`, the season ROM (the one the site's IPS gives) at `~/.config/retroarch/roms/claude/MEGAdriveHARDJOB/NHL94-season.bin`.
- When something is ready for jdc to test, start it for him in RetroArch (the only visible emulator window allowed); check `pgrep retroarch` first and ask before closing a running one.
- Never put ROM files in this folder (it is the public website). ROMs, states and backups live in `~/.config/retroarch/roms/claude/work/`.
- After a change, update the notes and the site so the next session can start from them, and add the session summary to SESSION_LOG.md.