name: cinematic
version: "2.0"
description: >
  Mood-led cinematic pipeline for trailers, brand films, montages, and short-form dramatic edits.
  Works best with supplied footage, stills, or source media, and can optionally use generated
  support visuals for gap filling or concept-led inserts. EP orchestration adds quality gates
  for emotional pacing, color consistency, and audio dynamics.
category: cinematic
stability: production
default_checkpoint_policy: guided

orchestration:
  mode: executive-producer
  skill: pipelines/cinematic/executive-producer
  budget_default_usd: 2.00
  max_revisions_per_stage: 3
  max_send_backs: 3
  max_wall_time_minutes: 12

required_skills:
  - pipelines/cinematic/executive-producer
  - pipelines/cinematic/idea-director
  - pipelines/cinematic/script-director
  - pipelines/cinematic/scene-director
  - pipelines/cinematic/asset-director
  - pipelines/cinematic/edit-director
  - pipelines/cinematic/compose-director
  - pipelines/cinematic/publish-director
  - meta/reviewer
  - meta/checkpoint-protocol

compatible_playbooks:
  - clean-professional
  - flat-motion-graphics
  - minimalist-diagram

stages:
  - name: idea
    skill: pipelines/cinematic/idea-director
    produces:
      - brief
    tools_available: []
    checkpoint_required: true
    human_approval_default: true
    review_focus:
      - Source mode and emotional arc are clear
      - Motion-required delivery is explicitly identified when applicable
      - Delivery shape is realistic for available footage and assets
      - Cinematic treatment is justified rather than decorative
    success_criteria:
      - Schema-valid brief artifact
      - Brief records source reality and target output shape

  - name: script
    skill: pipelines/cinematic/script-director
    required_artifacts_in:
      - brief
    produces:
      - script
    optional_tools:
      - transcriber
      - scene_detect
    tools_available:
      - transcriber
      - scene_detect
    checkpoint_required: true
    human_approval_default: true
    review_focus:
      - Beat map escalates cleanly
      - Dialogue or title-card usage is sparse and purposeful
      - Reveal and landing beats are clear
    success_criteria:
      - Schema-valid script artifact
      - Script sections map to identifiable cinematic beats

  - name: scene_plan
    skill: pipelines/cinematic/scene-director
    required_artifacts_in:
      - script
    optional_artifacts_in:
      - brief
    produces:
      - scene_plan
    optional_tools:
      - frame_sampler
      - scene_detect
    tools_available:
      - frame_sampler
      - scene_detect
    checkpoint_required: true
    human_approval_default: true
    review_focus:
      - Hero frames and reveal moments are defined
      - Source-led scenes remain primary when source media exists
      - Transition and aspect-ratio choices support the mood
    success_criteria:
      - Schema-valid scene_plan artifact
      - Every beat has a scene treatment and asset path

  - name: assets
    skill: pipelines/cinematic/asset-director
    required_artifacts_in:
      - scene_plan
    optional_artifacts_in:
      - script
      - brief
    produces:
      - asset_manifest
    optional_tools:
      - subtitle_gen
      - audio_enhance
      - image_selector
      - video_selector
      - music_gen
    tools_available:
      - subtitle_gen
      - audio_enhance
      - image_selector
      - video_selector
      - music_gen
    checkpoint_required: true
    human_approval_default: false
    review_focus:
      - Source selects and support assets are clearly separated
      - Motion-required beats use actual video clips rather than still-image substitutes
      - Music and ambience plan matches the beat map
      - Optional generated inserts stay limited and justified
    success_criteria:
      - Schema-valid asset_manifest artifact
      - All referenced asset files exist on disk

  - name: edit
    skill: pipelines/cinematic/edit-director
    required_artifacts_in:
      - scene_plan
      - asset_manifest
    optional_artifacts_in:
      - script
    produces:
      - edit_decisions
    tools_available: []
    checkpoint_required: true
    human_approval_default: false
    review_focus:
      - Emotional pacing is preserved
      - Strong moments are not overcut or overcovered
      - Audio cues and title-card timing reinforce the story
    success_criteria:
      - Schema-valid edit_decisions artifact
      - Edit decisions cover the full planned runtime

  - name: compose
    skill: pipelines/cinematic/compose-director
    required_artifacts_in:
      - edit_decisions
      - asset_manifest
    optional_artifacts_in:
      - scene_plan
    produces:
      - render_report
    required_tools:
      - video_compose
      - audio_mixer
    optional_tools:
      - video_stitch
      - video_trimmer
      - color_grade
      - audio_enhance
    tools_available:
      - video_compose
      - audio_mixer
      - video_stitch
      - video_trimmer
      - color_grade
      - audio_enhance
    checkpoint_required: true
    human_approval_default: false
    review_focus:
      - Output mood matches intended pacing and grade
      - Motion-required delivery was preserved without silent fallback
      - Audio dynamics are controlled and intelligible
      - Letterbox or frame treatment improves rather than harms the output
    success_criteria:
      - Schema-valid render_report artifact
      - Output file exists and passes ffprobe validation

  - name: publish
    skill: pipelines/cinematic/publish-director
    required_artifacts_in:
      - render_report
    optional_artifacts_in:
      - brief
      - script
    produces:
      - publish_log
    tools_available: []
    checkpoint_required: true
    human_approval_default: true
    review_focus:
      - Hero export and derivative exports are clearly labeled
      - Metadata matches the tone and distribution intent
      - Poster-frame or thumbnail concept is coherent
    success_criteria:
      - Schema-valid publish_log artifact
      - Export package contains video and metadata outputs
