tinqs/animation
5
0
Fork 0
Code Pull Requests Actions Packages Projects Releases Wiki Activity Issues

docs(naming): ceremony codes follow game item-id convention (snake_case DanceType)

Browse Source 
13 ceremony slots tabled in the registry (12 DanceType + rain_dance),
provisional ids now nd_##; codes like war_dance_01 / WarDance01.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Jeremy
2026-07-16 14:36:03 -07:00
parent 6a1290b1d1
commit 9b190e742e
2 changed files with 41 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.claude/skills/animation/SKILL.md
+10 -9
View File
@@ -32,15 +32,16 @@ This skill is the accumulated **do-it-this-way** knowledge from real runs.
Blender here is **5.1.2**. When running from this repo the `--target` is **required** — the tool's default target path is ariki-relative and won't resolve.
## Naming system (registry: `docs/dances/REGISTRY.md` — read it, it is the source of truth)
Two-stage names. **New dances get a provisional id, never a content name**: at
conversion, assign the next free `nd##` from the registry — pack `nd08`, clip `ND08`,
JSON `nd08.json`, variants `nd08_pp`/`ND08PP` — regardless of what the PC export was
called (a take named "firedance1" turned out to be dance1's choreography). Only when
Jeremy **adopts** a take for a specific in-game dance is it renamed to its dance code —
codes are named after the **dance ceremony** the take corresponds to: `<ceremony><NN>`
lowercase-ascii pack (`powhiri01`, `hulakahiko01`, `sivaafi01`), PascalCase clip
(`Powhiri01`) — via `tools/rename_clip.py` + JSON rename + registry update. Never
guess the ceremony; Jeremy assigns it. Rejected takes are archived
Two-stage names, following the **game's item-id convention (lowercase snake_case)**.
**New dances get a provisional id, never a content name**: at conversion, assign the
next free `nd_##` from the registry — pack `nd_08`, clip `ND08`, JSON `nd_08.json`,
variants `nd_08_pp`/`ND08PP` — regardless of what the PC export was called (a take
named "firedance1" turned out to be dance1's choreography). Only when Jeremy **adopts**
a take for a specific in-game dance ceremony is it renamed to its dance code —
snake_case of the sim's `DanceType` enum + index: pack `war_dance_01`, clip
`WarDance01`, variants `war_dance_01_pp`/`WarDance01PP`. The 13 ceremony slots are
tabled in the registry. Rename via `tools/rename_clip.py` + JSON rename + registry
update. Never guess the ceremony; Jeremy assigns it. Rejected takes are archived
(`archive/` here; `archive/dances/` in ariki-game, which is `.gdignore`d), never deleted.
Numbers are never reused. Always update the registry row when converting/adopting/archiving.