Re-plan the Blender tracks around the local skills and a 3D model review

AGENTS.md

@@ -28,7 +28,8 @@ The project should be developed in small, reviewable steps. Agents must keep pla
 
 `TODO.md` is the priority source. The active order is:
 
-1. unversioned development tracks (currently character development and local map development);
+1. unversioned development tracks (currently 3D model re-evaluation, character development and
+   local map development);
 2. versioned release milestones, in version order;
 3. future/unversioned candidates and deferred work.
 
@@ -36,6 +37,65 @@ Do not assign a version number to an unversioned track until its scope is accept
 release. When a version is assigned, it must be the next semantic version that matches the
 scope (major/minor/patch), not a placeholder.
 
+## Local Blender skills (development aid)
+
+The MIT `blender-skills` pack is installed locally at `.agents/skills/blender-skills/`
+(94 skills plus a shared `references/` folder). It is **gitignored on purpose**: it is not
+game content, not part of the build, tests, CI or release packages, and every contributor
+may or may not have it. Pi gates project `.agents/skills` behind project trust, so the
+trust prompt has to be accepted before the skills load; `/skill:blender-director` forces one.
+
+Use them when a task touches `tools/blender_assets.py`, `tools/npc_pipeline.py`,
+`tools/bake_ao.py`, `assets/models/blender/**`, or Blender-authored venue/prop geometry.
+
+### Routing
+
+Start with `blender-director` for anything multi-discipline, then load only the
+specialists the task needs:
+
+| Work | Skills |
+| --- | --- |
+| Plan/route a Blender task, reference photo match | `blender-director` |
+| Character mesh, face, hands, proportions | `character-artist`, `character-archetypes`, `retopology` |
+| Skeleton, weights, pose/contract rigging | `rigging` |
+| UV layout, texel density, UDIM | `uv-workflow` |
+| Bakery, atlas, normal/AO/ORM maps | `texture-workflow` |
+| PBR materials and shading | `materials` |
+| Screenshot-driven material/light iteration | `lookdev` |
+| Triangle/vertex budgets, naming, scene hygiene | `asset-optimization` |
+| LOD tiers and impostors | `lod-pipeline` |
+| Collision shapes and proxies | `collision-proxy` |
+| GLB export for Godot | `godot-export`, `export-pipeline` |
+| Gear, props, street furniture | `prop-artist`, `hard-surface` |
+| Trees, hedges, foliage cards | `vegetation-artist` |
+| Facades, venues, modular kits, dressing | `environment-artist`, `archviz`, `set-dressing`, `geometry-nodes` |
+| Lighting, framing, final render/composite | `lighting`, `camera-cinematography`, `rendering`, `compositing` |
+| Style direction (stylized / low-poly / realistic) | `stylized-style`, `lowpoly-style`, `realistic-style` |
+| Ship/no-ship review | `qa-review` |
+
+The same skills cover the local map track (procedural geometry, facade kits, OSM massing,
+splat reference renders) and the NPC roster work.
+
+### Project rules that override a skill
+
+1. **The project contract wins.** `npc_base` mesh node, the 13 contract bones at their rest
+   positions, five tint slots, front on Blender −Y / Godot +Z, grounded feet, 8,000
+   triangles / 8,000 glTF vertices per character, 1,500 per gear, 4,000 per prop. A skill
+   may recommend another topology, naming or budget scheme; do not adopt it unless the
+   change is explicitly planned and the contract, tests and docs are updated together.
+2. **There is no Blender MCP here.** The skills assume MCP tools; this project runs Blender
+   as headless flatpak scripts (`tools/blender_assets.py`, `tools/npc_pipeline.py`). Translate
+   MCP steps into script changes or CLI runs. Never add an MCP dependency to the build, CI or
+   runtime.
+3. **CI stays offline and skill-free.** Skills are local guidance only; every gate must still
+   work from a fresh checkout with committed `.glb`/`.png`/`.tres` files and Godot.
+4. **No new asset source without the licence gate.** Skills may suggest reference packs or
+   generated meshes; ADR-0015 (CC0, or CC-BY with attribution in `CREDITS.md`) and the
+   provenance rules in `docs/npc-model-sourcing.md` still apply.
+5. **Evidence, not vibes.** After a skill-informed change, run `blender_assets.py inspect`,
+   `audit` and `fit` plus the relevant capture/smoke gates, and say in the handoff which
+   skills informed the change and what the measurements were.
+
 ## Required Workflow
 
 ### 1. Start by Inspecting the Repository
@@ -268,6 +328,8 @@ Before handing off work, an agent must run every check below that applies to the
 - Run automated tests.
 - Run formatting, linting, or type checks.
 - Start the game or application and perform a basic smoke test.
+- For 3D/Blender changes: `blender_assets.py inspect`, `audit` and `fit`, the relevant capture
+  gate, and a note of which local skills informed the change.
 - Check that documentation and task status reflect the actual state.
 - Review the final diff for accidental changes or unfinished markers.