calesthio
2cd36fa8e0
Implements the 2026-04-02 transformation spec (Phases 1-8) and fixes all critical bugs found during 5-pipeline E2E testing. Governance & Decision Intelligence: - Pipeline-specific stage order in checkpoint (replaces global STAGES list) - Provider scoring engine (lib/scoring.py) with 7-dimension weighted ranking - Decision log artifact enforced at proposal/idea stage across all 10 pipelines - Delivery promise classifier prevents silent motion-to-still downgrades - Structured shot language in scene_plan schema (camera, lens, lighting, DOF) - Variation checker and slideshow risk scorer block samey output before render - Creative intake, capability extension, and creative-intake meta skills - Final self-review artifact with 5 mandatory checks before presenting output - Source media review contract for user-supplied footage Render & Theme System: - Remotion AnimatedBackground now derives colors from playbook (no more hardcoded dark blue fintech gradient on every video) - video_compose builds custom ThemeConfig from playbook YAML colors/fonts — custom playbooks flow through to Remotion automatically - Explainer component wires theme to all child components (charts, cards, etc.) - resolveAsset() handles absolute paths on Windows/Unix via file:// URIs - RENDERER_FAMILY_MAP synced with actual Remotion compositions Critical Bug Fixes: - Windows npx subprocess: run_command() resolves .cmd wrappers via shutil.which() - Silent renderer downgrade: Remotion failure now returns explicit error with options instead of silently falling back to FFmpeg - .env inline comment parsing strips trailing # comments from API keys - concat_path UnboundLocalError in video_compose finally block - audio_mixer and showcase_card capture=True kwarg bug - Selector estimate_cost() calls fixed (_select_tool -> _select_best_tool) - asset_manifest schema expanded with provider, license, subtype fields - screen-demo subtitle_gen moved from required to optional tools - Duration drift detection in post-render final review (>25% warns)
246 lines
7.3 KiB
YAML
246 lines
7.3 KiB
YAML
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
|
|
|
|
extensions:
|
|
custom_scripts: true
|
|
custom_playbooks: true
|
|
custom_skills: true
|
|
custom_tools: false
|
|
|
|
required_skills:
|
|
- pipelines/cinematic/executive-producer
|
|
- pipelines/cinematic/research-director
|
|
- pipelines/cinematic/proposal-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:
|
|
recommended:
|
|
- clean-professional
|
|
- flat-motion-graphics
|
|
also_works:
|
|
- minimalist-diagram
|
|
custom_allowed: true
|
|
|
|
stages:
|
|
- name: research
|
|
skill: pipelines/cinematic/research-director
|
|
produces:
|
|
- research_brief
|
|
tools_available:
|
|
- web_search
|
|
checkpoint_required: true
|
|
human_approval_default: false
|
|
review_focus:
|
|
- Visual references are specific and relevant to the mood
|
|
- Sound and music direction is substantive, not generic
|
|
- Motion commitment is honest about available capabilities
|
|
- At least 3 genuinely different cinematic directions identified
|
|
success_criteria:
|
|
- Schema-valid research_brief artifact
|
|
- At least 8 web searches executed
|
|
- Visual references include specific URLs and descriptions
|
|
|
|
- name: proposal
|
|
skill: pipelines/cinematic/proposal-director
|
|
required_artifacts_in:
|
|
- research_brief
|
|
optional_artifacts_in:
|
|
- source_media_review
|
|
produces:
|
|
- proposal_packet
|
|
- decision_log
|
|
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
|
|
- Delivery promise is explicit and honest
|
|
- Renderer family is selected and locked
|
|
- Music plan is resolved
|
|
success_criteria:
|
|
- Schema-valid proposal_packet artifact
|
|
- At least 3 concept options with different emotional arcs
|
|
- Delivery promise present with motion_required flag
|
|
- Cost estimate includes per-item breakdown
|
|
|
|
- name: script
|
|
skill: pipelines/cinematic/script-director
|
|
required_artifacts_in:
|
|
- proposal_packet
|
|
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:
|
|
- proposal_packet
|
|
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
|
|
- final_review
|
|
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
|
|
- final_review
|
|
optional_artifacts_in:
|
|
- proposal_packet
|
|
- 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
|