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.

.agents/skills/gig-line-blender-asset-contract/SKILL.md

@@ -24,7 +24,7 @@ The project contract and measured gates override any generic Blender advice.
 Blender MCP is optional interactive tooling; the headless flatpak CLI remains
 authoritative and CI never needs Blender or MCP. The `blender-skills` pack is
 optional, local guidance only, and gitignored. Setup and safety are in
-`docs/asset-tooling.md#optional-interactive-blender-mcp`.
+`docs/assets/asset-tooling.md#optional-interactive-blender-mcp`.
 
 ## Read first
 
@@ -33,11 +33,11 @@ skill alone:
 
 1. `AGENTS.md` — required workflow and verification.
 2. `TODO.md` and `MEMORY.md` — current track, claimed tasks, known gotchas.
-3. `docs/blender-assets.md` — library contract and command reference.
-4. `docs/asset-tooling.md` — exact rebuild/bake/capture commands.
-5. `docs/npc-model-sourcing.md` and `docs/3d-model-review.md` — accepted limits,
+3. `docs/assets/blender-assets.md` — library contract and command reference.
+4. `docs/assets/asset-tooling.md` — exact rebuild/bake/capture commands.
+5. `docs/assets/npc-model-sourcing.md` and `docs/assets/3d-model-review.md` — accepted limits,
    scorecards and known blockers.
-6. `docs/known-limitations.md` — limits that must not be silently “fixed” into
+6. `docs/design/known-limitations.md` — limits that must not be silently “fixed” into
    contract changes.
 
 The contract lives in code and docs, not in this skill. If they disagree, stop
@@ -114,7 +114,7 @@ only the specialists the task needs:
 - budget/LOD/collision: `asset-optimization`, `lod-pipeline`, `collision-proxy`
 - final review: `qa-review`
 
-If MCP is available, use it for interactive part exploration only; mirror the result into a scripted change or local `.blend`, then re-export and run the CLI audit/fit gates. Never make the build, CI, tests or runtime depend on MCP. Setup: `docs/asset-tooling.md#optional-interactive-blender-mcp`.
+If MCP is available, use it for interactive part exploration only; mirror the result into a scripted change or local `.blend`, then re-export and run the CLI audit/fit gates. Never make the build, CI, tests or runtime depend on MCP. Setup: `docs/assets/asset-tooling.md#optional-interactive-blender-mcp`.
 
 ### 4. Build or bake
 
@@ -185,7 +185,7 @@ gates run, and any accepted limit.
 - **Empty or stale captures** — close modals/pause, check the capture script's
   settle frames, and remove stale output directories before re-running.
 - **Pose harness mismatch** — the current `capture_npc_pose.gd` is blocked per
-  `docs/3d-model-review.md`; do not use its frames as pose evidence until the
+  `docs/assets/3d-model-review.md`; do not use its frames as pose evidence until the
   recipe is fixed.
 - **Asset test fails after import** — re-run audit/fit first, then import; if the
   manifest or AO path changed, rebuild the affected asset rather than editing
@@ -197,7 +197,7 @@ gates run, and any accepted limit.
 
 - [`references/asset-contract.md`](references/asset-contract.md) — full contract,
   inventory, file locations and provenance rules.
-- `docs/asset-tooling.md#optional-interactive-blender-mcp` — optional MCP installation, connection, safety and
+- `docs/assets/asset-tooling.md#optional-interactive-blender-mcp` — optional MCP installation, connection, safety and
   part-workflow instructions.
 - [`references/verification.md`](references/verification.md) — command matrix,
   capture gates, expected results and acceptance criteria.

.agents/skills/gig-line-blender-asset-contract/references/asset-contract.md

@@ -1,7 +1,7 @@
 # Asset Contract Reference
 
 This is a working summary. The authoritative sources remain
-`docs/blender-assets.md`, `docs/asset-tooling.md`, ADR-0013, the tests in
+`docs/assets/blender-assets.md`, `docs/assets/asset-tooling.md`, ADR-0013, the tests in
 `src/test/tests/` and the constants in `tools/blender_assets.py` /
 `tools/npc_pipeline.py`.
 

.agents/skills/gig-line-blender-asset-contract/references/verification.md

@@ -113,8 +113,8 @@ For each changed variant, inspect at least:
 - Day and night/LATE final-context frames.
 - Front, three-quarter and profile for a shape change.
 
-Accepted stylized limits are in `docs/3d-model-review.md` and
-`docs/known-limitations.md`. Do not turn an accepted limit into an unreviewed
+Accepted stylized limits are in `docs/assets/3d-model-review.md` and
+`docs/design/known-limitations.md`. Do not turn an accepted limit into an unreviewed
 contract change.
 
 ## Final diff review

.agents/skills/gig-line-release-qa/SKILL.md

@@ -19,9 +19,9 @@ publishing, and the full visual/QA gate. For a Blender/asset rebuild, use
 
 1. `AGENTS.md` — release procedure and verification rules.
 2. `TODO.md` — current milestone, blockers and release exit criteria.
-3. `docs/RELEASING.md` — build/publish commands, artifact list, macOS policy.
-4. `docs/release-qa.md` — manual QA matrix and balance protocol.
-5. `docs/development-status.md`, `CHANGELOG.md`, `README.md` — current claims.
+3. `docs/process/RELEASING.md` — build/publish commands, artifact list, macOS policy.
+4. `docs/process/release-qa.md` — manual QA matrix and balance protocol.
+5. `docs/project/development-status.md`, `CHANGELOG.md`, `README.md` — current claims.
 6. `MEMORY.md` — release gotchas, especially the clean-worktree rule.
 
 A release is not just a tag. It includes a version bump, changelog, clean build,
@@ -58,8 +58,8 @@ Update:
 
 1. `project.godot` `config/version`.
 2. `CHANGELOG.md` with a dated entry.
-3. `README.md`, `PLAN.md`, `docs/architecture.md`,
-   `docs/development-status.md`, `TODO.md`/`DONE.md` and `MEMORY.md` as needed.
+3. `README.md`, `PLAN.md`, `docs/project/architecture.md`,
+   `docs/project/development-status.md`, `TODO.md`/`DONE.md` and `MEMORY.md` as needed.
 
 For a release candidate, use a prerelease version only if the project policy
 allows it and never present it as the final release.
@@ -213,7 +213,7 @@ The default `RETAIN_RELEASES=0` never prunes.
 
 ### 7. Post-release record
 
-Update `README.md`, `docs/development-status.md`, `MEMORY.md`, `CHANGELOG.md`,
+Update `README.md`, `docs/project/development-status.md`, `MEMORY.md`, `CHANGELOG.md`,
 `TODO.md`/`DONE.md` and the release page with the built/CI result. Commit the
 release record and push. Record any skipped check and the reason; never leave a
 tag with unreported missing verification.

.agents/skills/gig-line-release-qa/references/qa-gates.md

@@ -93,7 +93,7 @@ python3 tools/screen_designs.py judge --model auto
 ```
 
 Record model, confidence/verdict summary, `diff` count and any manual review.
-`docs/ui-copy.md#screen-design-judge-report` is the durable record.
+`docs/design/ui-copy.md#screen-design-judge-report` is the durable record.
 
 ## 6. Realism judge (when visual assets/lighting changed)
 

.agents/skills/gig-line-release-qa/references/release-runbook.md

@@ -1,6 +1,6 @@
 # Release Runbook
 
-Authoritative source: `AGENTS.md` (Release Procedure), `docs/RELEASING.md`.
+Authoritative source: `AGENTS.md` (Release Procedure), `docs/process/RELEASING.md`.
 This runbook is the operational checklist; if it conflicts with those, they win.
 
 ## 0. Decide the release
@@ -29,8 +29,8 @@ Files to update:
 | `project.godot` | `config/version="X.Y.Z"` |
 | `CHANGELOG.md` | dated `## [X.Y.Z] — YYYY-MM-DD` entry |
 | `README.md` | latest/current version and summary |
-| `PLAN.md` / `docs/architecture.md` | current version reference |
-| `docs/development-status.md` | shipped capability/release result |
+| `PLAN.md` / `docs/project/architecture.md` | current version reference |
+| `docs/project/development-status.md` | shipped capability/release result |
 | `TODO.md` / `DONE.md` | close/move milestone when complete |
 | `MEMORY.md` | release state and gotchas |