# Isis Storyboard Frame Set Quality Evaluator and Acceptance Gate Runbook

Last Updated: 2026-03-02  
Scope: `MXA-0447` quality-evaluation and acceptance-gate enforcement for
`storyboard-frame-set` workflows.

## Purpose

Generate and validate the canonical artifact that captures deterministic
storyboard-frame-set quality-metric evaluation, threshold-based acceptance gate
behavior, and compatibility-route policy exposure for `storyboard-frame-set`
workflow execution.

## Artifacts

- `docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_QUALITY_EVALUATOR_ACCEPTANCE_GATE.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_QUALITY_EVALUATOR_ACCEPTANCE_GATE.md`

## Generator

```bash
node scripts/isis/generate-v2-storyboard-frame-set-quality-evaluator-acceptance-gate.mjs
```

Options:

- `--report-date=YYYY-MM-DD` (default: current UTC date)

## Validator

```bash
node scripts/isis/validate-v2-storyboard-frame-set-quality-evaluator-acceptance-gate.mjs
```

## Source Inputs

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_STORYBOARD_FRAME_SET_COST_ESTIMATION_BUDGET_GUARDRAILS.json`
- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/routes/workflows.spec.ts`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `apps/isis/generation-api/src/routes/jobs.spec.ts`
- `apps/isis/generation-api/src/routes/storyboard-frame-set-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/storyboard-frame-set-quality-gate-utils.spec.ts`

## Operational Cadence

1. Regenerate when storyboard-frame-set quality-metric thresholds, weighted
   scoring model, or route response contracts change.
2. Validate before closing downstream regression/integration/operator tasks that
   depend on acceptance-gate stability.
3. Keep threshold defaults and environment-key policy metadata synchronized
   between workflow enforcement and provider compatibility diagnostics.

## Related Artifacts

- `apps/isis/generation-api/src/routes/workflows.ts`
- `apps/isis/generation-api/src/routes/storyboard-frame-set-quality-gate-utils.ts`
- `apps/isis/generation-api/src/routes/jobs.ts`
- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_BACKLOG.md`
