diff --git a/docs/decomposition/README.md b/docs/decomposition/README.md index fb58dce..a303cc7 100644 --- a/docs/decomposition/README.md +++ b/docs/decomposition/README.md @@ -25,7 +25,7 @@ This workspace contains detailed planning artifacts derived from the finalized m | Epic | Document | |------|----------| | 1 - Core Player Runtime | [epics/epic_01_core_player_runtime.md](epics/epic_01_core_player_runtime.md) | -| 2 - Classless Progression | [epics/epic_02_classless_progression.md](epics/epic_02_classless_progression.md) | +| 2 - Classless Progression Framework | [epics/epic_02_classless_progression.md](epics/epic_02_classless_progression.md) | | 3 - Crafting Economy | [epics/epic_03_crafting_economy.md](epics/epic_03_crafting_economy.md) | | 4 - World Topology | [epics/epic_04_world_topology.md](epics/epic_04_world_topology.md) | | 5 - PvE Combat | [epics/epic_05_pve_combat.md](epics/epic_05_pve_combat.md) | diff --git a/docs/decomposition/epics/epic_02_classless_progression.md b/docs/decomposition/epics/epic_02_classless_progression.md index 7792336..3301fd4 100644 --- a/docs/decomposition/epics/epic_02_classless_progression.md +++ b/docs/decomposition/epics/epic_02_classless_progression.md @@ -1,4 +1,4 @@ -# Epic 2 - Classless Skill and Progression Framework +# Epic 2 - Classless Progression Framework ## Source Anchors diff --git a/docs/decomposition/modules/E2_M1_SkillDefinitionRegistry.md b/docs/decomposition/modules/E2_M1_SkillDefinitionRegistry.md index cb6569d..9dcf95c 100644 --- a/docs/decomposition/modules/E2_M1_SkillDefinitionRegistry.md +++ b/docs/decomposition/modules/E2_M1_SkillDefinitionRegistry.md @@ -5,7 +5,7 @@ | Field | Value | |--------|--------| | **Module ID** | E2.M1 | -| **Epic** | [Epic 2 — Classless progression](../epics/epic_02_classless_progression.md) | +| **Epic** | [Epic 2 — Classless Progression Framework](../epics/epic_02_classless_progression.md) | | **Stage target** | Prototype | | **Status** | Planned (see [dependency register](module_dependency_register.md)) | diff --git a/docs/decomposition/modules/E2_M2_XpAwardAndLevelEngine.md b/docs/decomposition/modules/E2_M2_XpAwardAndLevelEngine.md index 85d5cae..7a99e31 100644 --- a/docs/decomposition/modules/E2_M2_XpAwardAndLevelEngine.md +++ b/docs/decomposition/modules/E2_M2_XpAwardAndLevelEngine.md @@ -5,7 +5,7 @@ | Field | Value | |--------|--------| | **Module ID** | E2.M2 | -| **Epic** | [Epic 2 — Classless Progression](../epics/epic_02_classless_progression.md) | +| **Epic** | [Epic 2 — Classless Progression Framework](../epics/epic_02_classless_progression.md) | | **Stage target** | Prototype | | **Status** | Planned (see [dependency register](module_dependency_register.md)) | diff --git a/docs/decomposition/modules/E2_M3_MasteryAndPerkUnlocks.md b/docs/decomposition/modules/E2_M3_MasteryAndPerkUnlocks.md index 1dd4db8..a44989c 100644 --- a/docs/decomposition/modules/E2_M3_MasteryAndPerkUnlocks.md +++ b/docs/decomposition/modules/E2_M3_MasteryAndPerkUnlocks.md @@ -5,7 +5,7 @@ | Field | Value | |--------|--------| | **Module ID** | E2.M3 | -| **Epic** | [Epic 2 — Classless Progression](../epics/epic_02_classless_progression.md) | +| **Epic** | [Epic 2 — Classless Progression Framework](../epics/epic_02_classless_progression.md) | | **Stage target** | Pre-production | | **Status** | Planned (see [dependency register](module_dependency_register.md)) | diff --git a/docs/decomposition/modules/E2_M4_ProgressionPacingControls.md b/docs/decomposition/modules/E2_M4_ProgressionPacingControls.md index f5bcd06..f6d636c 100644 --- a/docs/decomposition/modules/E2_M4_ProgressionPacingControls.md +++ b/docs/decomposition/modules/E2_M4_ProgressionPacingControls.md @@ -5,7 +5,7 @@ | Field | Value | |--------|--------| | **Module ID** | E2.M4 | -| **Epic** | [Epic 2 — Classless Progression](../epics/epic_02_classless_progression.md) | +| **Epic** | [Epic 2 — Classless Progression Framework](../epics/epic_02_classless_progression.md) | | **Stage target** | Pre-production | | **Status** | Planned (see [dependency register](module_dependency_register.md)) | diff --git a/docs/decomposition/modules/module_dependency_register.md b/docs/decomposition/modules/module_dependency_register.md index c633e12..5aba75a 100644 --- a/docs/decomposition/modules/module_dependency_register.md +++ b/docs/decomposition/modules/module_dependency_register.md @@ -17,7 +17,7 @@ Fleshed-out scope, contracts, and integration notes live in **per-module documen | E1.M3 | InteractionAndTargetingLayer | E1.M1 | TargetState, InteractableDescriptor, SelectionEvent | Prototype | Planned | | E1.M4 | AbilityInputScaffold | E1.M3, E5.M1 | AbilityCastRequest, HotbarLoadout, CooldownSnapshot | Prototype | Planned | -### Epic 2 — Classless Progression +### Epic 2 — Classless Progression Framework | Module ID | Module Name | Depends On | Contract Needed | Phase Required | Status | |---|---|---|---|---|---| diff --git a/docs/game-design/gigs.md b/docs/game-design/gigs.md index 2c604fc..8316438 100644 --- a/docs/game-design/gigs.md +++ b/docs/game-design/gigs.md @@ -2,7 +2,7 @@ Vision-level design for **combat identity**: what you bring to a fight, how you progress, and how you swap roles. **Shared progression framing** and **vocabulary**: [progression.md](progression.md). **Gigs ↔ skills seams** (gear, crafting, consumables, rep): [skills.md](skills.md). This file is the **gig** artifact proper. -**Implementation anchors:** [Epic 5 — PvE combat](../decomposition/epics/epic_05_pve_combat.md); gig XP/progression will need alignment with [Epic 2 — Classless progression](../decomposition/epics/epic_02_classless_progression.md) when data models split. +**Implementation anchors:** [Epic 5 — PvE combat](../decomposition/epics/epic_05_pve_combat.md); gig XP/progression will need alignment with [Epic 2 — Classless Progression Framework](../decomposition/epics/epic_02_classless_progression.md) when data models split. ## What a gig is diff --git a/docs/game-design/progression.md b/docs/game-design/progression.md index 6a97168..b4102fb 100644 --- a/docs/game-design/progression.md +++ b/docs/game-design/progression.md @@ -2,7 +2,7 @@ Shared vision for **how characters grow** in Neon Sprawl: **combat** vs **everything else** use different systems that still live on **one avatar**. Detail docs: **[gigs.md](gigs.md)** (combat roles), **[skills.md](skills.md)** (non-combat skills and **gigs ↔ skills seams**). -**Implementation note:** [Epic 2 — Classless progression](../decomposition/epics/epic_02_classless_progression.md) (E2.M1–M4): **Slice 3** wires **gather/craft** to **skill** XP (E2.M2), **combat encounters** to **gig XP only**, and allows **mission reward** hooks to grant **skill** XP when scripted—**not** via the combat encounter pipe. **Gig** levels stay **per gig**; exact gig XP module ownership may sit beside E2.M2 or under Epic 5 until the gig data model is finalized. +**Implementation note:** [Epic 2 — Classless Progression Framework](../decomposition/epics/epic_02_classless_progression.md) (E2.M1–M4): **Slice 3** wires **gather/craft** to **skill** XP (E2.M2), **combat encounters** to **gig XP only**, and allows **mission reward** hooks to grant **skill** XP when scripted—**not** via the combat encounter pipe. **Gig** levels stay **per gig**; exact gig XP module ownership may sit beside E2.M2 or under Epic 5 until the gig data model is finalized. ## Vocabulary diff --git a/docs/game-design/skills.md b/docs/game-design/skills.md index 66c4250..3fe1df6 100644 --- a/docs/game-design/skills.md +++ b/docs/game-design/skills.md @@ -165,7 +165,7 @@ Explicit **bonuses** when skill A + B cross a threshold vs **pure fiction** (“ | Area | Tie-in | |------|--------| -| [Epic 2](../decomposition/epics/epic_02_classless_progression.md) | Registry, XP engine, mastery, pacing | +| [Epic 2 — Classless Progression Framework](../decomposition/epics/epic_02_classless_progression.md) | Registry, XP engine, mastery, pacing | | [Epic 3](../decomposition/epics/epic_03_crafting_economy.md) | Gather and craft **award** skill XP; items and recipes | | [Epic 7](../decomposition/epics/epic_07_quest_faction.md) | Quest rewards, rep gates, optional skill payouts | | [gigs.md](gigs.md) | **Craft** combat gear with **skills**; **equip** with **gigs**—[Seams](#seams-gigs-skills) | diff --git a/docs/reviews/2026-04-03-branch-chore-game-design-docs-vs-main.md b/docs/reviews/2026-04-03-branch-chore-game-design-docs-vs-main.md index 09b164c..59953d2 100644 --- a/docs/reviews/2026-04-03-branch-chore-game-design-docs-vs-main.md +++ b/docs/reviews/2026-04-03-branch-chore-game-design-docs-vs-main.md @@ -49,7 +49,7 @@ None for **using the branch as design + schema guidance**. ## Nits -- **Epic title vs filename:** “Classless Skill and Progression” vs `epic_02_classless_progression.md` — fine; readers use **gigs** for combat naming. +- ~~**Epic title vs filename:**~~ **Addressed** — epic H1 and vision plan use **Classless Progression Framework** (matches `epic_02_classless_progression.md`); cross-links use the same name. - **`module_dependency_register.md`:** E2.M1 row could list **`allowedXpSourceKinds`** in the contract column when you next touch the register (cosmetic). - **Two review files:** `2026-03-31-…` vs this `2026-04-03-…` — keep both; this one is **branch-wide vs main**, the other is **skills-focused**. @@ -65,3 +65,4 @@ None for **using the branch as design + schema guidance**. - `epic_02_classless_progression.md` **E2.M1** module stub: non-combat **`SkillDef`**, categories, **`allowedXpSourceKinds`**, links to E2.M1 module + JSON Schema. - **Content CI:** `.github/workflows/pr-gate.yml` + `scripts/validate_content.py` + `scripts/requirements-content.txt`; CT.M1 / E2.M1 / `content/README` / internal-content-authoring updates. - **Decomposition language CI:** `scripts/check_decomposition_language.py` + PR gate + CT.M1 / docs-review-agent notes. +- **Epic 2 naming:** H1 + `neon_sprawl_vision.plan.md` + module/game-design link text → **Classless Progression Framework**. diff --git a/neon_sprawl_vision.plan.md b/neon_sprawl_vision.plan.md index b3c718a..4b56ff8 100644 --- a/neon_sprawl_vision.plan.md +++ b/neon_sprawl_vision.plan.md @@ -298,7 +298,7 @@ Transform the validated prototype into a scalable production-ready development m - **Scope:** Isometric camera runtime, character movement, interaction framework, input/ability scaffolding, moment-to-moment game feel. - **Success criteria:** Stable 3D isometric control loop feels responsive and readable across supported hardware tiers. -### Epic 2 - Classless Skill and Progression Framework +### Epic 2 - Classless Progression Framework - **Ownership focus:** Systems Design + Gameplay Engineering - **Scope:** Skill definitions, XP curves, unlock logic, mastery/perk unlocks, progression pacing controls. @@ -385,7 +385,7 @@ Module template: - Dependencies: E1.M3, E5.M1. - Stage target: Prototype. -### Epic 2 Modules - Classless Skill and Progression +### Epic 2 Modules - Classless Progression Framework - **E2.M1 SkillDefinitionRegistry** - Responsibility: Central catalog for skill metadata, category tags, unlock prerequisites.