docs(workflow): align CLAUDE.md + memory + roadmap with named-retail foundation
CLAUDE.md edits (6 surgical ranges):
- Goal section: introduce named-retail/ as primary; old chunks
remain as fallback for chunk-by-chunk address-range navigation.
- Workflow renamed to "grep named -> decompile -> verify -> port"
with a new STEP 0 GREP NAMED FIRST. Decompile demoted to a
fallback (Step 1) for the rare obfuscated/packed minority that
pseudo-C lacks.
- Function-map citation updated to point at symbols.json + the
cross-port hand-curated table.
- "Do not guess" rule strengthened: PDB has the answer for almost
everything; guessing is now negligence.
- Phase completion checklist accepts named symbols + addresses.
- Reference hierarchy table gets a new top row pointing at
docs/research/named-retail/ as the primary oracle for any
AC-specific algorithm — beats every other reference.
memory/project_named_decompilation.md (new): evergreen crib-sheet
with file inventory, grep examples, hard rules. Pattern matches
project_ui_architecture.md.
memory/project_retail_research_index.md: updated preamble to point
named-retail/ as first stop; older slices remain useful for
pseudocode + C# port sketches.
memory/project_collision_port.md: rewrote the "Decompiled ground
truth" section to put named-retail/ first, chunks second. The
"DECOMPILE FIRST" mandate becomes "GREP NAMED FIRST, then DECOMPILE
FALLBACK".
docs/architecture/acdream-architecture.md: Guiding Principle text
updated to introduce named-retail as the primary decomp source.
docs/plans/2026-04-11-roadmap.md: new Phase R block — Retail
research infrastructure. R.1 (corpus, shipped a9a01d8), R.2
(pdb-extract, shipped 69d884a), R.3 (actestclient vendored,
shipped a9a01d8). All marked SHIPPED 2026-04-25.
Auto-loaded MEMORY.md index updated with a new entry pointing at
project_named_decompilation.md so post-compaction sessions inherit
the workflow change automatically.
Acceptance verified:
- grep -c "named-retail" CLAUDE.md = 9 (>= 3 required)
- grep -c "named-retail" MEMORY.md = 1
- dotnet build green (docs-only commit, but verified)
Foundation phases A + B + C all landed. Next: Phase D files
ISSUES #8/#9/#11 + closes #10 (KillerNotification orphan parser).
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
parent
69d884a3d6
commit
0a429a980c
6 changed files with 192 additions and 23 deletions
|
|
@ -223,6 +223,41 @@ Not detailed here; each gets its own brainstorm when it becomes relevant.
|
|||
|
||||
---
|
||||
|
||||
### Phase R — Retail research infrastructure
|
||||
|
||||
**Goal:** sustainable, scalable access to retail-client decompilation —
|
||||
named symbols, struct layouts, wire schemas — so every future port is
|
||||
a 5-second grep instead of 30-minute archaeology.
|
||||
|
||||
**Sub-pieces:**
|
||||
|
||||
- **✓ SHIPPED — R.1 — Named-retail corpus committed.** Shipped 2026-04-25
|
||||
(commit `a9a01d8`). `docs/research/named-retail/{acclient_2013_pseudo_c.txt,
|
||||
acclient.h, acclient.c}` + `docs/research/data/spells.csv` + vendored
|
||||
`references/actestclient/`. 1.4 M lines of named pseudo-C (99.6% function
|
||||
naming) + 70K lines of verbatim retail headers + 3,956 spells with `Family`
|
||||
for buff stacking + machine-readable wire schema in `messages.xml`.
|
||||
- **✓ SHIPPED — R.2 — pdb-extract tool + JSON sidecars.** Shipped 2026-04-25
|
||||
(commit `69d884a`). `tools/pdb-extract/pdb_extract.py` reads
|
||||
`refs/acclient.pdb` (Sept 2013 EoR build) and emits `symbols.json`
|
||||
(18,366 named functions) + `types.json` (5,371 named struct types) to
|
||||
`docs/research/named-retail/`. Pure Python, no deps, runs in <1 s.
|
||||
- **✓ SHIPPED — R.3 — actestclient vendored.** Shipped 2026-04-25 alongside
|
||||
R.1. `references/actestclient/` (covered by `references/` gitignore)
|
||||
includes the canonical `messages.xml` AC-protocol wire schema.
|
||||
|
||||
**Acceptance:** Step 0 of `CLAUDE.md`'s development workflow points at
|
||||
`named-retail/` first; subsequent issue closures (#6 / #7 / #9 / #11)
|
||||
all consume this foundation.
|
||||
|
||||
**Effects on other phases:** Issue closures unblocked by Phase R land
|
||||
under their existing letter phases (#6 enchantment buffs → Phase D /
|
||||
F.5 maintenance; #7 PlayerDescription trailer → Phase H.1 / F.2
|
||||
maintenance). The PDB symbols + headers also accelerate any future
|
||||
port in any phase — no separate listing here.
|
||||
|
||||
---
|
||||
|
||||
## Cross-cutting work tracked in parallel
|
||||
|
||||
- **Test coverage.** Each phase lands with unit + integration tests in `tests/`. Current count: 98 Core + 96 Core.Net = 194. Keep the ratio as new phases land.
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue