solo-video-promo

# /video-promo

Generate a promo video plan from a project's PRD. Produces a 30-45 second video script with shot-by-shot storyboard. Detects Montage-tool or Remotion in the project and outputs compatible config when found.

## MCP Tools (use if available)

- `project_code_search(query, project)` — find UI components, screens, features to showcase
- `project_info(name)` — get project stack and details
- `kb_search(query)` — find video production methodology

If MCP tools are not available, fall back to Glob + Grep + Read.

## Steps

1. **Parse project** from `$ARGUMENTS`.
   - Read PRD (`docs/prd.md`), README, or CLAUDE.md for product info.
   - If empty: ask via AskUserQuestion.

2. **Detect video tooling** in the project:
   - Check `package.json` for `remotion`, `@remotion/cli` → Remotion project
   - Check for `montage.config.*`, `pnpm montage` → Montage-tool project
   - Check for `ffmpeg` usage in scripts → FFmpeg pipeline
   - If none found: output plain storyboard (no specific tooling config)

3. **Extract key screens/features** to showcase:
   - If MCP available: `project_code_search("main screen OR hero OR dashboard", project)` — find showcase-worthy UI
   - Otherwise: Glob for screenshots, mockups, or UI component files
   - Read PRD for top 3-5 features to demonstrate

4. **Forced reasoning — video strategy:**
   Before scripting, write out:
   - **Goal:** What should the viewer DO after watching? (download, sign up, visit)
   - **Hook type:** Question? Surprising stat? Pain point? Bold claim?
   - **Demo moments:** 3 key product moments to show on screen
   - **Emotion arc:** Frustration → Discovery → Relief/Delight

5. **Generate video script** (30-45 seconds):

   ```markdown
   ## Video Script: {Project Name}

   **Duration:** 30-45 seconds
   **Format:** Vertical (9:16) for Reels/TikTok/Shorts
   **Style:** Screen recording + text overlays

   ### HOOK (0:00-0:03) — 3 seconds
   **Audio:** "{hook line — question or bold statement}"
   **Visual:** {wh...