1@README.md
2
3- These are digests, not sources. When one disagrees with the emulator or the
4  game, the digest is wrong: fix it here, with the measurement, in the same
5  commit as the code that found it.
6- Addresses are written as SNES bus addresses (`$7Exxxx`/`$7Fxxxx`). Mesen's
7  `emu.memType.snesWorkRam` takes the WRAM OFFSET instead: subtract `$7E0000`
8  (`$7FDF80` → `0x1DF80`). SRAM-mirror addresses `$7EF000+` are WRAM, not
9  cartridge SRAM — read them as `snesWorkRam` too.
10- `alttp-ram-map.md` ends with an open-items list. Resolve an item by
11  measuring it in the running game, then move it out of that list.
12- The notes are files, not chapters: only this folder's README and
13  `fixtures/` are in the guide's chain. A new note gets a row in the
14  README's table.
15- The reference clones the notes cite live under `~/src/github.com/<owner>/<repo>`
16  (`SourMesen/Mesen2`, `snesrev/zelda3`, `spannerisms/usdasm`,
17  `spannerisms/jpdasm`, `JaredBrian/AsarUSALTTPDisassembly`,
18  `walkingeyerobot/alttp-disassembly`, `DioxusLabs/dioxus`,
19  `zbanks/alttp`). Read-only research: never push, star, fork or file
20  anything against them.
21- **Some notes name code that no longer exists**: `breaker-trip-2026-09-20.md`
22  and the two castle notes predate the Rust brain's removal on 2026-09-21
23  (`packages/brain`, `apps/walkcheck`); `zbanks-alttp.md` still says
24  `packages/zbanks-jev` where the code is now `packages/decisions`. The
25  findings about the game hold; do not follow their code pointers.