Eve library

ISIS v2 Cinematic Shot Sequence Canonical Requirements Brief

Guide

Revision 1

On this page

Generated: 2026-08-02T19:12:18.227Z Checklist: MXA-0469 (ISIS2-00667) Asset Family: cinematic-shot-sequence Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to 2026-10-30)

Objective#

Define a canonical implementation contract for cinematic-shot-sequence so workflow design, contract exposure, operational rollout, and quality certification execute with measurable, release-gated criteria.

Scope#

In Scope#

  • Workflow family requirements spanning baseline, conditioned, and consistency-locked variants.
  • Control, consistency, output package, and surface parity requirements for framing readability, shot continuity, and camera-intent coherence.
  • Success metrics and explicit failure criteria tied to Matrix A delivery tickets.

Out of Scope#

  • Implementation details for non-cinematic-shot-sequence asset families.
  • Provider-specific low-level node wiring beyond declared dependency/control contracts.

Baseline Assessment#

  • Related baseline workflow count: 2
  • Missing required controls in related baseline: ipadapter-style, ipadapter-composition, lens-profile-lock
  • Current control-mode pass rate (global baseline): 81.58%
  • Current required control quality average (selected controls): 0.977
Workflow ID Asset Family Output Profile Controls
animatediff-controlnet film-previs-blocking-reel video-master-profile camera-lock, camera-path-guide, color-script-lock, controlnet-canny, controlnet-depth, controlnet-lineart, controlnet-normal, controlnet-pose, controlnet-scribble, controlnet-segmentation, controlnet-softedge, depth-constraint, identity-adapter, identity-lock, keyframe-anchor-lock, latent-reuse, model-lock, motion-vector-lock, openpose-sequence, palette-lock, pose-constraint, prompt-template-lock, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, style-lock, temporal-lock, wardrobe-lock
lecture-scene anim-animatic-shot-reel video-master-profile camera-lock, camera-path-guide, color-script-lock, depth-constraint, identity-adapter, keyframe-anchor-lock, latent-reuse, model-lock, motion-vector-lock, palette-lock, pose-constraint, prompt-template-lock, reference-ensemble, sampler-scheduler-lock, scene-lock, seed-lock, style-anchor, style-lock, temporal-lock, wardrobe-lock

Canonical Requirements#

Output Package Contract Baseline#

Output Class Required Package Classes
video_master video-master, preview, metadata, manifest
source_frames source-frames, metadata, manifest
metadata_manifest metadata, manifest

Required Controls#

Control Category Coverage Baseline Quality Baseline
seed-lock determinism 2 workflows 1.000
sampler-scheduler-lock determinism 2 workflows 1.000
model-lock determinism 2 workflows 1.000
prompt-template-lock determinism 2 workflows 1.000
style-lock style-and-identity 2 workflows 1.000
color-script-lock style-and-identity 2 workflows 1.000
ipadapter-style reference-guidance 0 workflows 0.900
ipadapter-composition reference-guidance 0 workflows 0.900
controlnet-pose spatial-guidance 1 workflows 1.000
controlnet-depth spatial-guidance 1 workflows 1.000
controlnet-segmentation spatial-guidance 1 workflows 1.000
controlnet-normal spatial-guidance 1 workflows 1.000
controlnet-canny spatial-guidance 1 workflows 0.950
controlnet-lineart spatial-guidance 1 workflows 0.950
camera-path-guide camera-and-motion 2 workflows 1.000
lens-profile-lock camera-and-motion 0 workflows 0.925

Functional Requirements#

ID Checklist Requirement
F-000 MXA-0469 Publish a canonical, machine-readable requirements brief for cinematic-shot-sequence that defines scope, constraints, success metrics, and failure criteria.
F-001 MXA-0470 Design baseline workflow graph for cinematic-shot-sequence with deterministic defaults.
F-002 MXA-0471 Design image-conditioned variant workflow for cinematic-shot-sequence.
F-003 MXA-0472 Design control-conditioned variant workflow for cinematic-shot-sequence (pose/depth/segmentation where applicable).
F-004 MXA-0473 Design consistency-locked variant workflow for cinematic-shot-sequence with continuity profile support.
F-005 MXA-0474 Define model/node dependency manifest for cinematic-shot-sequence workflows.
F-006 MXA-0475 Define output package contract for cinematic-shot-sequence including file naming and metadata manifest.
F-007 MXA-0476 Add workflow templates and presets for cinematic-shot-sequence production tiers (draft/final/hero).
F-008 MXA-0477 Expose cinematic-shot-sequence workflows via generation API with typed request contracts.
F-009 MXA-0478 Expose cinematic-shot-sequence workflows via SDK with end-to-end examples.
F-010 MXA-0479 Expose cinematic-shot-sequence workflows in web UI with ergonomic form controls and validation.
F-011 MXA-0480 Implement side-by-side comparison tools for cinematic-shot-sequence outputs.
F-012 MXA-0481 Map cinematic-shot-sequence workflows to RunPod endpoint classes and sizing policies.
F-013 MXA-0482 Add cinematic-shot-sequence cost estimation and budget guardrails.
F-014 MXA-0483 Add cinematic-shot-sequence quality evaluator and threshold-based acceptance gate.
F-015 MXA-0484 Add cinematic-shot-sequence regression tests and golden datasets.
F-016 MXA-0485 Add cinematic-shot-sequence external integration recipe for downstream tools/systems.
F-017 MXA-0486 Publish cinematic-shot-sequence operator and creator documentation with troubleshooting.

Non-Functional Requirements#

ID Title Verification
NF-001 Deterministic replay reliability Replay the approved golden set over two independent runs and compute reproducibility pass ratio.
NF-002 Control coverage completeness Run contract and UX coverage checks against control IDs: seed-lock, style-lock, color-script-lock, ipadapter-style, ipadapter-composition, controlnet-pose, controlnet-depth, controlnet-segmentation, controlnet-normal, controlnet-canny, controlnet-lineart, camera-path-guide, lens-profile-lock.
NF-003 Output package integrity Validate output package contract and checksum manifest presence for each golden output.
NF-004 Operational budget guardrails Evaluate p95 runtime/cost telemetry against policy thresholds and enforce rejection when guardrails fail.
NF-005 External integration readiness Pass external integration cookbook examples and operator runbook smoke checks.

Success Metrics#

Metric Target Baseline Linked Checklist IDs
SM-001 >= 4 certified workflows (baseline, image-conditioned, control-conditioned, consistency-locked). 0 workflows currently mapped to cinematic-shot-sequence. MXA-0470, MXA-0471, MXA-0472, MXA-0473, MXA-0484
SM-002 17/17 downstream tickets DONE by milestone end date. 17/17 downstream tickets are DONE at report generation. MXA-0470, MXA-0471, MXA-0472, MXA-0473, MXA-0474, MXA-0475, MXA-0476, MXA-0477, MXA-0478, MXA-0479, MXA-0480, MXA-0481, MXA-0482, MXA-0483, MXA-0484, MXA-0485, MXA-0486
SM-003 16/16 required controls implemented and exposed. 13/16 controls currently evidenced in related baseline workflows. MXA-0472, MXA-0477, MXA-0478, MXA-0479
SM-004 Average required-control quality score >= 0.75. Current benchmark baseline: 0.977. MXA-0483, MXA-0484
SM-005 temporal_flicker_rate <= 0.05, motion_vector_drift <= 0.08, and camera_path_deviation <= 0.07. Not yet measured for cinematic-shot-sequence baseline (family not implemented). MXA-0473, MXA-0483, MXA-0484
SM-006 composition_alignment_score >= 0.85, shot_transition_consistency >= 0.80, and camera_intent_alignment >= 0.80. Not yet measured for cinematic-shot-sequence baseline (family not implemented). MXA-0473, MXA-0483, MXA-0484
SM-007 100% of outputs include package classes required by video_master, source_frames, and metadata_manifest mappings. No dedicated cinematic-shot-sequence output package contract is currently published. MXA-0475, MXA-0484
SM-008 Typed request/response support and user-facing controls available across generation API, SDK, and web UI with zero schema drift. Cinematic shot sequence family not yet exposed on API/SDK/UI surfaces. MXA-0477, MXA-0478, MXA-0479

Failure Criteria#

Criterion Trigger Severity Required Response
FC-001 Any of baseline, image-conditioned, control-conditioned, or consistency-locked variants is absent or uncertified. high Block promotion and complete missing variant tickets before reopening certification.
FC-002 Any required control ID is missing from workflow metadata or is not exposed consistently in API/SDK/UI. high Fail contract parity checks and block release until missing control contracts and UI exposure are restored.
FC-003 Temporal continuity, composition alignment, camera-intent alignment, or shot-transition consistency metrics fail thresholds across approved golden datasets. high Reject quality gate, retune workflows/models, and rerun regression benchmark until thresholds pass.
FC-004 Generated outputs are missing required package classes or manifest/checksum artifacts. high Fail output package validation and block external integrations until packaging contract is restored.
FC-005 Cost estimation or runtime sizing exceeds approved guardrails without explicit override policy. medium Apply hard-fail guardrail behavior and reclassify endpoint sizing before allowing additional runs.
FC-006 Golden dataset or regression suite detects perceptual drift above accepted threshold. high Mark build as non-releasable, investigate drift root cause, and refresh certification evidence only after pass.

Downstream Delivery Map#

Ticket Checklist Status Title
ISIS2-00668 MXA-0470 DONE Design baseline workflow graph for cinematic-shot-sequence with deterministic defaults.
ISIS2-00669 MXA-0471 DONE Design image-conditioned variant workflow for cinematic-shot-sequence.
ISIS2-00670 MXA-0472 DONE Design control-conditioned variant workflow for cinematic-shot-sequence (pose/depth/segmentation where applicable).
ISIS2-00671 MXA-0473 DONE Design consistency-locked variant workflow for cinematic-shot-sequence with continuity profile support.
ISIS2-00672 MXA-0474 DONE Define model/node dependency manifest for cinematic-shot-sequence workflows.
ISIS2-00673 MXA-0475 DONE Define output package contract for cinematic-shot-sequence including file naming and metadata manifest.
ISIS2-00674 MXA-0476 DONE Add workflow templates and presets for cinematic-shot-sequence production tiers (draft/final/hero).
ISIS2-00675 MXA-0477 DONE Expose cinematic-shot-sequence workflows via generation API with typed request contracts.
ISIS2-00676 MXA-0478 DONE Expose cinematic-shot-sequence workflows via SDK with end-to-end examples.
ISIS2-00677 MXA-0479 DONE Expose cinematic-shot-sequence workflows in web UI with ergonomic form controls and validation.
ISIS2-00678 MXA-0480 DONE Implement side-by-side comparison tools for cinematic-shot-sequence outputs.
ISIS2-00679 MXA-0481 DONE Map cinematic-shot-sequence workflows to RunPod endpoint classes and sizing policies.
ISIS2-00680 MXA-0482 DONE Add cinematic-shot-sequence cost estimation and budget guardrails.
ISIS2-00681 MXA-0483 DONE Add cinematic-shot-sequence quality evaluator and threshold-based acceptance gate.
ISIS2-00682 MXA-0484 DONE Add cinematic-shot-sequence regression tests and golden datasets.
ISIS2-00683 MXA-0485 DONE Add cinematic-shot-sequence external integration recipe for downstream tools/systems.
ISIS2-00684 MXA-0486 DONE Publish cinematic-shot-sequence operator and creator documentation with troubleshooting.

Traceability#

  • Checklist item: MXA-0469
  • Ticket key: ISIS2-00667
  • Source references:
    • docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json
    • docs/domains/isis/remediation-v2/ISIS_V2_ASSET_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONTROL_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_CONSISTENCY_TAXONOMY.json
    • docs/domains/isis/remediation-v2/ISIS_V2_OUTPUT_PACKAGE_TAXONOMY.json
    • libs/isis/workflows/src/metadata/workflow-taxonomy-registry.json
    • docs/domains/isis/remediation-v2/ISIS_V2_BENCHMARK_DASHBOARD.json
    • ISIS_TODOS_2.md