docs: reframe game around recruit-line auto battles

2026-08-10 22:46:33 +08:00
parent ac0dec2584
commit 49e4e7bdca
23 changed files with 362 additions and 183 deletions
@@ -0,0 +1,10 @@
+# Context: ABG-V2-CONTENT-MATRIX
+
+- Read repository `AGENTS.md` and portfolio rules.
+- Read `.agent-taskgraph/spec.md` revision `design-spec-r2`.
+- Read `docs/reference/REFERENCE_RUNTIME_CENSUS.md` and
+  `docs/reference/TRANSFERABLE_STRUCTURE_LESSONS.md` only for transferable
+  structure and uncertainty boundaries.
+- Read the current `docs/content/` package to replace fixed-character and
+  relationship assumptions without preserving obsolete scope.
+- Ignore old queue Goals and old worker branches; this Goal is the only authority.
@@ -0,0 +1,10 @@
+# Dispatch: ABG-V2-CONTENT-MATRIX
+
+- Dispatch ID: `dispatch:ABG-V2-CONTENT-MATRIX:r1`
+- Role: `role:content-architect`
+- Team revision: `rev-2`
+- Goal: `task:ABG-V2-CONTENT-MATRIX`
+- Context revision: `1`
+- Runtime: HAPI visible Codex `gpt-5.6-sol / xhigh / yolo`
+- Session: PENDING
+- Identity ACK: PENDING
@@ -0,0 +1,63 @@
+# Goal: ABG-V2 Complete Recruit And Content Matrix
+
+> Task ID: `ABG-V2-CONTENT-MATRIX`
+> Frozen spec: `.agent-taskgraph/spec.md` revision `design-spec-r2`
+> Graph node: `v2_content_matrix`
+> Baseline: PMO redesign baseline commit on `main`
+> Legal terminal: `ABG-V2-CONTENT-MATRIX candidate ready` or `ABG-V2-CONTENT-MATRIX redesign required: <earliest failed boundary>`
+
+## Objective
+
+Replace the fixed-character story package with complete generated-recruit and
+combat-content matrices for an original horizontal-line auto-battler.
+
+## Exclusive Writes
+
+- All files under `docs/content/` and no files outside it.
+- Replace or rename `CHARACTER_BIBLE.md` into a generated recruit authority;
+  preserve Git history through an explicit rename when appropriate.
+
+## Exact Content Envelope
+
+- 12 base professions, each mechanically distinct.
+- 24 regular advanced professions, exactly two per base profession.
+- 6 hidden hybrid professions with cross-profession prerequisites.
+- 36 lightweight mechanical traits with benefit, cost, visibility and
+  prohibited combinations.
+- 320 equipment items with stable IDs; at least 160 change targeting, timing,
+  reach, formation order, resource flow, status rules or profession behavior.
+- 60 artifacts that modify run-wide rules rather than duplicate equipment.
+- 100 ordinary/elite enemies plus 16 bosses across 8 regions.
+- Minimal regional framing, progression and encounter grammar; no fixed hero
+  relationships, romance, personal arcs or individual voice requirements.
+
+## Required Schemas
+
+- Recruit generation: name pool, modular visual parts, profession, attribute
+  roll, trait, starting equipment, level, cost, rarity boundaries and duplicate
+  rules.
+- Profession: role, preferred line band, basic action, resource, passive,
+  upgrade choices, target/reach rules, counters, synergies, AI cadence,
+  animation/VFX/audio production needs and hidden-branch prerequisites.
+- Equipment/artifact/enemy/boss/region rows must state their actual decision
+  effect and production needs; name-only or percentage-only rows are invalid.
+- Cross-reference every ID and provide exact count/no-filler checks that the
+  integration task can automate.
+
+## Acceptance
+
+- Exact counts reconcile and all references resolve.
+- Repeated professions are legal across recruits; no content row assumes a
+  unique authored protagonist.
+- Every base profession has two regular upgrades and participates in at least
+  one hidden hybrid path.
+- Every region introduces new enemy behavior and build pressure, not only
+  larger statistics.
+- Commit only `docs/content/`; leave worktree clean and report commit, count
+  commands and open human gates.
+
+## Frozen
+
+No runtime, UI/prototype, final art/audio generation, package, release or
+commercial reference copying. Do not edit product schemas; report a blocker if
+the frozen spec cannot support the content matrix.
@@ -0,0 +1,5 @@
+# Ledger: ABG-V2-CONTENT-MATRIX
+
+| Time | State | Evidence | Next action |
+|---|---|---|---|
+| 2026-08-10T22:38:28+08:00 | inbox | Owner-approved design-spec-r2 and graph-r3 | Spawn and verify visible HAPI worker |
@@ -0,0 +1,9 @@
+# Context: ABG-V2-CORE-SYSTEMS
+
+- Read repository `AGENTS.md` and portfolio rules.
+- Read `.agent-taskgraph/spec.md` revision `design-spec-r2`.
+- Read `docs/reference/REFERENCE_RUNTIME_CENSUS.md` and
+  `docs/reference/TRANSFERABLE_STRUCTURE_LESSONS.md` as evidence-labeled
+  structural references only.
+- Read the four current product documents to identify everything superseded.
+- Ignore old queue Goals and old worker branches; this Goal is the only authority.
@@ -0,0 +1,10 @@
+# Dispatch: ABG-V2-CORE-SYSTEMS
+
+- Dispatch ID: `dispatch:ABG-V2-CORE-SYSTEMS:r1`
+- Role: `role:systems-designer`
+- Team revision: `rev-2`
+- Goal: `task:ABG-V2-CORE-SYSTEMS`
+- Context revision: `1`
+- Runtime: HAPI visible Codex `gpt-5.6-sol / xhigh / yolo`
+- Session: PENDING
+- Identity ACK: PENDING
@@ -0,0 +1,60 @@
+# Goal: ABG-V2 Recruit-Line Core Systems
+
+> Task ID: `ABG-V2-CORE-SYSTEMS`
+> Frozen spec: `.agent-taskgraph/spec.md` revision `design-spec-r2`
+> Graph node: `v2_core_systems`
+> Baseline: PMO redesign baseline commit on `main`
+> Legal terminal: `ABG-V2-CORE-SYSTEMS candidate ready` or `ABG-V2-CORE-SYSTEMS redesign required: <earliest failed boundary>`
+
+## Objective
+
+Replace the fixed-cast, six-unit, three-lane product authority with a complete,
+original recruit-line auto-battler contract.
+
+## Exclusive Writes
+
+- `docs/product/GAME_PRODUCT_CONTRACT.md`
+- `docs/product/SYSTEMS_AND_BATTLE.md`
+- `docs/product/ECONOMY_AND_BALANCE.md`
+- `docs/product/SAVE_AND_FAILURE_CONTRACT.md`
+
+Do not edit root, content, reference, presentation, prototype, review or
+taskgraph files.
+
+## Required Design
+
+- One ordered horizontal party line; explicit front-to-rear targeting,
+  protection, reach, projectile, healing, movement, push/pull, summon footprint,
+  death-collapse and replacement rules.
+- Repeated shop loop with recruit, equipment, combat offer, reroll and lock;
+  price pressure must remain recoverable after deaths.
+- Generated recruits use fixed profession catalog schema, attributes, one
+  lightweight trait and equipment. No relationships or personal story arcs.
+- Simultaneous capacity grows from a small opening toward a simulation-selected
+  10-12 target. Cumulative run recruitment remains independent from capacity.
+- Fully automatic combat with only prepare/reorder/equip/start/pause/speed/
+  inspect/retreat controls.
+- Deterministic formulas, target rules, status ordering, damage floor, critical
+  resolution, battle cap and causal result explanation.
+- Five pacing profiles with explicit shop/battle/decision timestamps, economy
+  solvency, recovery, no dominant reroll/recruit/dismiss strategy and 15-25 hour
+  first-clear target.
+- Complete versioned save/failure contracts including atomic pending/applied
+  operations, retry, migration, corruption, duplicate claim, interruption,
+  rollback, clock rollback and bounded offline behavior.
+
+## Acceptance
+
+- Search finds no authoritative requirement for fixed 30 protagonists,
+  relationship systems, six-unit combat, three lanes, Directive, Anchor or
+  Cache battle mechanics.
+- All four documents use one vocabulary and one formula authority.
+- Existing design validator is updated only by PMO/integration later; worker
+  reports any validator assumptions that no longer match rather than editing it.
+- Commit only the four owned documents; leave worktree clean and report commit,
+  checks and open human gates.
+
+## Frozen
+
+No runtime, engine, UI, art/audio generation, package, release or reference
+asset copying. Do not silently change the content counts in design-spec-r2.
@@ -0,0 +1,5 @@
+# Ledger: ABG-V2-CORE-SYSTEMS
+
+| Time | State | Evidence | Next action |
+|---|---|---|---|
+| 2026-08-10T22:38:28+08:00 | inbox | Owner-approved design-spec-r2 and graph-r3 | Spawn and verify visible HAPI worker |