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)
209 lines
5.9 KiB
YAML
209 lines
5.9 KiB
YAML
name: screen-demo
|
|
version: "2.0"
|
|
description: >
|
|
Screen recording pipeline. Takes raw screen capture (app demo, browser walkthrough,
|
|
coding tutorial) and produces a polished demo video with callouts, zoom crops,
|
|
subtitles, and cleaned audio. EP orchestration adds quality gates for legibility,
|
|
audio clarity, and pacing.
|
|
category: screen_recording
|
|
stability: production
|
|
default_checkpoint_policy: guided
|
|
|
|
orchestration:
|
|
mode: executive-producer
|
|
skill: pipelines/screen-demo/executive-producer
|
|
budget_default_usd: 1.00
|
|
max_revisions_per_stage: 3
|
|
max_send_backs: 3
|
|
max_wall_time_minutes: 10
|
|
|
|
extensions:
|
|
custom_scripts: true
|
|
custom_playbooks: true
|
|
custom_skills: true
|
|
custom_tools: false
|
|
|
|
required_skills:
|
|
- pipelines/screen-demo/executive-producer
|
|
- pipelines/screen-demo/idea-director
|
|
- pipelines/screen-demo/script-director
|
|
- pipelines/screen-demo/scene-director
|
|
- pipelines/screen-demo/asset-director
|
|
- pipelines/screen-demo/edit-director
|
|
- pipelines/screen-demo/compose-director
|
|
- pipelines/screen-demo/publish-director
|
|
- meta/reviewer
|
|
- meta/checkpoint-protocol
|
|
|
|
compatible_playbooks:
|
|
- clean-professional
|
|
- minimalist-diagram
|
|
|
|
stages:
|
|
- name: idea
|
|
skill: pipelines/screen-demo/idea-director
|
|
produces:
|
|
- brief
|
|
- decision_log
|
|
tools_available: []
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- Brief accurately describes what the screen recording demonstrates
|
|
- Target platform and duration are realistic
|
|
- Callout strategy identified (what to highlight)
|
|
success_criteria:
|
|
- Schema-valid brief artifact
|
|
- Brief references the provided screen recording footage
|
|
|
|
- name: script
|
|
skill: pipelines/screen-demo/script-director
|
|
required_artifacts_in:
|
|
- brief
|
|
optional_artifacts_in:
|
|
- source_media_review
|
|
produces:
|
|
- script
|
|
required_tools:
|
|
- transcriber
|
|
optional_tools:
|
|
- scene_detect
|
|
- audio_enhance
|
|
tools_available:
|
|
- transcriber
|
|
- scene_detect
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- Transcription captures any voiceover accurately
|
|
- Key UI actions are annotated with timestamps
|
|
- Sections align with logical workflow steps
|
|
success_criteria:
|
|
- Schema-valid script artifact
|
|
- Script sections have timestamps from transcript or manual annotation
|
|
|
|
- name: scene_plan
|
|
skill: pipelines/screen-demo/scene-director
|
|
required_artifacts_in:
|
|
- script
|
|
optional_artifacts_in:
|
|
- brief
|
|
produces:
|
|
- scene_plan
|
|
required_tools: []
|
|
optional_tools:
|
|
- frame_sampler
|
|
tools_available:
|
|
- frame_sampler
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- Zoom-crop regions identified for key UI moments
|
|
- Callout overlay positions don't obscure important UI
|
|
- Pacing allows viewer to follow the workflow
|
|
success_criteria:
|
|
- Schema-valid scene_plan artifact
|
|
- Every key workflow step has a corresponding scene
|
|
|
|
- name: assets
|
|
skill: pipelines/screen-demo/asset-director
|
|
required_artifacts_in:
|
|
- scene_plan
|
|
optional_artifacts_in:
|
|
- script
|
|
produces:
|
|
- asset_manifest
|
|
required_tools: []
|
|
optional_tools:
|
|
- subtitle_gen
|
|
- tts_selector
|
|
- image_selector
|
|
- diagram_gen
|
|
- audio_enhance
|
|
tools_available:
|
|
- subtitle_gen
|
|
- tts_selector
|
|
- image_selector
|
|
- diagram_gen
|
|
- audio_enhance
|
|
checkpoint_required: true
|
|
human_approval_default: false
|
|
review_focus:
|
|
- Subtitle file exists and matches speech timing
|
|
- Reusable callout overlays (arrows, highlights, masks) are prepared
|
|
- Audio cleaned of keyboard noise and background hum
|
|
success_criteria:
|
|
- Schema-valid asset_manifest artifact
|
|
- All referenced asset files exist on disk
|
|
|
|
- name: edit
|
|
skill: pipelines/screen-demo/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:
|
|
- Zoom-crop notes are smooth and minimal (no constant motion)
|
|
- Dead time (loading, typing pauses) trimmed or sped up
|
|
- Callout timing matches narration
|
|
success_criteria:
|
|
- Schema-valid edit_decisions artifact
|
|
- All cuts reference valid source files and assets
|
|
|
|
- name: compose
|
|
skill: pipelines/screen-demo/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_trimmer
|
|
- audio_enhance
|
|
tools_available:
|
|
- video_compose
|
|
- audio_mixer
|
|
- video_trimmer
|
|
- audio_enhance
|
|
checkpoint_required: true
|
|
human_approval_default: false
|
|
review_focus:
|
|
- Output video is playable and crisp at target resolution
|
|
- UI text remains readable after crops and scaling
|
|
- Audio is clear with no keyboard/click noise
|
|
success_criteria:
|
|
- Schema-valid render_report artifact
|
|
- Output file exists and passes ffprobe validation
|
|
|
|
- name: publish
|
|
skill: pipelines/screen-demo/publish-director
|
|
required_artifacts_in:
|
|
- render_report
|
|
- final_review
|
|
optional_artifacts_in:
|
|
- brief
|
|
produces:
|
|
- publish_log
|
|
tools_available: []
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- Metadata includes relevant software/tool keywords
|
|
- Chapter markers align with workflow steps
|
|
- Export package is complete
|
|
success_criteria:
|
|
- Schema-valid publish_log artifact
|
|
- Export directory contains video, metadata, and thumbnail concept
|