feat: publish complete preproduction prototype

2026-08-10 21:00:58 +08:00
parent 28e857a4c0
commit f8c665055f
38 changed files with 7049 additions and 12 deletions
@@ -0,0 +1,73 @@
+# Pre-Development Readiness Audit
+
+Date: 2026-08-10
+
+## Decision
+
+The complete static design package and owner-facing HTML prototype are ready
+for owner review. Formal game implementation remains frozen. This result does
+not claim that the game is playable, understandable, fun, visually accepted,
+heard, device-verified, packaged, or release-ready.
+
+## Verified Design Authority
+
+| Domain | Verified scope | Current result |
+|---|---|---|
+| Product | original fantasy, audience, 25-35 hour campaign, full completion and postgame | specified |
+| Battle and systems | six-person formation, telegraphs, Directives, automation, failure and recovery | specified and cross-checked |
+| Economy and save | 1,700 authored minutes, five pacing traces, prices, caps, atomic save and corruption handling | static validator pass |
+| Content | 30 characters, 36 professions, 100 enemies, 320 items, 8 chapters, 48 achievements, 20 collections | complete indexed rows |
+| Pages and states | 82 pages, 24 chapter visual families, onboarding, accessibility, localization, errors and exits | complete indexed rows |
+| Art production | character, profession, enemy, item, environment, UI, animation and VFX identities | production catalog complete; final assets open |
+| Audio production | 30 music suites, 94 ambience configurations, at least 2,602 bilingual voice assets, 710 SFX identities | production catalog complete; generation/listening open |
+| HTML prototype | 11 views, 82-screen selector, 17-step flow, 8 chapters and searchable content catalogs | browser verified |
+
+## Reproducible Local Checks
+
+Run from the repository root while the site is served on port `8766`:
+
+```bash
+python3 tools/validate_design_contracts.py
+python3 tools/build_prototype_data.py
+node --check prototype/site/app.js
+node --check tools/verify_prototype.js
+NODE_PATH=/Users/wusumac/Documents/Projects/hapi/node_modules node tools/verify_prototype.js
+git diff --check
+```
+
+Expected design marker:
+
+```text
+ABG_DESIGN_CONTRACTS_OK chapter_minutes=1700
+gaps={'normal':150,'active':110,'efficient':160,'adversarial':130,'returning':140}
+recruit_cap=250 counter_cap=180 cache_vectors=5 damage_floor=6
+```
+
+Expected prototype markers:
+
+```text
+ABG_PROTOTYPE_DATA_OK screens=82 characters=30 professions=36 enemies=100 items=320 chapters=8 achievements=48 collections=20
+ABG_PROTOTYPE_BROWSER_OK views=11 screens=82 flow_steps=17 chapters=8 responsive=desktop,tablet,phone_portrait,phone_landscape
+```
+
+## Owner Review Order
+
+1. Complete the 17-step core flow and name any step whose purpose or result is
+   unclear.
+2. Inspect all eight chapter directions and judge whether each promises a
+   strategically and visually different problem.
+3. Inspect the 82-screen map for missing pages, crowded pages, unclear primary
+   actions, and unsafe exits.
+4. Search the complete content catalogs and challenge roles, counters,
+   progression relationships, and production feasibility.
+5. Accept, revise, or reject the visual direction and product scope before a
+   CH-01 runtime vertical-slice Goal is opened.
+
+## Open Gates
+
+- Owner visual acceptance and page-by-page comprehension.
+- Human judgment of choice quality, fun, pacing and willingness to continue.
+- Final art selection, production, integration, animation and runtime review.
+- Music, ambience, voice and SFX production plus human listening.
+- Engine implementation, simulation, runtime, physical device and persistence.
+- Packaging, signing, store records, submission, publishing and release.