LAYER_MODEL_V2_REMAP_SPEC.md

decisions/spine/LAYER_MODEL_V2_REMAP_SPEC.md

Layer-model-v2 terminology remap — ready-to-execute spec (D-amendment follow-on)

Status: SPECCED, not yet applied (2026-07-12). The D-layer-model-v2 amendment (ratified Josh 2026-07-12) rewrote CVD §2 and Pillar 12 to the four-band Layer-model-v2, and its Pillar-12 Cross-ref bullet carries the authoritative supersession note. That note governs the remaining ~40 stale "Layer 1/2/3" references across the CVD (exactly as §17.7's deprecation clause governs stale realm names), so the CVD is self-consistent-with-supersession, not hard-contradictory. This remaining terminology remap is deliberately its own reviewable diff (per the amendment's apply-note #3) because it is a many-to-many semantic mapping that touches reveal-discipline sections — it must not be rushed.

Why this is not a mechanical find-replace

Layer-model-v2 is NOT a rename; it is a re-partition:

OLD model (three-layer)	NEW model (Layer-model-v2)
Layer 1 — surface / mechanical routing ("find pyramid → vril recharge")	L1 — systems-play (the AAA action-RPG; the substrate operates as real for every player). The old "mechanical routing / substrate-as-real" content lives here now.
Layer 2 — investigatable depth (journal, Grimoire links, inscription, cultural texture)	SPLITS: the ambient culture/history/geography half → L1.5; the cross-cultural connection / Grimoire-link / pattern-weaving half → L3.
Layer 3 — canonical truth ("the why", never spoken)	L3 — the rabbit-hole (the connections the player makes + "engage the why").
(none)	L2 — the completionist (systems mastery: max skills, top-score minigames, max vehicles/bases, every side quest). BRAND NEW.

The two traps that make this semantic, per-occurrence work:

An old "Layer 2 investigatable" ref must be judged: ambient-culture half (→ L1.5) or connective/Grimoire half (→ L3) or both. Most per-chapter mandates ("journal, Grimoire link, inscription, language fragment, cultural-tradition content") are BOTH — they become "L1.5 ambient + L3 connective."
An old "Layer 3 mechanical routing" ref (e.g. §7.5 line ~124 "Layer 3 mechanical routing per site: vril resonance…"; §14.6 "Trades are the most direct Layer 3 mechanical routing") is now mostly L1 (the substrate operating as real IS the systems-play layer), while the "engage the why / canonical-truth" sense stays L3. Read each in context.

Reveal-discipline caution (do not break)

L3 (canonical truth / the why) is NEVER declared — that invariant is unchanged and load-bearing. The reveal-sensitive sections (§17.5 per-chapter mandates lines ~1067-1071; §18 "Show, Never Tell" line ~1153; §18.2 "surfacing routes" lines ~1163-1207) must keep "the substrate is felt/surfaced, never spoken." Re-verify reveal discipline after the remap.

Occurrence inventory (CVD, post-Stage-2; ~40 refs)

Non-exhaustive line pointers (verify live before editing — Stage-1/2 shifted lines):

§2 line 11 (the one-line thesis surfacing summary — three-layer enumeration) — remap to the four bands.
"Layer 3 anchor:" section-metadata lines (41, 62, 308, 352, 389, 450, 602, 694, 739, 801, 861, 927, 1153) — these tag which component a section serves at the canonical-truth level → keep as L3 anchor (canonical-truth), unchanged in most cases.
§3 line 64 ("Layer 3 mechanical routing or Layer 2 investigatable substrate") — L1 (routing) + (L1.5/L3) (investigatable).
§3.x site line 124 ("Layer 3 mechanical routing per site" / "Layer 2 investigatable substrate") — L1 + (L1.5/L3).
§8 char-creation lines 381, 419, 421 ("surface (Layer 1)", "Layer 2 — journal author", "Layer 3 mechanical routing", "Pillar 12 three-layer engagement") — re-map + the "three-layer artifact"/"three-layer engagement" phrasings.
§13 quest structure lines 563-565 (Event=Layer 1 / Context=Layer 2 / Biography=Layer 3) — Event→L1, Context→L1.5+L3, Biography-resonance→L3.
§12 mastery line 610; §11-Boss lines 720; §9-guild line 720; §14.x trades lines 768, 795-797 (§14.6 heading "Trades and Layer 3 mechanical routing" → L1 systems-play routing) ; §16 pacing line 861.
§17.1 care line 935 ("Layer 1 as playable action content, Layer 2 as investigatable depth, Layer 3 as substrate and occult threads") — L1 / L1.5+L3 / L3.
§17.5(?) per-chapter mandate lines 1067-1071 ("Per-chapter Layer 3 substrate surfacing… / Per-chapter Layer 2 substrate investigatable… / Layer 1 surface track self-contained") — the compliance mandate; remap to L1 systems-play + L1.5 ambient + L3 connective/canonical, preserving "self-contained / never blocks progression".
§18.2 lines 1163-1207 ("The three-layer surfacing routes" heading + the three route paragraphs + the per-chapter compliance bullets + the quest "show" bullets) — the biggest block; the heading "three-layer" → "layered", and each route re-partitioned.
§5 Pillar-12 line 249 already done (the Cross-ref supersession anchor).

Downstream consumers to re-key WHEN this lands (not before)

Range Review Audit Grid 10 → "layered-compliance grid" (Pillar-12 already renamed it).
The spine "three-layer compliance check" gate/label; T8 Region Page structure (L1/L1.5/L2/L3).
The /spine-chapter skill + the normalize-doc critic rubric (both currently say "three layers L1/L2/L3").
Any harness column literally named for "Layer 2/3".

Recommended execution

A single focused pass (one careful editor or one adversarially-verified agent) working section-by-section top-to-bottom, applying the mapping table above, then: (1) grep the CVD for surviving bare "Layer 2"/"three-layer" and confirm each is intentional; (2) run python harness/run_gates.py (lint/anchors); (3) reveal-discipline re-verify on §17.5/§18/§18.2; (4) re-key the four downstream consumers in the same commit. Not a blocker for the endgame re-cascade (endgame nodes author against the now-canonical Pillar-12 + §2 v2 model).

Generated by harness/site/structure_site.py — the URL path is the repo path. review root