chore(agents): migrate to agents.md protocol — .agents/ wiki/plans/rules/skills

Root AGENTS.md is now a thin entry point + knowledge map; the batch-workflow
detail it duplicated already lived in .claude/skills/animation/SKILL.md.
Folded docs/ (dances registry + iclone-bridge stub), root plans/, and
devops-reports/ into .agents/wiki/ and .agents/plans/ per the per-repo .agents/
convention. Added .agents/SOUL.md, .agents/AGENTS.md, wiki/ARCHITECTURE.md,
wiki/architecture/, and wiki/master-plan.md (derived from the closed plans +
the dance registry's live ceremony-slot table). Fixed doc-path references in
exchange/GUIDE.md, the animation skill, and the iclone-bridge stub. All moves
via mv (git detected as renames) — no content deleted.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-07-24 15:02:47 -07:00
parent 28fdf940f7
commit 854dbb5ce4
25 changed files with 275 additions and 111 deletions
+56
View File
@@ -0,0 +1,56 @@
# 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/`).