Docs: LANTERN Phase 0 — full pivot adoption + all-doc sweep
Adopt LANTERN as the operative direction (co-op action-RPG, light-as-territory), superseding the Awakening Engine fiction + the Co-op Hades iteration. Existing code becomes salvage quarry; the mechanical pillars hold. Phase 0 deliverables (doc portions): - DR-048 adoption decision record (0.1) - Lantern_Strip_Mothball_Inventory — system-by-system keep/rework/mothball (0.2) - Lantern_World_Model_Spike — pocket-graph + seed-pinning BRIEF, review-first (0.3) - Art_Direction_Lantern — style bible + material decision + A0 gate (0.4) Docs/skills sweep: Pillars pointers + LANTERN locked decisions; superseded banners on Identity, Iteration_CoopHades, Path_to_Fun, Milestones, Backlog, End_Of_Month (all redirect to the LANTERN roadmap); Home MoC + current-direction callout (and stale serena line fixed); Systems_Index era note; CLAUDE.md core-loop line -> LANTERN direction pointer (verbose co-op-Hades invariants archived to the gotchas archive, net-neutral under the 40 KB budget); dots-dev validation-harness expedition-run recipe flagged era-specific. Two Phase-0 gate items remain OPEN (not doc work): the 0.3 world-model design review and the 0.4 in-engine style-proof scene. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,77 @@
|
||||
---
|
||||
date: 2026-07-13
|
||||
type: session
|
||||
tags: [session, lantern, pivot, phase-0, docs]
|
||||
permalink: gamevault/07-sessions/2026/2026-07-13-lantern-phase0-adoption-pivot
|
||||
---
|
||||
|
||||
# Session 2026-07-13 — LANTERN Phase 0: adoption & the full docs/skills pivot
|
||||
|
||||
## Goal
|
||||
|
||||
Start Phase 0 of the LANTERN roadmap ([[Roadmap_Lantern_Slice]]): **make the full pivot** — adopt LANTERN as
|
||||
the operative direction and update **all docs & skills** to reflect it, plus deliver the Phase-0 items that are
|
||||
documentation work. No code this session (the pivot is a direction adoption; implementation starts at Phase 1).
|
||||
|
||||
## Done
|
||||
|
||||
**Phase 0 checklist items (doc portions):**
|
||||
- **0.1 Adoption** — wrote [[DR-048_Lantern_Adoption_Full_Pivot]] (LANTERN supersedes the Awakening-Engine
|
||||
fiction + the Co-op Hades iteration; archive-not-delete; existing code = quarry; mechanical pillars hold).
|
||||
- **0.2 Strip/mothball** — wrote [[Lantern_Strip_Mothball_Inventory]]: system-by-system keep / rework /
|
||||
mothball / cut, grounded in [[Systems_Index]] + the co-op-Hades systems. Headlines: combat feel + telegraphs
|
||||
= keep; boon pipeline → mutations; regions-relevancy / lifecycle / save → rework; automation +
|
||||
sieges/Core/turret = mothball.
|
||||
- **0.3 World-model spike** — wrote [[Lantern_World_Model_Spike]] as a **★review-first BRIEF** (pocket-graph +
|
||||
seed-pinning + light-as-information relevancy + Bell transit contract, with the open questions + known
|
||||
hazards for the review). Marked review-PENDING; no world code until the adversarial review passes.
|
||||
- **0.4 Art A0** — wrote [[Art_Direction_Lantern]]: the binding style bible, **the material decision** (one
|
||||
palette atlas + vertex colours under three master shaders `Lit-Palette`/`Emissive-Gloam`/`Skinned-Palette`),
|
||||
the reference board, and the style-proof-scene gate definition. The in-engine scene itself = pending.
|
||||
|
||||
**"Update all docs & skills" sweep:**
|
||||
- [[Pillars]] — LANTERN direction banner up top + a LANTERN locked-decisions block; Related repointed to
|
||||
[[Identity_Lantern]] (prior [[Identity]] marked superseded/quarry).
|
||||
- Superseded banners → [[Identity]], [[Iteration_2026-07_CoopHades]], [[Path_to_Fun]] (redirected straight to
|
||||
LANTERN; `status: active`→`superseded`). Kept as history; nothing deleted.
|
||||
- [[Home]] MoC — current-direction callout = LANTERN; vision/roadmap/session/decision pointers refreshed; the
|
||||
stale "serena navigates C# symbols" line fixed to Glob/Grep (serena removed 07-07).
|
||||
- [[Systems_Index]] — era note: the catalogued systems are the pre-pivot spine = quarry, verdicts in the
|
||||
inventory.
|
||||
- `CLAUDE.md` — the "Core loop" bootstrap bullet replaced with a **LANTERN direction pointer** (net-neutral:
|
||||
39,684→39,681 B, under the 40 KB budget); the verbose DR-044/045/046 core-loop invariants archived verbatim
|
||||
to `_Meta/CLAUDE_Build_Gotchas_Archive.md` under a new 2026-07-13 heading (the general "serialized prefab
|
||||
bool ignores the C# initializer" gotcha kept inline). Condensation-history line ticked.
|
||||
- `dots-dev` skill — `references/validation-harness.md`: noted the "expedition-run" driving recipe's nouns are
|
||||
co-op-Hades-era (re-meaned to the descent lifecycle later); the harness *patterns* stay direction-agnostic.
|
||||
The rest of the skill is process-only and needed no pivot.
|
||||
- Native memory — new [[lantern-direction-pivot]] operative-direction note + `MEMORY.md` index; the prior
|
||||
direction memory kept with a supersession pointer.
|
||||
|
||||
## Decisions
|
||||
|
||||
- [[DR-048_Lantern_Adoption_Full_Pivot]] — LANTERN is the operative direction (Phase 0.1 gate closed).
|
||||
|
||||
## Open / deferred (explicitly flagged — NOT silently deferred)
|
||||
|
||||
Two Phase-0 items are **not** doc work and remain OPEN gate conditions:
|
||||
1. **0.3 world-model design review** — the ★review-first adversarial Workflow over [[Lantern_World_Model_Spike]]
|
||||
+ ground-truth relevancy/lifecycle/save code, producing `World_Model_Build_Spec.md`. This is the slice's
|
||||
hardest netcode problem; no world code until it passes.
|
||||
2. **0.4 A0 style-proof scene** — one prop + one creature + one suit in-engine under murk, judged full-size +
|
||||
200 px + grayscale. Requires Blender + engine work (Workstream A0 gate).
|
||||
|
||||
Phase 0 does not fully exit until both land. Phase 1 (the combat gym) has **no world** and is not blocked by
|
||||
0.3 — it can start on the KEEP/rework salvage once the operator chooses.
|
||||
|
||||
## Next
|
||||
|
||||
Operator fork: (a) run the **0.3 world-model design-review Workflow** now, or (b) start the **0.4 style-proof
|
||||
scene** (Blender on-ramp), or (c) begin **Phase 1 combat gym** planning from the salvage inventory. Recommend
|
||||
(a) since it unblocks all world-touching work and is the standing review-first ritual, with (b) proceeding in
|
||||
parallel on the art track.
|
||||
|
||||
## Related
|
||||
|
||||
- [[Roadmap_Lantern_Slice]] · [[Identity_Lantern]] · [[Lantern_Strip_Mothball_Inventory]] ·
|
||||
[[Lantern_World_Model_Spike]] · [[Art_Direction_Lantern]] · [[DR-048_Lantern_Adoption_Full_Pivot]]
|
||||
@@ -0,0 +1,94 @@
|
||||
---
|
||||
id: DR-048
|
||||
title: LANTERN adoption — the full pivot (supersedes Awakening Engine + Co-op Hades)
|
||||
status: accepted
|
||||
date: 2026-07-13
|
||||
tags: [decision, direction, lantern, pivot, adoption]
|
||||
permalink: gamevault/07-sessions/decisions/dr-048-lantern-adoption-full-pivot
|
||||
---
|
||||
|
||||
# DR-048 — LANTERN adoption: the full pivot
|
||||
|
||||
## Context
|
||||
|
||||
The 2026-07-13 vision refresh ([[Theme_Direction_Candidates]]) explored four load-bearing-theme
|
||||
directions against the operator brief (**V Rising + Shape of Dreams** core; SoD-grade skillshot combat +
|
||||
modular ability kits braided with a persistent base; 2–4 co-op; solo dev learning Blender, RoR2-lineage
|
||||
low-poly). The operator selected **Direction A — LANTERN** and put a full identity draft through **three
|
||||
independent adversarial reviews** (theme/narrative · systems/game-loop · player-experience/market). All
|
||||
findings were operator-accepted and folded into the review-hardened final draft [[Identity_Lantern]] (v3),
|
||||
with the vertical-slice roadmap [[Roadmap_Lantern_Slice]].
|
||||
|
||||
This forces a direction decision: the codebase and vault were built under **The Awakening Engine**
|
||||
(Aether-colony sci-fi fiction, [[Identity]] / [[DR-015_The_Awakening_Engine_Fiction_Adoption]]) and most
|
||||
recently steered by the **Co-op Hades conversion** iteration ([[Iteration_2026-07_CoopHades]], which
|
||||
itself superseded the DR-037 → DR-042 expedition-driven line and the DR-035 end-of-month jam slice). LANTERN
|
||||
keeps every locked **mechanical** pillar ([[Pillars]] #1–4 hold) but replaces the **fiction, the world
|
||||
model, the death rules, the build/mutation system, and the combat feel target**. It is not a reskin — under
|
||||
LANTERN's own load-bearing test, reskinning "light" would break persistence, death, relevancy, the economy,
|
||||
and the treadmill at once. This is a genuine change of direction, so it is recorded as one.
|
||||
|
||||
## Decision
|
||||
|
||||
**LANTERN is the operative direction.** [[Identity_Lantern]] is the authoritative design; [[Roadmap_Lantern_Slice]]
|
||||
is the operative roadmap. This DR is the **adoption gate** (Phase 0.1 of that roadmap).
|
||||
|
||||
1. **Supersession (archive, never delete).** LANTERN supersedes, as the *operative target*:
|
||||
- the Awakening-Engine fiction — [[Identity]] / [[DR-015_The_Awakening_Engine_Fiction_Adoption]];
|
||||
- the Co-op Hades iteration — [[Iteration_2026-07_CoopHades]];
|
||||
- and by transitivity the direction line it carried (DR-037 expedition spine → DR-042 expedition-driven
|
||||
win → DR-044/045/046 demo passes → DR-047 boon overhaul).
|
||||
All of it is **kept as history and as salvage quarry** — banners point forward, nothing is removed. Prior
|
||||
DRs stay valid as records of what was built and why.
|
||||
|
||||
2. **Existing code is quarry, not foundation.** Strip and reuse freely; no design decision bends to preserve
|
||||
code. The system-by-system keep / rework / mothball calls live in [[Lantern_Strip_Mothball_Inventory]]
|
||||
(Phase 0.2). Headline calls, from the roadmap's standing constraints: **combat feel layer + telegraphs =
|
||||
keep**; **boon pipeline = rework into wild mutations**; **regions/relevancy, save system, hub lifecycle =
|
||||
rework**; **sieges / Core / turret-ammo economy leftovers = mothball**.
|
||||
|
||||
3. **The mechanical pillars hold; the fiction and three subsystems change.** Unchanged: Unity DOTS +
|
||||
Netcode for Entities, server-authoritative, input-only clients, client prediction, 2–4 co-op
|
||||
([[Pillars]]). Changed by LANTERN: (a) **world model** → seed-pinned **pocket-graph** with light-as-
|
||||
permanence (the tide-line); (b) **combat feel** → SoD-grade **manual-aim skillshots** (the soft
|
||||
auto-target era ends as the target — see the pillars note); (c) **build system** → suit-frames + cultured
|
||||
**Sparks** + wild **mutations** (the augment layer), replacing flat-stat boons.
|
||||
|
||||
4. **The slice's falsifiable test is the only gate that matters:** *does pinning a pocket feel like winning
|
||||
something, and does a stranded suit feel worth a second descent?* Every deferred system is justified only
|
||||
by these two.
|
||||
|
||||
5. **Phase 0 exit is NOT this DR alone.** The roadmap gates Phase 0 on **three** things: this DR merged **+**
|
||||
the world-model design review passed ([[Lantern_World_Model_Spike]], ★review-first — not yet run) **+**
|
||||
the A0 style-proof scene approved in-engine ([[Art_Direction_Lantern]], gate pending). This DR closes only
|
||||
0.1; 0.2 (inventory) is delivered; **0.3 and 0.4's in-engine gates remain open.**
|
||||
|
||||
## Consequences
|
||||
|
||||
- **Naming.** Working title "LANTERN" has poor Steam-search uniqueness; a shipping-title pass is deferred to
|
||||
a marketing milestone (per [[Identity_Lantern]]). "LANTERN" is the internal codename until then.
|
||||
- **Vault surface updated this session (Phase 0 pivot):** [[Pillars]] (pointer + LANTERN locked decisions),
|
||||
[[Identity]] + [[Iteration_2026-07_CoopHades]] + [[Path_to_Fun]] (superseded banners), [[Home]] (MoC +
|
||||
current direction), [[Systems_Index]] (era note), `CLAUDE.md` (game-state/core-loop line → LANTERN pivot
|
||||
pointer; verbose co-op-Hades invariants archived to `_Meta/CLAUDE_Build_Gotchas_Archive.md`). Prior DRs and
|
||||
session logs are **not** rewritten — they are the record.
|
||||
- **basic-memory** reindexes this DR and the new roadmap/vision docs on next index; native `memory/`
|
||||
gets the [[lantern-direction-pivot]] operative-direction note. The old direction memory is kept as history.
|
||||
- **What does NOT change yet:** no world code, no fiction rename in code, no ghost/RPC churn. The pivot is a
|
||||
documentation + direction adoption; implementation begins at Phase 1 (combat gym) and only after the Phase 0
|
||||
world-model review passes for anything world-touching.
|
||||
- **Revisit when:** the slice test fails on either half (pinning doesn't feel like winning, or a stranded suit
|
||||
doesn't pull a second descent) — that invalidates the direction, not a subsystem, and triggers a fresh
|
||||
fork-locking ritual. Also revisit the "crews present-but-unlit vs gone" and shipping-title open forks at the
|
||||
narrative/marketing milestones.
|
||||
|
||||
## Related
|
||||
|
||||
- [[Identity_Lantern]] — the design this adopts (authoritative)
|
||||
- [[Roadmap_Lantern_Slice]] — the operative roadmap (this is its Phase 0.1)
|
||||
- [[Lantern_Strip_Mothball_Inventory]] — Phase 0.2, the salvage map
|
||||
- [[Lantern_World_Model_Spike]] — Phase 0.3, ★review-first (gate open)
|
||||
- [[Art_Direction_Lantern]] — Phase 0.4 / Workstream A0 (in-engine gate open)
|
||||
- [[Theme_Direction_Candidates]] — the exploration that produced the fork
|
||||
- [[Identity]] · [[Iteration_2026-07_CoopHades]] · [[DR-047_Phase17_Boon_Overhaul_Mechanic_Changers]] — superseded as operative, kept as quarry
|
||||
- [[Pillars]] — the mechanical constraints LANTERN was shaped inside (unchanged)
|
||||
Reference in New Issue
Block a user