calesthio
b4f7ec4eee
Separates creative grammar (renderer_family) from technical engine (render_runtime) so HyperFrames can stand alongside Remotion as a first-class runtime instead of masquerading as a Remotion sub-case. Locks runtime choice at proposal stage and enforces it end-to-end: the schemas require it, video_compose routes by it, the reviewer fails closed on silent swaps, and a parametrized contract test walks every pipeline manifest to ensure each planning-stage skill explains the conversation to the user. Adds hyperframes_compose (scaffold/lint/ validate/render/doctor/add_block), a playbook -> CSS style bridge, and vendored HyperFrames Layer 3 skills from commit d291358, pinned via PROVENANCE.md for future re-sync. Final_review now records render_runtime_used and runtime_swap_detected so compose lies are catchable after the fact.
275 lines
8.5 KiB
YAML
275 lines
8.5 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
|
|
|
|
# Reference video input support
|
|
reference_input:
|
|
supported: true
|
|
analysis_depth: deep
|
|
analysis_tools:
|
|
- video_analyzer
|
|
- transcript_fetcher
|
|
- video_downloader
|
|
- scene_detect
|
|
- frame_sampler
|
|
|
|
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
|
|
- meta/animation-runtime-selector
|
|
|
|
compatible_playbooks:
|
|
recommended:
|
|
- flat-motion-graphics
|
|
also_works:
|
|
- clean-professional
|
|
- 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
|
|
sub_stages:
|
|
- name: sample
|
|
description: "10-15 second cinematic preview for reference-driven productions"
|
|
condition: "video_analysis_brief_exists"
|
|
human_approval_default: true
|
|
tools_available: [tts_selector, image_selector, video_selector, video_compose, audio_mixer, color_grade]
|
|
review_focus:
|
|
- "Sample captures the approved emotional tone"
|
|
- "Color palette and lighting match approved direction"
|
|
- "Music mood matches approved cinematic treatment"
|
|
|
|
- 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
|
|
- pixabay_music
|
|
- freesound_music
|
|
- music_gen
|
|
tools_available:
|
|
- subtitle_gen
|
|
- audio_enhance
|
|
- image_selector
|
|
- video_selector
|
|
- pixabay_music
|
|
- freesound_music
|
|
- 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
|
|
- hyperframes_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
|
|
- "render_runtime in edit_decisions matches proposal_packet — silent swap is a CRITICAL governance violation"
|
|
- "Cinematic work typically picks render_runtime='remotion' (CinematicRenderer) for video-led pieces; render_runtime='hyperframes' for kinetic title cards and HTML/GSAP-driven trailers"
|
|
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
|