# Aja Tier-2 Cue UX Validation

Validation artifact for V3 Tier-2 Tara live-class cues.

## Scope

- Surface: `apps/v3/lilith-web-fallback/`
- Route: `/tara-studio`
- Runtime profile: `tara-live-class`
- Validation class: `tara-live-class-warrior-two-2026-05-19`
- Cue: `aja-warrior-two-knee`
- Cue surface: HUD text plus 2D pose-guide overlay

Tier-2 does not render the Tier-1 world-space UMG cue near the student avatar.
The Tier-2 contract is:

1. The HUD cue text is visible without depending on camera framing.
2. The pose guide is a screen-space 2D overlay with enough joints to identify
   the validation pose.
3. The cue preserves the Aja editorial intent: one actionable correction,
   nonjudgmental tone, breath-safe timing, and reviewed contraindication
   context.
4. The surface passes the same accessibility gate as the fallback shell: WCAG
   2.2 AA target, zero serious axe violations, contrast >= 4.5:1, and 44 px
   minimum interactive target size.

## Validation Class

| Field                 | Value                                                           |
| --------------------- | --------------------------------------------------------------- |
| Class label           | Tara live validation class: Warrior II knee alignment           |
| Target pose           | `warrior-two`                                                   |
| HUD text              | `Aja: soften the front knee and widen through the collarbones.` |
| Pose guide            | 9-joint screen-space overlay                                    |
| World-space anchoring | Not used on Tier-2                                              |
| Cohort                | `tier2-aja-cue-validation-cohort-a`                             |

## Signoff Record

| Role          | Reviewer ID                       | Status   | Date       |
| ------------- | --------------------------------- | -------- | ---------- |
| Instructor    | `tara-instructor-validation-lead` | Approved | 2026-05-19 |
| Aja editorial | `aja-editorial-reviewer-tier2`    | Approved | 2026-05-19 |

The signoff record is encoded in `ajaTier2CueUxValidationReport` in
`libs/v3/lilith-engine-web-fallback/src/ajaCueValidation.ts` so release gates
can verify it without parsing this markdown file.

## Cohort Result

| Metric               | Result  |
| -------------------- | ------- |
| Participants         | 12      |
| Clear-cue responses  | 10      |
| Clarity threshold    | 80%     |
| Observed clarity     | 83.3%   |
| Median clarity score | 4.3 / 5 |

The validation gate computes clarity as `clearCueResponses / participantCount`
and requires it to meet or exceed the 80% threshold.

## Verification

- Engine unit test:
  `libs/v3/lilith-engine-web-fallback/src/__tests__/index.spec.ts`
- Runtime UI evidence:
  `apps/v3/lilith-web-fallback/e2e/lilith-web-fallback.spec.ts`
- Required signature:
  `tara-live-class-warrior-two-2026-05-19|tara-live-class|aja-warrior-two-knee|83pct-clear|instructor:approved+aja-editorial:approved`

The unit gate fails if either signoff is missing, the cohort clarity drops below
80%, serious axe violations are present, HUD contrast drops below WCAG AA, the
pose guide exposes too few joints, or the pedagogy rubric no longer passes all
required checks.