Character Motion Review Panel
Grounded review loop for animated character motion. This is for movement,
silhouette, staging, and performance quality, not generic UI review.
Review Contract
- Review fresh pixels from the current code. Do not reuse old scores.
- Every panelist must base comments on rendered frames they actually inspect.
- Scope the prompt to the active clip. If the user says dance only, do not bring
in walk, run, or kick.
- If judging choreography, prefer a static camera capture first. Add camera
review only when the camera itself is in scope.
- Mention only artifacts present in the rendered material. Do not prime panelists
with absent objects or old issues.
- Use grumpy scoring:
8 means good but polish remains, 9 means strong, 10
means production-grade and hard to improve.
Capture First
Use the repo's deterministic render harnesses before convening the panel:
GRID_CLIPS=dance GRID_FRAMES=16 GRID_COLS=8 GRID_SCALE=0.75 GRID_LIVE=1 \
fvm flutter test test/features/character/frame_grid_test.dart
For suspected snaps or jumps, use temporal-animation-diff before asking humans
to guess. Dense frame diffs should identify exact frame pairs and phases.
For scene/camera/backdrop judgement, render the actual production path rather
than a fallback or placeholder. Use cinematic-render-panel when the main
question is lighting, scenery, or camera frame quality rather than body motion.
Default Expert Lenses
Use 4-6 reviewers. Pick the smallest set that covers the user's complaint:
- Afrobeats dance coach: groove authenticity, pocket, call-and-response,
downbeat/offbeat feel, whether the move vocabulary reads as Afrobeats.
- Character animator: pose appeal, arcs, anticipation, overshoot,
follow-through, silhouettes, head/hand readability.
- MoCap/biomechanics analyst: physical plausibility, support foot, hips vs
legs, impossible side-to-side travel, weight transfer.
- Cartoon performance director: charm, exaggeration, squash/stretch,
comedic timing, readable personality.
- Music-video director/cinematographer: camera, staging, ensemble spacing,
whether the shot sells the performance.
- Technical animation reviewer: rig seams, ribbons/mesh artifacts, z-order,
foot locks, discontinuities.
Prompt Template
Give each reviewer the same artifact list and scope:
Read these rendered frame strips/stills from the current code:
<paths>
Scope: judge <dance/walk/kick/camera/backdrop>. Ignore unrelated clips.
Return:
SCORE: single 0-10 number
TOP 3 BLOCKERS: ranked, evidence tied to a visible frame/phase
TOP 3 FIXES: concrete, implementable changes
ONE-LINE VERDICT: highest-leverage next move
For Afrobeats work, add:
Judge whether this feels like a Lagos/Afrobeats music-video groove rather than
generic boy-band posing. Prioritize pocket, hips, footwork, call-and-response,
and relaxed confidence over big random arm gestures.
After The Panel
- Cluster repeated findings across reviewers.
- Fix the highest-leverage body/choreo issue first, not a scattered set of
cosmetic comments.
- Re-render the same capture and re-rate. Scores are valid only for the pixels
that were reviewed.
- Add or adjust focused tests when a finding maps to a measurable invariant:
bounded head displacement, no torso/hip detachment, no arm hiding behind the
belly, no large adjacent-frame centroid jump, valid support-foot spans.
See Also
choreo-phrase-authoring when the issue is weak or unstructured dance data.temporal-animation-diff when the issue is snapping/jumps/discontinuity.cinematic-render-panel when the issue is scenery, lighting, or camera.
1---2name: character-motion-review-panel3description: Run a grounded expert panel on character animation using real rendered frame strips, dense frame captures, or video stills. Use when motion looks robotic, lame, snappy, wobbly, drunk, physically impossible, off-beat, weakly choreographed, or when the user asks to convene a dance coach, animator, MoCap/biomechanics, cartoon animation, cinematography, or music-video expert panel for the cat dance/walk/kick.4---56# Character Motion Review Panel78Grounded review loop for animated character motion. This is for movement,9silhouette, staging, and performance quality, not generic UI review.1011## Review Contract1213- Review fresh pixels from the current code. Do not reuse old scores.14- Every panelist must base comments on rendered frames they actually inspect.15- Scope the prompt to the active clip. If the user says dance only, do not bring16 in walk, run, or kick.17- If judging choreography, prefer a static camera capture first. Add camera18 review only when the camera itself is in scope.19- Mention only artifacts present in the rendered material. Do not prime panelists20 with absent objects or old issues.21- Use grumpy scoring: `8` means good but polish remains, `9` means strong, `10`22 means production-grade and hard to improve.2324## Capture First2526Use the repo's deterministic render harnesses before convening the panel:2728```bash29GRID_CLIPS=dance GRID_FRAMES=16 GRID_COLS=8 GRID_SCALE=0.75 GRID_LIVE=1 \30 fvm flutter test test/features/character/frame_grid_test.dart31```3233For suspected snaps or jumps, use `temporal-animation-diff` before asking humans34to guess. Dense frame diffs should identify exact frame pairs and phases.3536For scene/camera/backdrop judgement, render the actual production path rather37than a fallback or placeholder. Use `cinematic-render-panel` when the main38question is lighting, scenery, or camera frame quality rather than body motion.3940## Default Expert Lenses4142Use 4-6 reviewers. Pick the smallest set that covers the user's complaint:4344- **Afrobeats dance coach:** groove authenticity, pocket, call-and-response,45 downbeat/offbeat feel, whether the move vocabulary reads as Afrobeats.46- **Character animator:** pose appeal, arcs, anticipation, overshoot,47 follow-through, silhouettes, head/hand readability.48- **MoCap/biomechanics analyst:** physical plausibility, support foot, hips vs49 legs, impossible side-to-side travel, weight transfer.50- **Cartoon performance director:** charm, exaggeration, squash/stretch,51 comedic timing, readable personality.52- **Music-video director/cinematographer:** camera, staging, ensemble spacing,53 whether the shot sells the performance.54- **Technical animation reviewer:** rig seams, ribbons/mesh artifacts, z-order,55 foot locks, discontinuities.5657## Prompt Template5859Give each reviewer the same artifact list and scope:6061```text62Read these rendered frame strips/stills from the current code:63<paths>6465Scope: judge <dance/walk/kick/camera/backdrop>. Ignore unrelated clips.66Return:67SCORE: single 0-10 number68TOP 3 BLOCKERS: ranked, evidence tied to a visible frame/phase69TOP 3 FIXES: concrete, implementable changes70ONE-LINE VERDICT: highest-leverage next move71```7273For Afrobeats work, add:7475```text76Judge whether this feels like a Lagos/Afrobeats music-video groove rather than77generic boy-band posing. Prioritize pocket, hips, footwork, call-and-response,78and relaxed confidence over big random arm gestures.79```8081## After The Panel82831. Cluster repeated findings across reviewers.842. Fix the highest-leverage body/choreo issue first, not a scattered set of85 cosmetic comments.863. Re-render the same capture and re-rate. Scores are valid only for the pixels87 that were reviewed.884. Add or adjust focused tests when a finding maps to a measurable invariant:89 bounded head displacement, no torso/hip detachment, no arm hiding behind the90 belly, no large adjacent-frame centroid jump, valid support-foot spans.9192## See Also9394- `choreo-phrase-authoring` when the issue is weak or unstructured dance data.95- `temporal-animation-diff` when the issue is snapping/jumps/discontinuity.96- `cinematic-render-panel` when the issue is scenery, lighting, or camera.
matthiasn