director

# Director — Story-to-Video Production Pipeline ## Overview The Director skill orchestrates a complete short film production from a text story. It breaks the story into scenes, generates start/end frames for each, creates video clips from frame pairs, and concatenates everything into a final video. **Pipeline**: Story Planning → Z-Image Hero + Character Refs → Qwen Edit Chain (all frames) → WAN 2.2 FLF Video Clips → ffmpeg Concatenation **Key architectural decisions**: - **1 hero frame + edit chain** for character consistency (NEVER independent Z-Image per scene) - **Inter-scene frame continuity**: Scene N's end frame IS Scene N+1's start frame (same image file, no edit gap) - Character reference images fed into Qwen Edit's extra image slots - State file persists to disk for context compaction survival - Each scene is independently retryable without affecting others - `clear_vram` between every model family switch ## CRITICAL: Character Consistency **Independent Z-Image generations per scene produce different-looking characters.** This was the #1 problem discovered during testing. The solution: 1. Generate **ONE hero frame** with Z-Image — establishes the main character, setting, and lighting 2. Generate **character reference images** — close-up portraits of each character, key props, and the background 3. **ALL other scene frames** are created via Qwen Edit chain from the hero, with character refs in extra image slots 4. This ensures the same face, clothing, and envir...