# AI video analysis coach POC

## Purpose

Use one existing practice or game video to test whether GlobeIce can save coach time by creating useful clip candidates, action tags, pose/keypoint signals, and a coach review pack.

## Inputs

- One video source with rights status and provenance.
- Optional coach-selected reference clips for comparison.
- Hockey vocabulary for the session, such as breakout, forecheck, power play, small-area game, shooting, gap, and transition.

## Run protocol

1. Ingest the video and store provider, provider id, source URL, hash, duration, and rights boundary.
2. Detect scene or shot candidates.
3. Run pose/keypoint extraction and store pose model, keypoint quality, and occlusion notes.
4. Run ASR/key phrase extraction when audio is available.
5. Fuse scene, pose, ASR, and metadata into action tags and clip candidates.
6. Export a JSON review pack plus DOCX/PPTX payloads.
7. Coach reviews every candidate as approve, edit, merge, split, or reject.
8. Publish only approved notes, diagrams, timestamp links, and review artifacts.

## Studio layout

- Left rail: player/session card, camera channels, uploaded clips, source rights and clip inbox.
- Center: main video player with player detection boxes, pose skeleton, puck trail, rink/zone overlays and confidence badges.
- Coach diagrams: normalized 1000x500 SVG rink masters with data-player/data-event attributes and PNG @2x fallback for DOCX/PPTX.
- Right rail: tactical templates, event buttons, manual coach tags, AI properties, review status and publish target.
- Bottom: timeline with colored event ticks, period markers, searchable tag list, active filters and clip queue.
- Tablet mode: approved clip playlist, player-safe notes, one-tap feedback, QR/share handoff and offline review.

## Core tag templates

- Tactical: Breakout, Regroup, Forecheck, Neutral-zone reload, PP entry, PK clear.
- Eventing: Shot for, Shot against, Goal chance, Turnover, Recovery, Controlled entry.
- Teaching: Good example, Fix next rep, Player clip, Team meeting, Academy resource, Do not publish.

## Coach review questions

- Did the candidate clip show a real coaching moment?
- Was the label correct in team language?
- Did pose/keypoint evidence support the coaching cue?
- Should adjacent clips be merged or split?
- Should the output become a session-plan resource, Academy lesson, report item, or private note?

## Validation metrics

- Time to first useful clip candidate.
- Percent of useful candidates after coach review.
- Missed coach-selected clips.
- Percent approved without relabeling.
- Rights status coverage before publish.
- Average confidence by drill type.

## Publish gate

Green means confidence is high, rights are clear, and the coach approves. Yellow means coach edits before publish. Red means do not publish.