Author the 62-to-13 joint map and align the AGENTS.md contract with the Quaternius base
Full build / Import + headless tests (push) Successful in 50s
Full build / Full desktop build + optional release (push) Skipped

This commit is contained in:
zwitschi committed 2026-11-05 20:48:55 +01:00
1 parent 8c69f367b0
commit 1ed9e05d9b
3 files changed
+43 -6

No files matched your search

+8 -5
View File
@@ -93,9 +93,11 @@ specialists the task needs:
1. **The project contract wins.** `npc_base` mesh node, the 13 required core bones at their rest
positions, five tint slots, front on Blender −Y / Godot +Z, grounded feet, 24,000
triangles / 24,000 glTF vertices per character, 1,500 per gear, 4,000 per prop. Optional
extra bones (fingers, face, toes) are allowed if they do not move the core rest positions. 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.
extra bones (fingers, face, toes) are allowed if they do not move the core rest positions. The
Quaternius 62-joint source rig is authoring-only and bakes to this 13-core contract
(ADR-0017); it is not a runtime dependency. 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. **Blender MCP is optional interactive tooling.** The headless flatpak scripts
(`tools/blender_assets.py`, `tools/npc_pipeline.py`) remain authoritative. MCP may be used
for local part exploration; setup and safety are in [`docs/asset-tooling.md#optional-interactive-blender-mcp`](docs/asset-tooling.md#optional-interactive-blender-mcp).
@@ -104,8 +106,9 @@ specialists the task needs:
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.
generated meshes; ADR-0017 (the CC0 Quaternius NPC base) supersedes the generator-first
decision in ADR-0015, and the CC0/CC-BY rule in ADR-0015 (attribution in `CREDITS.md`) plus
the provenance rules in `docs/npc-model-sourcing.md` still apply to any new source.
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.