intro-video-brief

Overview

Two modes:

• Create mode (default): Research product → interview user → generate video-brief.json → pass to /remotion
• Enhance mode (--enhance or when a Remotion project path is provided): Audit existing Remotion composition → identify issues → produce an improved video-brief.json + inline code suggestions

Design principle: Every video must feel like real motion design — varied scene types, distinct atmospheres per scene, kinetic typography, and intentional hard cuts alongside smooth transitions. Never let every scene use the same layout, same entry animation, or same background treatment.

---

Mode Detection

Detect which mode to run:

1. Enhance mode if any of:

   • Argument contains --enhance
   • Argument is a directory path containing remotion.config.ts, src/Root.tsx, or src/compositions/
   • User says "improve", "enhance", "fix", "audit", or "update" the video

2. Create mode otherwise (GitHub URL, website URL, or free-form description)

---

Read references/video-vocabulary.md for scene type, animation, and atmosphere vocabulary.

---

CREATE MODE

Step 1: Gather Inputs

1. Parse the argument to identify:

   • Directory path → read content files directly (README, content.ts, globals.css, package.json)
   • GitHub URL (github.com/org/repo) → fetch README + repo metadata
   • Website URL → fetch homepage content
   • Free-form description → use as product context directly

2. Ask missing essentials (only ask what cannot be inferred):

   Quick questions to shape your intro video:
   
   1. Target platform? [16:9 YouTube/Web | 9:16 TikTok/Reels | 1:1 Instagram]
   2. Video duration? [15s | 30s | 60s]
   3. Visual tone? [minimal | energetic | bold | corporate | playful]
   4. Primary brand color? (hex or "I don't know — pick from the product")
   5. Should I include a voiceover script? [yes | no]
   

   Skip any question the user already answered via arguments or description.

Step 2: Research the Product