# Master plan — animation repo

What's in flight and recently shipped. See `.agents/plans/` for the closed-out
plan/results docs behind these items; see `.agents/wiki/dances/REGISTRY.md` for
the live per-clip status table (source of truth, not duplicated here).

## Recently shipped (closed plans, folded into wiki)

- **Animation-gen pipeline** (2026-07-13) — the FBX→Blender-retarget→GLB→dance-JSON
  bridge itself; core of `.agents/wiki/ARCHITECTURE.md` today.
- **Animation skills adoption** (2026-07-13) — `.claude/skills/animation*`,
  `iclone-video-mocap`, `pose-estimation` brought in as repo skills.
- **Loop fix** (2026-07-16, plan + results) — `tools/loop_fix.py` (de-drift/trim/
  seam-blend) and `tools/pingpong_bake.py` shipped; every adopted dance now ships
  as a base clip + `_pp` pair, gated by `tools/loop_qc.py`.
- **Boat prop export** (2026-07-17, plan + fixes + results) — `tools/export_boat_prop.py`
  staging pipeline for the boat action-clip set (see "Boat actions" below).
- **Animation-standard convergence** (2026-07-23/24, `.agents/wiki/devops-reports/`) —
  full audit against ariki-game's animation-standardization contract. Result:
  pipeline core already conformant (100% of runtime clip GLBs on the 65-bone
  Quaternius rig, all `_pp` pairs present, dance JSONs clean). Fixes landed:
  registry corrections (`tide_dance_01` has no sim enum entry — flag before
  filming; `rain_dance_01` confirmed in-enum), `iclone-bridge.md` written
  (previously a dead reference), QC-tool split documented (`loop_qc.py` here =
  pre-commit gate, `ariki-game/tools/anim_qc.py` = post-ingest gate).
- **agents.md migration** (2026-07-24, this change) — repo restructured onto the
  open agent protocol: root `AGENTS.md` (thin) + `.agents/` (SOUL, wiki, plans,
  skills-pointer). `docs/` and root `plans/`/`devops-reports/` folded into
  `.agents/wiki/`.

## In flight — ceremony dance slots awaiting a take

Per `.agents/wiki/dances/REGISTRY.md`, adopted so far: `fertility_dance_01`
(hula), `taming_dance_01`, `war_dance_01` (haka) — each shipped with its `_pp`
loop. One provisional take (`nd_01`, baraka1) is filmed and QC-passed but not
yet assigned to a ceremony. Still **awaiting a take**: `water_dance_01`,
`fire_dance_01`, `food_dance_01`, `sailing_dance_01`, `building_dance_01`,
`colony_shield_dance_01`, `age_progression_dance_01`, `star_watching_dance_01`,
`rain_dance_01`. `tide_dance_01` has no confirmed sim `DanceType` entry — resolve
with Ozan before filming.

## In flight — boat action clips

Staging tooling (`tools/export_boat_prop.py`) is built and the boat prop rig
verified; the action-clip set itself is **awaiting takes**: `boat_dive`,
`boat_climb`, `boat_collect`, `boat_row_loop`, `boat_fish_loop`,
`boat_sail_idle`. Two boat-adjacent clips are already live in-game
(`CanoeDismount`/`CanoeSitIdle`, `run_to_dive`) but predate this registry and
need a `boat_*` code assigned at the next adoption pass.

## Open threads

- `tools/kevin_retarget.py` has a hardcoded, non-portable target path — fine for
  now, flagged in `AGENTS.md` gotchas.
- `.claude/skills/retarget-animations/` is kept only for history (deprecated,
  superseded by the per-source retargeters in `tools/`).