Product Demo Video

Product Demo Video

Generate 2-minute product demo videos for technical projects with parallel build options and structured critic review.

When to Use

• Demoing a GitHub repo, API, or technical product
• Need professional explainer video quickly
• Want multiple approach options (animated vs simple)

Workflow (7 Phases)

DISCOVERY → SCRIPT → PARALLEL BUILD → PARALLEL CRITICS → ITERATE → FINAL → DELIVER
   │           │           │                │              │          │         │
 5-10m      10-15m      30-60m           10-15m        0-3 loops   gate    ship it

Phase 1: Discovery

Clone and analyze the repo:

gh repo clone <owner/repo> /tmp/<repo>

Extract:

• What it does (1 sentence)
• Who it's for
• 3-5 key features
• Architecture/flow
• Visual assets (logos, diagrams)

Ask (or use defaults):

Phase 2: Script

Use references/script-template.md structure:

Scene 1: Hook (0:00-0:15) — Problem statement
Scene 2: Context (0:15-0:30) — Why this matters
Scene 3-5: Features (0:30-1:30) — 3 key capabilities, 20s each
Scene 6: Technical (1:30-1:50) — Architecture/credibility
Scene 7: CTA (1:50-2:00) — What to do next

Guidelines:

• 150 words/minute
• Max 20 words/sentence
• Active voice
• Concrete over vague

Phase 3: Parallel Build

Spawn 2 sub-agents to build options simultaneously:

// Option A: Remotion (animated)
sessions_spawn({
  label: "demo-video-option-a",
  task: `Build animated demo video using Remotion.
  
  Script: [paste script]
  Voice: Use ElevenLabs, voice ID CcEB0ARKH8qIyzh2I1OR
  Output: /tmp/demo-video/option-a.mp4
  
  Approach:
  1. Generate voiceover per scene (ElevenLabs API)
  2. Create Remotion project with scene components
  3. Sync animations to audio timing
  4. Render at 1080p 30fps`
})

// Option B: Slides + ffmpeg (simple)
sessions_spawn({
  label: "demo-video-option-b", 
  task: `Build slide-based demo video.
  
  Script: [paste script]
  Voice: Use ElevenLabs, voice ID CcEB0ARKH8qIyzh2I1OR
  Output: /tmp/demo-video/option-b.mp4
  
  Approach:
  1. Generate voiceover (ElevenLabs API)
  2. Create slides with Puppeteer (HTML → PNG)
  3. Combine with ffmpeg, sync to audio
  4. Add simple transitions`
})

Wait for both. Present options to user or auto-select based on quality.

Phase 4: Parallel Critics

Spawn 2 critic personas (see references/ for full rubrics):

// Business Critic
sessions_spawn({
  label: "critic-business",
  task: `Review demo video as Business Critic "Mike".
  
  Video: [path]
  Script: [content]
  
  See references/critic-business.md for full persona and rubric.
  
  Score: Clarity, Professionalism, Business Value (1-10 each)
  Output: Structured review with overall score and specific fixes.`
})

// Technical Critic  
sessions_spawn({
  label: "critic-technical",
  task: `Review demo video as Technical Critic "Senior Engineer".
  
  Video: [path]
  Script: [content]
  
  See references/critic-technical.md for full persona and rubric.
  
  Score: Technical Accuracy, Credibility, Completeness (1-10 each)
  Output: Structured review with overall score and specific fixes.`
})

Phase 5: Iterate

Quality gates:

Iteration loop:

1. Collect all Critical/Important issues
2. Fix in order of severity
3. Re-render affected scenes only (if possible)
4. Re-run critics

Phase 6: Final Review

Before shipping, verify:

• Both critics passed (7.5+)
• No Critical issues remain
• Audio synced correctly
• All scenes render cleanly
• CTA is clear

Phase 7: Deliver

Output:

✅ Demo video complete!

📹 Video: demo-video-final.mp4 (2:03)
🎯 Audience: [target]
📊 Scores: Business 8.2/10 | Technical 7.8/10

Covers:
1. [Key point 1]
2. [Key point 2]  
3. [Key point 3]

Files saved to: [location]

Deliver to:

• Slack channel (if specified)
• Save to workspace/outputs/

Tools & Dependencies

Voice default: CcEB0ARKH8qIyzh2I1OR (Jeremy - Technical Tutorial Narrator)

File References

• references/critic-business.md — Business critic persona & rubric
• references/critic-technical.md — Technical critic persona & rubric
• references/script-template.md — Scene-by-scene script structure
• templates/remotion/ — Remotion project scaffold with components
• scripts/generate-voiceover.py — ElevenLabs TTS helper
• scripts/render-slides.sh — ffmpeg slide-to-video combiner