# NEXT Athlete OS - RC44 Physio Movement Protocol

## Principle

The exercise defines the motion. The pose atlas does not.

RC44 introduces a review layer where a physiotherapist / movement coach defines the desired skeleton keyframes first. Only after that do we match every available pose candidate against the skeleton target. A candidate can come from any sheet and any original pose name if its feet, knees, hips, arms and head match the required position.

## What the physio should define per exercise

1. Purpose: what physical quality the drill trains.
2. Start position: body line, support points, limb positions and readiness.
3. Keyframes: the minimum sequence of skeleton positions the app must show.
4. Contact / anchor: which body part is fixed, loaded, in air, landing or supporting.
5. Safety / no-go: patterns that must not be selected even if the image looks close.
6. Coaching cues: short cues that a child/coach can understand in live mode.
7. Candidate decision: approve, adjust target, needs new image, replace exercise or special handling.

## RC44 data flow

```text
physio-movement-blueprints.json
  -> skeleton target per keyframe
  -> pose_atlas_rc44_match_physio_blueprints.py
  -> rc44_physio_candidate_match_report.json
  -> physio_motion_blueprint_lab.html
  -> rc44_physio_review_patch.json
  -> later reviewed merge into exercise sequences
```

## Important left/right rule

Runtime-facing left/right means visual left/right. Raw MediaPipe anatomical labels remain stored separately. This keeps the rendered skeleton and the sprite tied together after flip/transform.

## Current status

RC44 is review-only. It does not activate new runtime sequences and it does not overwrite existing RC43 live movement. The generated blueprint targets are seeded from the old mapping only so the physio has something concrete to edit. A green score in RC44 means "matches the current seed", not "physio-approved".

## Review bands

- Green: 88-100, geometrically close to the target skeleton.
- Yellow: 74-87, potentially useful but needs human review.
- Red: below 74, probably not a good match.

## Special handling candidates

These should not be auto-accepted only from score:

- chin-up / pull-up: bar and grip are the anchor, not feet.
- buddy hamstring curl: knee pivot is the anchor.
- floor core / bridge: MediaPipe can confuse occluded limbs.
- med ball throw / slam: ball path is not fully represented by body landmarks.
- partner / box / equipment: extra objects are not represented by the 33 pose landmarks.
