Consolidate documentation into architecture and merged guides

TODO.md

@@ -62,7 +62,7 @@ the rest of §C remains the broad review checklist.
       and the non-Blender failure path. Verify one assembled prototype with `audit`/`fit`/`inspect`
       before touching production variants.
 - [x] Consider optional Blender MCP for interactive part exploration and document setup/safety.
-      (`docs/blender-mcp.md` covers addon/client setup, Pi `pi mcp add`, flatpak networking,
+      (`docs/asset-tooling.md#optional-interactive-blender-mcp` covers addon/client setup, Pi `pi mcp add`, flatpak networking,
       viewport/`bpy` workflow and the rule that headless audit/fit remains authoritative; MCP is
       not a build/CI/runtime dependency.)
 - [ ] Document the commands, working-set paths and “part source is not a shipped asset” rule in
@@ -259,9 +259,9 @@ licence-free zone only.
       (`elcapitan`, `hollywood-block`, `jimmy-kimmel-stage`, `jimmy-kimmel-entrance`,
       `comedy-store`).
 - [x] Record which local frames changed a decision: added the frame→decision mapping to
-      `docs/hollywood-boulevard-map.md` (recent `elcapitan-2026` geosearch → 2009 frame stays the
+      `docs/venues.md#hollywood-boulevard` (recent `elcapitan-2026` geosearch → 2009 frame stays the
       geometry reference; `jimmy-kimmel-entrance/07.jpg` → the four entrance concepts) and
-      `docs/joke-shop-map.md` (`comedy-store/` → the four concept pairs + map plan;
+      `docs/venues.md#the-joke-shop` (`comedy-store/` → the four concept pairs + map plan;
       `comedy-store-hillside/` → the day-concept anchor that clears the image-recitation filter).
       Frames stay gitignored; only the provenance notes are committed.
 
@@ -434,8 +434,8 @@ licence-free zone only.
       `tools/three_up.py compose` renders labelled strips into `docs/screens/boards/` (caption
       sidecar per board, `rows` emits README rows). Boards committed: El Capitan day, El Capitan
       night, Joke Shop day. Tests in `tools/test_three_up.py`.
-- [x] Link each committed board from `docs/hollywood-boulevard-map.md` and
-      `docs/joke-shop-map.md`.
+- [x] Link each committed board from `docs/venues.md#hollywood-boulevard` and
+      `docs/venues.md#the-joke-shop`.
 - [ ] Use the generated concept lighting and palette as the target for the `lighting`/`lookdev`
       pass, and record the deviations that stay accepted.
 - [ ] After the pass, regenerate the venue captures and update README plus both venue documents.
@@ -463,10 +463,10 @@ and never ship a generated or downloaded image without provenance.
       log and the generated-board reference table. Linked from `docs/screens/README.md`.)
 - [x] Hollywood board: five licence-cleared photos (facade day, blade sign, 1922 elevation,
       Ovation across street, premiere staging) with a sidecar and per-image purpose, linked from
-      `docs/hollywood-boulevard-map.md` and credited in `CREDITS.md`. Cropped the foreground crowd
+      `docs/venues.md#hollywood-boulevard` and credited in `CREDITS.md`. Cropped the foreground crowd
       out of the facade shot; EXIF stripped. (`docs/screens/refs/hollywood/`.)
 - [x] Joke Shop board: three licence-cleared photos (hillside/canopy block, frontage with palms,
-      canopy signature band) with a sidecar, linked from `docs/joke-shop-map.md` and credited in
+      canopy signature band) with a sidecar, linked from `docs/venues.md#the-joke-shop` and credited in
       `CREDITS.md`. The CC BY-SA `The Comedy Store.jpg` from the old link list was deliberately not
       used; the public-domain frames cover the same evidence. (`docs/screens/refs/joke-shop/`.)
       **Removed 2026-11-03:** the committed Comedy Store photo board was replaced by the local-only
@@ -474,7 +474,7 @@ and never ship a generated or downloaded image without provenance.
 - [x] TV Studio: no separate board — the venue is the same El Capitan Entertainment Centre block as
       the Hollywood day shift, restaged for a late-night arrival. The Hollywood board covers both
       venues and the premiere-staging photo is the arrival evidence; the reuse is now stated in
-      `docs/hollywood-boulevard-map.md`, `docs/gameplay.md`, `PLAN.md` and
+      `docs/venues.md#hollywood-boulevard`, `docs/gameplay.md`, `PLAN.md` and
       `docs/development-status.md`.
 - [x] Fill the Hollywood gaps that have a clean licence: El Capitan Theatre neighbour and marquee,
       Walk of Fame terrazzo band, star close-up, and a night street-lighting context frame (cropped
@@ -543,7 +543,7 @@ still apply; the map pipeline has its own exit in M.
 - [x] ODbL audit: OpenStreetMap is used as **reference only** (hand-built geometry informed by
       OSM ways + Commons photos), so the shipped geometry is not an ODbL derived database and no
       share-alike obligation attaches. Attribution is still kept via the OSM way links in
-      `docs/hollywood-boulevard-map.md` / `docs/joke-shop-map.md`. If derived OSM geometry ever
+      `docs/venues.md#hollywood-boulevard` / `docs/venues.md#the-joke-shop`. If derived OSM geometry ever
       ships, it needs the attribution + share-alike review in a separate ADR.
 - [x] OSM extract workflow: no offline extract is required while OSM is reference-only. If the
       pipeline later imports footprints, pin an Overpass query + extract date and record it in a
@@ -642,13 +642,13 @@ Nothing is committed until the licence gate on any promoted reference and the ma
 pass. The current `_build_comedy_store_building()` stays as the fallback.*
 
 - [x] Extract the real proportions and reconcile: vision-read `tmp/research/comedy-store/` frames
-      via `tools/describe_image.py` and recorded the reconciled table in `docs/joke-shop-map.md`
+      via `tools/describe_image.py` and recorded the reconciled table in `docs/venues.md#the-joke-shop`
       §Measured proportions. Key finding: the game facade is proportionally **taller** than the
       real (3.2:1 vs ~6:1) — the main shape-language deviation; canopy pitch, blade-sign diameter,
       entrance and roofline all match closely. Curtain-bay count is crop-dependent (3–7), so 7 is
       accepted as a readable stylization.
 - [x] Rank the shape-language gaps and write the top-five fix list (measurements from the
-      proportions pass, §`docs/joke-shop-map.md`):
+      proportions pass, §`docs/venues.md#the-joke-shop`):
       1. **Facade height** — game 8.4 m vs real ~5.5–6 m (≈3.2:1 vs ~6:1 ratio). **Fixed
          2026-11-03:** `facade_height` lowered to 6.0 m; the wall now reads as a low single-storey
          hall with the canopy capping the top (vision-verified).
@@ -674,7 +674,7 @@ pass. The current `_build_comedy_store_building()` stays as the fallback.*
       top-five list.
 - [x] Gates after the rebuild: Godot 277/277 (map budget 26,828 tris / 580 meshes under 150k/700;
       navigation/collider tests pass), `tools/check_screenshots.sh` 21 good / 0 bad; the three-up
-      board and `docs/joke-shop-map.md` were refreshed.
+      board and `docs/venues.md#the-joke-shop` were refreshed.
 - [ ] Update `docs/development-status.md`, `docs/asset-tooling.md` and `CHANGELOG.md` when the
       rebuild lands; record any accepted deviations from the reference.
 
@@ -716,7 +716,7 @@ pass. The current `_build_comedy_store_building()` stays as the fallback.*
 ### M. Local map QA and exit
 
 - [x] Compare the block against screenshots/map docs and keep the stylized fallback: the three-up
-      boards (photo | concept | capture) and `docs/joke-shop-map.md` record the evidence chain;
+      boards (photo | concept | capture) and `docs/venues.md#the-joke-shop` record the evidence chain;
       the procedural `_build_comedy_store_building()` remains the fallback.
 - [x] Budget/navigation/collider + day/night captures: Godot 277/277 (Joke Shop 26,828 tris /
       580 meshes under 150k/700; navmesh, step collider and prop-collider tests pass),
@@ -724,7 +724,7 @@ pass. The current `_build_comedy_store_building()` stays as the fallback.*
 - [x] Gallery + before/after: the Joke Shop day gallery frame and three-up board were recaptured
       after each facade change; the photo/concept/capture strip is the before/after record.
 - [x] `tools/check_screenshots.sh` re-run (21/0) and the Joke Shop three-up board refreshed.
-- [x] Docs: `docs/joke-shop-map.md` (mapping, measured proportions, simplifications),
+- [x] Docs: `docs/venues.md#the-joke-shop` (mapping, measured proportions, simplifications),
       `docs/asset-tooling.md` (`describe_image.py`) and `docs/development-status.md` updated.
       `CHANGELOG.md` is untouched (unversioned track; no release).
 - [x] Exit: **one local block (the Comedy Store) is reconstructed with reference-derived facades
@@ -865,7 +865,7 @@ first; this minor contains the model/map work.
 
 - [x] Define measurable targets for routine compliance, access-decision accuracy, peaceful
       resolution, justified emergency calls and false-positive/false-negative rates.
-      (`docs/balance-acceptance.md` defines cohorts, denominators, 36 matrix cells,
+      (`docs/release-qa.md#balance-acceptance` defines cohorts, denominators, 36 matrix cells,
       seeds, thresholds and matched emergency-first comparisons. Documentation verified;
       targets are not measured results.)
 - [ ] Run scripted venue sweeps across easy/normal/hard and all four phases; compare outcomes and
@@ -960,7 +960,7 @@ first; this minor contains the model/map work.
 ### Documentation and visual sign-off
 
 - [ ] Update `README.md`, `PLAN.md`, `docs/architecture.md`, ADRs, `docs/development-status.md`,
-      `docs/getting-started.md`, `docs/smoke-checklist.md`, `CHANGELOG.md` and this roadmap.
+      `docs/getting-started.md`, `docs/release-qa.md#manual-smoke-checklist`, `CHANGELOG.md` and this roadmap.
 - [ ] Regenerate the full screenshot gallery and realism baselines from the release-candidate
       build (not the dev tree) after content lock; run `check_screenshots.sh` and the pinned vision
       judge, recording model/spend/verdicts, and refresh the README and venue-doc images.