humanoid-animation

Humanoid animation (Plan 011 route)

Meshy humanoid rig + preset motions → packaged onto the exact production mesh → Plan 009 gates, reels, Unity Humanoid install → operator review. Read RULES.md first; follow WORKFLOW.md step by step. Creature (non-humanoid) work uses the creature-animation skill instead.

Quick start (Malachar pilot shape)

Checklist per subject

1. Contract from ArtSource/3D/Roster/subjects.json (Cast only for casters); calibration entry in calibration.py derived from MESHY_HUMANOID with the subject's rigid parts.
2. Rig input: body only, rest A-pose, production textures as preview; weapons/quivers/pauldron props excluded and named for re-attachment.
3. Meshy rig with markers checked (chin, shoulders, elbows, wrists, groin at the crotch, knees, ankles); record task, cost, balance in the ledger.
4. One preset per semantic chosen for the role (see RULES.md); record exact preset names in the plan record.
5. Package, gate, reel; fix what the gates flag with the packager passes (--ground-clamp, --plant-feet, --lock-feet, --posture-relax, --hand-guard), never with thresholds. Non-human proportions (ogre: short splayed legs, long arms) need --leg-splay and --hand-guard too; upright heroes may need only the clamp.
6. Look at the frames from more than the review camera (front and side) before sending a reel: a held part can hide behind the body, and legs pulled under the hips read as glued together. Seat weapons with --grip Part=bone,fraction,up|down (the shaft crosses the fist, never continues the forearm); up avoids floor contact when the arm hangs.
7. Unity install through the project installer (Humanoid avatar from the Mixamo skeleton), generated-model EditMode tests, reel sent to the operator, commit with explicit paths.

Do not

• Upload raw provider assets or anything but the derived body-only rig input; never publish to the Meshy community (Private license).
• Treat a technical pass as art acceptance, or reuse a preset for a role it does not read as (a sword swing is not a staff cast).
• Commit Unity meta/settings noise or another agent's dirty files; push through a separate worktree when the shared checkout is dirty.