Reorganize docs into category folders and drop the retired head-review page
Group the top-level docs into docs/project, docs/design, docs/assets and docs/process, each with its own README index. Delete the superseded docs/screens/head-review page and sheets. Rewrite every markdown link, absolute docs path and tool/test reference to the new locations, fix the pre-existing broken anchors and remove the dead Joke Shop photo-board link. check_docs OK, Python tooling 167/167.
This commit is contained in:
1 parent
045ed2a58f
commit
2ba40f3578
57 files changed
+406
-414
No files matched your search
@@ -2,7 +2,7 @@
|
||||
|
||||
Session memory for durable decisions, gotchas, and commands. Implementation history lives in
|
||||
`DONE.md`, user-facing changes in `CHANGELOG.md`, the live task list in `TODO.md`, and the
|
||||
canonical implemented-features list in `docs/development-status.md`.
|
||||
canonical implemented-features list in `docs/project/development-status.md`.
|
||||
|
||||
## Decisions
|
||||
|
||||
@@ -13,8 +13,8 @@ canonical implemented-features list in `docs/development-status.md`.
|
||||
- **AI-assisted asset review loop (2026-11-04):** head/face shape decisions use a concept +
|
||||
judge loop — generate a target concept (`generate_textures.generate_image`, Seedream) and use
|
||||
`tools/describe_image.py` as the vision judge, iterating until the judge's specific fixes
|
||||
converge. Review pages: `docs/screens/head-review/README.md`, `docs/3d-model-review.md`
|
||||
§AI-driven head rework.
|
||||
converge. Durable evidence: `docs/assets/3d-model-review.md` §AI-driven head rework; the
|
||||
retired head-review page was removed in the 2026-11-06 docs restructure.
|
||||
- **Project agent skills (2026-11-03):** two tracked skills live in `.agents/skills/`:
|
||||
`gig-line-blender-asset-contract` and `gig-line-release-qa`. They are guidance only,
|
||||
add no runtime dependency and are referenced from `tools/README.md`. The third-party
|
||||
@@ -24,7 +24,7 @@ canonical implemented-features list in `docs/development-status.md`.
|
||||
restaged for a late-night arrival. `VENUE_SPECS["tv_studio"]` is a 30.0 m variant of the 29.6 m
|
||||
Hollywood facade. One reference board serves both venues; never create a separate TV Studio board.
|
||||
- **Jimmy Kimmel Live = starting point:** the Hollywood first shift and the TV Studio arrival both
|
||||
begin at the El Capitan block. Stated in `docs/venues.md#hollywood-boulevard` and `docs/gameplay.md`.
|
||||
begin at the El Capitan block. Stated in `docs/design/venues.md#hollywood-boulevard` and `docs/design/gameplay.md`.
|
||||
- **Street-view limitation:** Google Street View panoramas need a Google API key or manual browser
|
||||
capture, so the local reference sets use DDG street-level photos instead.
|
||||
- **Image-recitation filter:** Gemini image models reject well-known branded facades (Comedy Store
|
||||
@@ -54,12 +54,12 @@ canonical implemented-features list in `docs/development-status.md`.
|
||||
privacy, Compatibility/Web cost and mesh collision. Accepted photo channels: team captures,
|
||||
permissioned user/volunteer photos, clearly licensed downloads; every set needs a
|
||||
provenance/consent sidecar. No runtime splat dependency in 0.10.0.
|
||||
- **0.10.0 balance protocol:** `docs/release-qa.md#balance-acceptance` defines targets/denominators for the
|
||||
- **0.10.0 balance protocol:** `docs/process/release-qa.md#balance-acceptance` defines targets/denominators for the
|
||||
36 venue/difficulty/phase cells, seeds 1–100, and access/emergency error rates. Gotcha:
|
||||
`_read_npc_truth()` is type-derived, not behaviour-derived; the emergency-fairness review must
|
||||
account for that oracle mismatch.
|
||||
- **Blender MCP is optional (2026-11-04):** setup and safe part workflow are in
|
||||
`docs/asset-tooling.md#optional-interactive-blender-mcp`. The headless flatpak scripts remain authoritative; MCP is
|
||||
`docs/assets/asset-tooling.md#optional-interactive-blender-mcp`. The headless flatpak scripts remain authoritative; MCP is
|
||||
never a build/CI/test/runtime dependency, and anything MCP touched must pass the
|
||||
CLI audit/fit gates.
|
||||
- **Character mesh cap (2026-11-05):** all characters use 24,000 tris / 24,000 glTF vertices
|
||||
@@ -108,7 +108,7 @@ canonical implemented-features list in `docs/development-status.md`.
|
||||
avatars. Head-turn offsets use `+basis.z` for the same reason.
|
||||
- **Release blockers (still open):** macOS unsigned, AI image provider terms/commercial rights not
|
||||
cleared, storefront/rating approval pending, external playtests and full hardware matrix pending.
|
||||
Recorded in `CREDITS.md`, `PRIVACY.md`, `docs/accessibility.md`, `docs/known-limitations.md`.
|
||||
Recorded in `CREDITS.md`, `PRIVACY.md`, `docs/design/accessibility.md`, `docs/design/known-limitations.md`.
|
||||
|
||||
- **Release roadmap (2026-11-05, owner):** `0.9.9` Quaternius pilot base (rig/export fix,
|
||||
rest-relative pose math, owner face/silhouette gate), `0.9.10` 12-role roster, `0.9.11`
|
||||
@@ -345,7 +345,7 @@ canonical implemented-features list in `docs/development-status.md`.
|
||||
|
||||
## Current State
|
||||
|
||||
v0.9.8 is published. The build covers the three venues, the shift loop, tutorial/campaign/
|
||||
v0.9.9 is published. The build covers the three venues, the shift loop, tutorial/campaign/
|
||||
checkpoints, the 0.9.3–0.9.8 polish/texture/integration/character passes and the Blender +
|
||||
realism asset pipeline (see `DONE.md` and `CHANGELOG.md`). The 12-character procedural library
|
||||
(realistic face + four crowd variants) and the Comedy Store map rebuild are complete.
|
||||
@@ -363,7 +363,7 @@ body defects (holes, unibrow, missing eyes) and the head-gear seating are fixed,
|
||||
the firefighter helmet is removed, and every head has an authored mouth. Gates: `audit` 12/12,
|
||||
`inspect` clean, `fit` OK, 24-NPC budget 174,976 tris / 0.85 ms, Godot 278/278, Python 167/167.
|
||||
The owner **accepted the roster on 2026-11-06** and the review page plus its sheets were then
|
||||
retired; durable evidence lives in `docs/3d-model-review.md` and `docs/blender-assets.md`. Release
|
||||
retired; durable evidence lives in `docs/assets/3d-model-review.md` and `docs/assets/blender-assets.md`. Release
|
||||
packaging was fixed the same day:
|
||||
excluding `tmp/`, `build/`, `docs/`, `tools/`, `src/test/` and `.agents/` from the export presets
|
||||
cut the Linux binary from 426 MB to 273 MB, and `tools/build_releases.sh` writes a SHA256SUMS file.
|
||||
@@ -381,6 +381,12 @@ code on the 62-joint rig, and the procedural rigs are visually unchanged. Verifi
|
||||
0.82 ms avg frame). The face/silhouette gate sheet and the three options are in
|
||||
the face-gate decision (owner chose the full swap).
|
||||
|
||||
Test counts as of 2026-11-05: Python 167/167, Godot 278/278, `check_docs` OK.
|
||||
Test counts as of 2026-11-06: Python 167/167, Godot 278/278, `check_docs` OK.
|
||||
|
||||
**Docs layout (2026-11-06):** `docs/` is grouped into `project/`, `design/`, `assets/` and
|
||||
`process/`; `adr/`, `screens/`, `screenshots/` and `blender_previews/` are unchanged.
|
||||
`docs/README.md` is the index and every category folder has a README (required by
|
||||
`tools/check_docs.py`). The retired `docs/screens/head-review/` page and its sheets were deleted;
|
||||
the MakeHuman fallback head is documented in `docs/assets/makehuman-head-review.md`.
|
||||
|
||||
<!-- b64: RWFzdGVyIGVnZzogYSByYXJlIHJhZGlvIHRyYW5zbWlzc2lvbiAiwr9Ew7NuZGUgZXN0w6EgbGEgbW90YT8iIGZpcmVzIHZpYSBHYW1lTWFuYWdlci5fbWF5YmVfcmFkaW9fZWFzdGVyX2VnZyAoMi41JSBjaGFuY2UgYWZ0ZXIgYSBzdWNjZXNzZnVsIHJhZGlvIGNhbGwpLiBTdHJpbmcga2V5IHJhZGlvLmVhc3Rlcl9lZ2cgaW4gY29udGVudC9zdHJpbmdzLmVuLmpzb24uIERvIG5vdCByZW1vdmUu -->
|
||||
Reference in new issue
Block a user