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)
238 lines
7.5 KiB
YAML
238 lines
7.5 KiB
YAML
name: animated-explainer
|
|
version: "2.0"
|
|
description: >
|
|
Generated explainer video from topic/idea - fully AI-produced with narration, visuals, and music.
|
|
Features a research-first pre-production phase: the agent researches the topic, proposes concepts
|
|
with cost estimates, and gets explicit user approval before any assets are generated.
|
|
category: generated
|
|
stability: production
|
|
|
|
default_checkpoint_policy: guided
|
|
|
|
extensions:
|
|
custom_scripts: true
|
|
custom_playbooks: true
|
|
custom_skills: true
|
|
custom_tools: false
|
|
|
|
required_skills:
|
|
- pipelines/explainer/executive-producer
|
|
- pipelines/explainer/research-director
|
|
- pipelines/explainer/proposal-director
|
|
- pipelines/explainer/script-director
|
|
- pipelines/explainer/scene-director
|
|
- pipelines/explainer/asset-director
|
|
- pipelines/explainer/edit-director
|
|
- pipelines/explainer/compose-director
|
|
- pipelines/explainer/publish-director
|
|
- meta/reviewer
|
|
- meta/checkpoint-protocol
|
|
- meta/skill-creator
|
|
|
|
orchestration:
|
|
mode: executive-producer
|
|
skill: pipelines/explainer/executive-producer
|
|
budget_default_usd: 2.00
|
|
max_revisions_per_stage: 3
|
|
max_send_backs: 3
|
|
max_wall_time_minutes: 20
|
|
|
|
compatible_playbooks:
|
|
- clean-professional
|
|
- flat-motion-graphics
|
|
- minimalist-diagram
|
|
|
|
stages:
|
|
# ── Pre-Production ──────────────────────────────────────────────
|
|
|
|
- name: research
|
|
skill: pipelines/explainer/research-director
|
|
produces:
|
|
- research_brief
|
|
tools_available: []
|
|
checkpoint_required: false
|
|
human_approval_default: false
|
|
review_focus:
|
|
- Content landscape mapped with at least 3 existing pieces
|
|
- Data points are specific and sourced, not vague
|
|
- Audience questions sourced from real forums, not invented
|
|
- At least 3 genuinely different angles discovered
|
|
- All angles grounded in specific research findings
|
|
success_criteria:
|
|
- Schema-valid research_brief with at least 3 data_points
|
|
- At least 3 angles_discovered, each with grounded_in references
|
|
- At least 5 sources cited with URLs
|
|
|
|
- name: proposal
|
|
skill: pipelines/explainer/proposal-director
|
|
required_artifacts_in:
|
|
- research_brief
|
|
produces:
|
|
- proposal_packet
|
|
- decision_log
|
|
tools_available: []
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- Concept options are genuinely different (structure, hook, audience)
|
|
- Each concept is grounded in research findings, not generic
|
|
- Production plan reflects actual tool availability from preflight
|
|
- Cost estimate is itemized and honest
|
|
- Quality/cost tradeoffs are clearly presented
|
|
- Alternative production paths shown at different price points
|
|
success_criteria:
|
|
- Schema-valid proposal_packet with at least 3 concept_options
|
|
- selected_concept references a valid concept_id
|
|
- cost_estimate has itemized line_items with per-tool costs
|
|
- approval.status is "approved" or "approved_with_changes" before proceeding
|
|
|
|
# ── Production ──────────────────────────────────────────────────
|
|
|
|
- name: script
|
|
skill: pipelines/explainer/script-director
|
|
required_artifacts_in:
|
|
- proposal_packet
|
|
optional_artifacts_in:
|
|
- research_brief
|
|
produces:
|
|
- script
|
|
tools_available: []
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- "Word count within +/-10% of duration target from selected concept"
|
|
- "Enhancement cue density: 1 per 8-10 seconds"
|
|
- "Narrative arc: hook -> setup -> build -> climax -> landing"
|
|
- Speaker directions present for TTS
|
|
- Script incorporates research data points and cited facts
|
|
success_criteria:
|
|
- Schema-valid script with enhancement_cues per section
|
|
- Total duration matches selected concept target within 10%
|
|
|
|
- name: scene_plan
|
|
skill: pipelines/explainer/scene-director
|
|
required_artifacts_in:
|
|
- script
|
|
optional_artifacts_in:
|
|
- proposal_packet
|
|
produces:
|
|
- scene_plan
|
|
tools_available: []
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- Full script duration covered with no gaps
|
|
- "Visual variety: no 3+ consecutive scenes of same type"
|
|
- Asset feasibility - every required_asset uses a tool from the production plan
|
|
- Playbook adherence - transitions, colors, pacing rules
|
|
success_criteria:
|
|
- Schema-valid scene_plan with required_assets per scene
|
|
- At least 3 different scene types used
|
|
|
|
- name: assets
|
|
skill: pipelines/explainer/asset-director
|
|
required_artifacts_in:
|
|
- scene_plan
|
|
- script
|
|
optional_artifacts_in:
|
|
- proposal_packet
|
|
produces:
|
|
- asset_manifest
|
|
required_tools:
|
|
- tts_selector
|
|
- image_selector
|
|
optional_tools:
|
|
- video_selector
|
|
- math_animate
|
|
- diagram_gen
|
|
- code_snippet
|
|
- music_gen
|
|
tools_available:
|
|
- tts_selector
|
|
- image_selector
|
|
- video_selector
|
|
- diagram_gen
|
|
- code_snippet
|
|
- music_gen
|
|
- math_animate
|
|
checkpoint_required: true
|
|
human_approval_default: false
|
|
review_focus:
|
|
- All asset files exist on disk
|
|
- Narration covers all script sections
|
|
- Total cost within approved budget from proposal_packet
|
|
- Image style consistency across all generated visuals
|
|
success_criteria:
|
|
- Schema-valid asset_manifest with all required assets generated
|
|
- All file paths resolve to existing files
|
|
|
|
- name: edit
|
|
skill: pipelines/explainer/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:
|
|
- All cuts reference valid assets from manifest
|
|
- Subtitles enabled with playbook-compatible styling
|
|
- Music configured with ducking parameters
|
|
- No timeline gaps or overlaps
|
|
success_criteria:
|
|
- Schema-valid edit_decisions
|
|
- Full video duration covered
|
|
|
|
- name: compose
|
|
skill: pipelines/explainer/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
|
|
tools_available:
|
|
- video_compose
|
|
- video_stitch
|
|
- audio_mixer
|
|
checkpoint_required: true
|
|
human_approval_default: false
|
|
review_focus:
|
|
- Output video exists and is playable
|
|
- "Duration within +/-5% of target"
|
|
- Audio is clear with proper narration/music balance
|
|
success_criteria:
|
|
- Schema-valid render_report with output paths
|
|
- Output file exists and passes ffprobe validation
|
|
|
|
- name: publish
|
|
skill: pipelines/explainer/publish-director
|
|
required_artifacts_in:
|
|
- render_report
|
|
- final_review
|
|
optional_artifacts_in:
|
|
- proposal_packet
|
|
produces:
|
|
- publish_log
|
|
tools_available: []
|
|
checkpoint_required: true
|
|
human_approval_default: true
|
|
review_focus:
|
|
- SEO metadata complete and keyword-rich
|
|
- Chapter markers present
|
|
- Export package structured correctly
|
|
success_criteria:
|
|
- Schema-valid publish_log
|
|
- Export directory contains video, metadata, and thumbnail concept
|