From 6b7623615d74921a8ea66406965b1b381cd0fda2 Mon Sep 17 00:00:00 2001 From: VinPropane Date: Fri, 3 Apr 2026 22:14:47 -0400 Subject: [PATCH] chore: stable Epic 3 slice anchors; deep-links from gather/craft docs - epic_03: HTML ids epic-3-slice-2 / epic-3-slice-3 - gathering/crafting: where-next and prototype scope use # anchors - game-design docs review: mark slice nit done; clarify gigs-first nit --- docs/decomposition/epics/epic_03_crafting_economy.md | 4 ++++ docs/game-design/crafting.md | 6 +++--- docs/game-design/gathering.md | 2 +- docs/reviews/2026-04-03-game-design-branch-docs-review.md | 4 ++-- 4 files changed, 10 insertions(+), 6 deletions(-) diff --git a/docs/decomposition/epics/epic_03_crafting_economy.md b/docs/decomposition/epics/epic_03_crafting_economy.md index 2fc18c3..1071a28 100644 --- a/docs/decomposition/epics/epic_03_crafting_economy.md +++ b/docs/decomposition/epics/epic_03_crafting_economy.md @@ -62,6 +62,8 @@ Implement gathering from world nodes, item/inventory representation, recipe exec - Item schema versioned for forward-compatible migrations. - Telemetry hooks: `item_created`, `inventory_full` / transfer failures. + + ### Slice 2 - Gather nodes and outputs - Scope: E3.M1 with 4-6 node types and yield tables; awards crafting/gathering XP via E2.M2. @@ -70,6 +72,8 @@ Implement gathering from world nodes, item/inventory representation, recipe exec - Full gather interaction in prototype region without dupes or free resources. - Telemetry hooks: `resource_gathered`, `gather_node_depleted`. + + ### Slice 3 - Recipes and crafting pipeline - Scope: E3.M2 with 8-12 starter recipes per prototype minimums. diff --git a/docs/game-design/crafting.md b/docs/game-design/crafting.md index 6a04ae1..c507140 100644 --- a/docs/game-design/crafting.md +++ b/docs/game-design/crafting.md @@ -22,7 +22,7 @@ Authoritative **recipe graph** is **data** (`RecipeDef`); design intent: | **Branching** | Same inputs can route to **different** skills or recipes for **different** outputs (**overlapping chains**)—dense economy, not a single trunk. | | **Skill per recipe** | Each recipe names **required skill** (and level band **TBD**); one **Process** skill is not the only mid-pipeline actor. | -**Prototype scope:** [Epic 3](../decomposition/epics/epic_03_crafting_economy.md) **Slice 3** targets a **starter recipe set** (e.g. 8–12 minimums in epic text) proving **gather → refine → item used in combat or quest**. +**Prototype scope:** [Epic 3 — Slice 3 (Recipes pipeline)](../decomposition/epics/epic_03_crafting_economy.md#epic-3-slice-3) targets a **starter recipe set** (e.g. 8–12 minimums in epic text) proving **gather → refine → item used in combat or quest**. ## Stations, co-op, and UX @@ -71,5 +71,5 @@ Authoritative **recipe graph** is **data** (`RecipeDef`); design intent: | Process / Make skill names | [skills.md](skills.md) **Process** and **Make** tables | | Raw inputs from the world | [gathering.md](gathering.md) | | Item categories & tooltips | [items.md](items.md) | -| Epic 3 craft slice | [Epic 3](../decomposition/epics/epic_03_crafting_economy.md) — *Slice 3 — Recipes and crafting pipeline* | -| Gather slice (inputs) | [Epic 3](../decomposition/epics/epic_03_crafting_economy.md) — *Slice 2 — Gather nodes and outputs* | +| Epic 3 craft slice | [Epic 3 — Slice 3 (Recipes pipeline)](../decomposition/epics/epic_03_crafting_economy.md#epic-3-slice-3) | +| Gather slice (inputs) | [Epic 3 — Slice 2 (Gather nodes)](../decomposition/epics/epic_03_crafting_economy.md#epic-3-slice-2) | diff --git a/docs/game-design/gathering.md b/docs/game-design/gathering.md index b64c78a..8d9a3e5 100644 --- a/docs/game-design/gathering.md +++ b/docs/game-design/gathering.md @@ -75,6 +75,6 @@ Directional goals (implementation **open**): | Gather skill names & merge notes | [skills.md](skills.md) **Gather** table | | Items & materials buckets | [items.md](items.md) | | Crafting & recipes (vision) | [crafting.md](crafting.md) | -| Epic 3 gather slice | [Epic 3](../decomposition/epics/epic_03_crafting_economy.md) — *Slice 2 — Gather nodes and outputs* | +| Epic 3 gather slice | [Epic 3 — Slice 2 (Gather nodes)](../decomposition/epics/epic_03_crafting_economy.md#epic-3-slice-2) | | Interaction contracts | [E1.M3](../decomposition/modules/E1_M3_InteractionAndTargetingLayer.md) | | Zone ecology | [E4.M2](../decomposition/modules/E4_M2_SpawnEcologyController.md), [Epic 4](../decomposition/epics/epic_04_world_topology.md) | diff --git a/docs/reviews/2026-04-03-game-design-branch-docs-review.md b/docs/reviews/2026-04-03-game-design-branch-docs-review.md index dcd81b0..2adf993 100644 --- a/docs/reviews/2026-04-03-game-design-branch-docs-review.md +++ b/docs/reviews/2026-04-03-game-design-branch-docs-review.md @@ -51,8 +51,8 @@ None identified. ## Nits -- Epic 3 slice references in `gathering.md` / `crafting.md` use *italic* slice titles next to the epic link rather than `#` anchors—**intentionally robust** vs GitHub slug drift; keep as-is unless you add explicit HTML ids in the epic doc. -- `skills.md` **Next artifacts** still lists **gigs** first (appropriate for folder flow); no change required. +- ~~Epic 3 slice references in `gathering.md` / `crafting.md` use *italic* slice titles next to the epic link rather than `#` anchors—**intentionally robust** vs GitHub slug drift; keep as-is unless you add explicit HTML ids in the epic doc.~~ **Done** — `epic_03_crafting_economy.md` now has `` / ``; `gathering.md` / `crafting.md` deep-link with stable anchors. +- `skills.md` **Next artifacts** lists **gigs** first — **intentional** (folder reading order); no change. ## Verification