# ISIS v2 Animatic Shot Set Quality Evaluator and Acceptance Gate

Generated: 2026-03-02T19:43:54.912Z Checklist: `MXA-0465` (ISIS2-00663) Asset
Family: `animatic-shot-set` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver deterministic animatic-shot-set quality evaluation using composition
alignment, camera continuity, blocking consistency, and style-lock adherence
metrics with threshold-based acceptance gating in workflow execution APIs and
auditable diagnostics.

## Workflow Coverage

| Workflow                              | Quality Utils Coverage | Jobs Strategy Coverage | Workflow Surface Coverage |
| ------------------------------------- | ---------------------- | ---------------------- | ------------------------- |
| animatic-shot-set-baseline            | yes                    | yes                    | no                        |
| animatic-shot-set-image-conditioned   | yes                    | yes                    | no                        |
| animatic-shot-set-control-conditioned | yes                    | yes                    | yes                       |
| animatic-shot-set-consistency-locked  | yes                    | yes                    | yes                       |

## Quality Gate Environment Coverage

| Environment Key                                         | Quality Utils | Jobs Strategy |
| ------------------------------------------------------- | ------------- | ------------- |
| ISIS_ANIMATIC_SHOT_SET_QUALITY_GATE_ENABLED             | yes           | yes           |
| ISIS_ANIMATIC_SHOT_SET_MIN_QUALITY_SCORE                | yes           | yes           |
| ISIS_ANIMATIC_SHOT_SET_QUALITY_GATE_RETRY_AFTER_SECONDS | yes           | yes           |
| ISIS_ANIMATIC_SHOT_SET_COMPOSITION_ALIGNMENT_SCORE_MIN  | yes           | yes           |
| ISIS_ANIMATIC_SHOT_SET_CAMERA_CONTINUITY_SCORE_MIN      | yes           | yes           |
| ISIS_ANIMATIC_SHOT_SET_BLOCKING_CONSISTENCY_SCORE_MIN   | yes           | yes           |
| ISIS_ANIMATIC_SHOT_SET_STYLE_LOCK_ADHERENCE_SCORE_MIN   | yes           | yes           |

## Verification Commands

- `pnpm --filter @isis/generation-api exec vitest run src/routes/animatic-shot-set-quality-gate-utils.spec.ts src/routes/workflows.spec.ts src/routes/jobs.spec.ts`

## Acceptance Criteria

- animatic-shot-set workflow variants evaluate composition alignment, camera
  continuity, blocking consistency, and style-lock adherence metrics
  deterministically.
- Quality threshold violations enforce hard acceptance-gate rejection before
  dispatch with explicit response code and retry metadata.
- Workflow run responses and metadata persist quality score and gate-status
  diagnostics for operator visibility and downstream auditing.
- Provider compatibility diagnostics expose animatic-shot-set quality-gate
  policy metadata and environment-key governance coverage.
