@growthub/cli 0.3.34 → 0.3.36

package/assets/worker-kits/creative-strategist-v1/skills.md

@@ -0,0 +1,341 @@
+# Claude Workers — Creative Strategist Skill
+## Video Creative Brief Production  |  Multi-Brand System
+
+> **Who this is for:** Any Claude agent in `/Users/antonio/claude-workers/` producing a Video Creative Brief.
+> Read this file fully before starting. Every section is a required step.
+
+---
+
+## QUICK REFERENCE
+
+| What you need | Where to find it |
+|---|---|
+| This workflow | `skills.md` ← you are here |
+| **Ad format library** | `templates/ad-formats/INDEX.md` ← check FIRST on every brief |
+| **Scene module library** | `templates/scene-modules/INDEX.md` |
+| **Frame analysis (new muse)** | `templates/ad-formats/frame-analysis.md` — load only if no frozen format matches |
+| Client brand kits | `brands/<client-slug>/brand-kit.md` |
+| Blank brand kit template | `brands/_template/brand-kit.md` |
+| Brief JS template | `templates/brief-template.js` |
+| Output location | `~/Downloads/<ClientSlug>_VideoBrief_<Concept>_v<N>_<YYYYMMDD>.docx` |
+| Work directory | `/tmp/docx_work/` — run `npm install docx` here once per session |
+| Muse frames dir | `/tmp/muse_frames/` — check before running ffmpeg |
+| **500 Hooks CSV** | `templates/hooks-library/500-winning-hooks.csv` ← grep for Scene 1 hooks (Step 2d) |
+| Example (TheraPet → ODRx) | `~/Downloads/Clarifion_ODRx_VideoBrief_TheraPetAI_v1_20260408.docx` |
+| Example (Solawave BOGO) | `~/Downloads/Solawave_VideoBrief_KoreanSkincaretruth_v1_20260409.docx` |
+| Example (AllCore360° CGI) | `~/Downloads/AllCore360_VideoBrief_CGIGravityHook_v1_20260409.docx` |
+
+---
+
+## STEP 0 — UNDERSTAND THE TASK
+
+Answer these four questions before writing anything:
+
+1. **Who is the client?** → Find or create `brands/<slug>/brand-kit.md`
+2. **What is the one video creative?** → Single ad concept, not multiple separate ads
+3. **How many hook variations?** → Default 5 (A–E)
+4. **What is strictly forbidden?** → Check `messaging_guardrails` in the brand kit
+
+---
+
+## STEP 1a — CREATE BRAND KIT (new client only)
+
+```bash
+cp brands/_template/brand-kit.md brands/<client-slug>/brand-kit.md
+mkdir -p brands/<client-slug>/assets
+```
+
+Required fields: `client_name`, `slug`, `primary_service`, `landing_page`, `target_audience`,
+`tone`, `colors` (hex), `messaging_guardrails`, `do_not_attract`.
+
+---
+
+## STEP 1b — READ THE BRAND KIT
+
+```bash
+cat /Users/antonio/claude-workers/brands/<client-slug>/brand-kit.md
+```
+
+Load every field. The brief JS must pull colors, tone, and guardrails from this file — not memory.
+
+---
+
+## STEP 2 — CONFIRM BRIEF INPUTS
+
+```
+Length:                  [XX seconds]
+Format:                  [UGC / Doctor-Led / Explainer / Performance / etc.]
+Primary Goal:            [Conversion / Awareness / Education / Trust-Building]
+Voiceover:               [who speaks + role]
+Tone:                    [3–5 adjectives from brand kit]
+AI Avatar Required:      [Yes/No] → Type: [Photoreal / Talking Head / UGC]
+Voiceover Setup:         [VO only / UGC dialogue / founder VO / AI VO]
+Voice Type:              [Gender | Age | Tone | Accent]
+UGC Asset Requirements:  [Yes/No] → folder link or creator reference
+Brand Image Availability:[Air.inc / Drive / Instagram / Website]
+Video References:        [inspiration links or "None provided"]
+Hook Variations:         [default 5 — A through E]
+Scene Count:             [default 4 — Hook / Problem / Transformation / CTA]
+B-Roll Cadence:          [e.g. "cut every ~3 seconds"]
+CTA Offer:               [specific offer text]
+Phone + Website:         [from brand kit]
+```
+
+---
+
+## STEP 2c — CHECK TEMPLATE LIBRARY (BEFORE any frame extraction)
+
+> **Do this first — every time.** A frozen format skips frame extraction entirely.
+
+```
+Read /Users/antonio/claude-workers/templates/ad-formats/INDEX.md
+```
+
+**Match found?**
+- Yes → `Read templates/ad-formats/<matched-id>.md`
+  Load the format's scene structure + scene modules. Replace `[PLACEHOLDERS]` from brand-kit.md.
+  Do NOT re-extract frames. The format file is the frozen scene map.
+- No → proceed to Step 2b.
+
+**Then load scene modules:**
+```
+Read /Users/antonio/claude-workers/templates/scene-modules/INDEX.md
+```
+Pull each module listed under "Scene Modules Used" in the format file.
+
+**After completing a new muse brief → freeze the format:**
+```
+Create templates/ad-formats/<new-id>.md   (copy any existing format file as schema)
+Add row to templates/ad-formats/INDEX.md
+Add reusable scenes to templates/scene-modules/
+Add rows to templates/scene-modules/INDEX.md
+```
+
+---
+
+## STEP 2d — HOOK SELECTION FROM FROZEN CSV
+
+> Run this every brief — before writing any Scene 1 hook variation.
+> CSV: `templates/hooks-library/500-winning-hooks.csv`
+> Columns: `Example` (real hook) | `Structure` (template with `[PLACEHOLDERS]`)
+> **Always adapt the Structure column** — not the Example. Structure has the swap-ready pattern.
+
+**3-pass grep method (fast):**
+
+```bash
+CSV=/Users/antonio/claude-workers/templates/hooks-library/500-winning-hooks.csv
+
+# Pass 1 — client niche / pain-point keywords
+grep -i "KEYWORD1\|KEYWORD2" "$CSV" | head -10
+
+# Pass 2 — hook type (pick the types relevant to the brief)
+grep -i "save this\|stop using\|nobody.*talking\|doesn't want\|going missing\|ugly truth\|hard pill\|mistake\|secret" "$CSV" | head -15
+
+# Pass 3 — structured output: show Example + Structure side-by-side for top matches
+python3 - "$CSV" "KEYWORD" << 'PY'
+import csv, sys
+path, kw = sys.argv[1], sys.argv[2].lower()
+with open(path) as f:
+    for i, row in enumerate(csv.reader(f)):
+        if len(row) >= 2 and (kw in row[0].lower() or kw in row[1].lower()):
+            print(f"[{i}] EXAMPLE:   {row[0][:90]}")
+            print(f"    STRUCTURE: {row[1][:100]}\n")
+PY
+```
+
+**Selection rules:**
+1. Pick the 5 most relevant matches — one per hook variation (A–E)
+2. Swap `[PLACEHOLDERS]` from `brand-kit.md` → `primary_service`, `tone`, `approved_phrases`
+3. Log the CSV row index next to each hook in the brief (for reproducibility)
+4. If <3 strong matches found → broaden Pass 1 keywords, then fall back to Pass 2 types
+
+**Hook type → brief slot mapping:**
+
+| Hook Type | Best Slot | Trigger Keyword to grep |
+|-----------|-----------|------------------------|
+| Industry suppression | Hook A (disruption) | `doesn't want\|going missing` |
+| Nobody's talking | Hook B (blind spot) | `nobody.*talking\|no one.*talking` |
+| Save this video | Hook C (urgency) | `save this` |
+| Stop using X | Hook D (contrast) | `stop using\|stop doing` |
+| Ugly truth / hard pill | Hook E (controversy) | `ugly truth\|hard pill` |
+| Results in time frame | Any | `in \d+ days\|in \d+ minutes` |
+| Mistake warning | Any | `mistake\|wrong` |
+| Story / gather round | Narrative opener | `story\|gather` |
+
+---
+
+## STEP 2b — MUSE VIDEO ANALYSIS (only when no frozen format exists)
+
+> Full methodology → `templates/ad-formats/frame-analysis.md`
+> The commands below are the minimum to run. Read frame-analysis.md for the complete
+> scene map format, adaptation hierarchy, ↑ mirrors notation, and freeze checklist.
+
+```bash
+# 1. Check if frames already exist
+ls /tmp/muse_frames/ 2>/dev/null | head -5
+
+# 2. Get video runtime
+ffprobe -v quiet -print_format json -show_format -show_streams "/path/to/video.mp4" \
+  | python3 -c "import sys,json; d=json.load(sys.stdin); \
+    [print(s.get('duration','?'),'sec |',s.get('width','?'),'x',s.get('height','?')) \
+    for s in d['streams'] if s.get('codec_type')=='video']"
+
+# 3. Extract frames (3s intervals for 60–120s video; 2s for <30s TikTok format)
+mkdir -p /tmp/muse_frames
+ffmpeg -i "/path/to/video.mp4" -vf fps=1/3 /tmp/muse_frames/frame_%ds.jpg 2>&1 | tail -3
+ls /tmp/muse_frames/ | sort
+```
+
+**Read every frame** using the Read tool — batch 3 per call. Before writing the brief, answer:
+- How many distinct scenes?
+- Where is the tone flip (problem → solution)?
+- What is the character/visual format?
+- What is the text rhythm (karaoke? sentences?)?
+
+**Non-negotiable rule:** If the muse has 9 scenes, the brief has 9 scenes. Always.
+
+---
+
+## STEP 3 — DOCUMENT STRUCTURE
+
+Every brief follows this exact section order. No additions, no skips.
+
+```
+TITLE BLOCK          — client name, campaign, date, "1 Video | N Hook Variations"
+BRAND CONSTRAINT BOX — warning callout: what this ad must NEVER say or do
+BRIEF OVERVIEW TABLE — all Step 2 fields as key-value table
+0. MUSE MAPPING TABLE — (muse-based briefs only) scene-by-scene comparison
+1. CORE AD CONCEPT   — 2–3 paragraph narrative + emotional arc + concept KV table
+2. STRUCTURE & VO    — Scene 1 hook window + N hook cards + Scenes 2–N scene blocks
+3. EDITING GUIDELINES— pacing, color grade, music, captions, NO-list, aspect ratios
+--- PAGE BREAK ---
+APPENDIX             — AI video generation prompts (Veo 3 / Runway) — labeled OPTIONAL
+```
+
+---
+
+## STEP 4 — GENERATE THE DOCX
+
+```bash
+# Copy and fill the template
+cp /Users/antonio/claude-workers/templates/brief-template.js /tmp/docx_work/<slug>_brief_v1.js
+# Edit: fill CONFIG (colors from brand kit) + BRIEF (all content)
+
+# Run
+cd /tmp/docx_work && npm install docx   # once per session
+node <slug>_brief_v1.js
+# Output: /Users/antonio/Downloads/<slug>_VideoBrief_<concept>_v1_<YYYYMMDD>.docx
+```
+
+**JS non-negotiables:**
+- Page: US Letter — `width:12240, height:15840` — margins `1440` all sides — content width = 9360 DXA
+- Font: Arial. Arial Unicode MS for cells with `—`, `|`, `≤`
+- Table widths: always `WidthType.DXA` — never `WidthType.PERCENTAGE`
+- Cell widths must sum to table width (9360)
+- Shading: always `ShadingType.CLEAR`
+- Bullets: indent + TextRun bullet character — never `LevelFormat.BULLET`
+- Never `\n` inside a TextRun — use separate `Paragraph` elements
+- Hyperlinks: always `ExternalHyperlink` — never plain text for clickable URLs
+
+---
+
+## STEP 5 — OPEN IN GOOGLE DOCS
+
+```bash
+open -R "/Users/antonio/Downloads/<filename>.docx"
+osascript -e 'tell application "Google Chrome" to open location "https://drive.google.com/drive/my-drive"'
+```
+
+Tell the user: "File revealed in Finder. Drag into the Google Drive browser window, then right-click → Open with → Google Docs."
+
+---
+
+## STEP 6 — LOG TO BRAND KIT
+
+```bash
+echo "- $(date +%Y-%m-%d) | Video Creative Brief v1 | ~/Downloads/<filename>.docx" \
+  >> /Users/antonio/claude-workers/brands/<client-slug>/brand-kit.md
+```
+
+---
+
+## DESIGN SYSTEM (JS components)
+
+Change only the 6 color constants at the top of the JS file — pull from `brand-kit.md → colors`.
+
+| Function | Description |
+|---|---|
+| `h2(text)` | Full-width colored bar — section heading (`HeadingLevel.HEADING_2` inside cell) |
+| `h3(text)` | Left accent stripe — sub-heading (`HeadingLevel.HEADING_3`) |
+| `hyperlink(txt,url)` | External hyperlink — for muse URLs, LP URLs, references |
+| `kvTable(rows)` | Key-value info table (2 col, alternating shading) |
+| `sceneBlock(...)` | Scene card: colored header + label/content rows |
+| `hookCard(...)` | Hook variation card: accent left stripe + content block |
+| `alertBox(text)` | Warning/constraint callout box |
+| `bullet(text)` | Brand-colored bullet point |
+| `sp(pts)` | Vertical spacer paragraph |
+
+---
+
+## GUARDRAILS — EVERY BRIEF
+
+1. One creative per brief — not multiple separate ads
+2. N hook variations in Scene 1 only — Scenes 2–N identical across all
+3. AI/Veo prompts in Appendix only — never inline in scene blocks
+4. Appendix labeled OPTIONAL
+5. No pharmaceutical/clinical language unless client is explicitly pharma
+6. Brand constraint alert box always present — immediately after title block
+7. Aspect ratios: 9:16 + 1:1 minimum. Add 16:9 if YouTube in scope.
+8. Captions ON by default
+9. Date the document — version + date in filename and title block
+
+---
+
+## COMMON MISTAKES
+
+| Mistake | Correct Approach |
+|---|---|
+| Writing 5 separate creatives | 1 creative + 5 hook variations in Scene 1 |
+| Veo prompts inline in scenes | All AI prompts → Appendix, labeled OPTIONAL |
+| `WidthType.PERCENTAGE` in tables | Always `WidthType.DXA` |
+| `\n` inside TextRun | Separate Paragraph elements |
+| Skipping brand constraint box | Always include — it's the most important element |
+| Generic tone language | Pull exact adjectives from brand-kit.md |
+| Missing actor age/type spec | Always specify: age range + look + warmth |
+| Vague CTA | Always include: website + specific offer text |
+| Ignoring muse scene count | Muse has 9 scenes → brief has 9 scenes. Always. |
+| Skipping the template library | Check `templates/ad-formats/INDEX.md` FIRST — every session |
+| Writing scene modules from memory | Pull from `templates/scene-modules/` — JS stubs + AI prompts pre-built |
+| Not freezing after a new muse brief | After every new muse → freeze in `templates/ad-formats/` |
+
+---
+
+## FOLDER STRUCTURE
+
+```
+/Users/antonio/claude-workers/
+├── skills.md                          ← this file — read first, every session
+├── README.md                          ← kit overview + template library summary
+├── templates/
+│   ├── brief-template.js              ← base JS (copy per client)
+│   ├── hooks-library/
+│   │   └── 500-winning-hooks.csv      ← frozen hook database — grep in Step 2d (538 rows)
+│   ├── ad-formats/
+│   │   ├── INDEX.md                   ← frozen format lookup — check before Step 2b
+│   │   ├── bedroom-minimic-talk.md    ← @frankyshaw 23s format (Solawave)
+│   │   ├── villain-animation.md       ← TheraPet 98s format (Clarifion ODRx)
+│   │   └── frame-analysis.md         ← full frame extraction methodology (new muses only)
+│   └── scene-modules/
+│       ├── INDEX.md                   ← module lookup + assembly recipes
+│       ├── hooks/                     ← meme-overlay, tiktok-comment, pov-confession,
+│       │                                 dollar-amount, villain-hook
+│       ├── body/                      ← minimic-problem, tiktok-skeptic-pivot,
+│       │                                 product-demo-glow, villain-agitation, before-after-flatlay
+│       └── cta/                       ← bogo-meme-bookend, guarantee-close
+└── brands/
+    ├── _template/brand-kit.md
+    ├── solawave/brand-kit.md
+    ├── clarifion/brand-kit.md
+    ├── greentree-medical-center/brand-kit.md
+    └── annie-appleseed-project/brand-kit.md
+```

package/assets/worker-kits/creative-strategist-v1/templates/ad-formats/INDEX.md

@@ -0,0 +1,94 @@
+# Ad Format Template Library — INDEX
+> Read this file first. It tells you every frozen format and scene module available.
+> Pull the format file for full scene structure, JS stubs, and adaptation rules.
+
+---
+
+## HOW TO USE THIS LIBRARY
+
+**In a brief session:**
+1. User provides a muse or concept → check this index for matching format
+2. If a match exists → load that format file → it replaces Steps 2b–2b5 in `skills.md`
+3. If no match → extract frames as normal (Step 2b) → freeze new format after the brief
+
+**Interoperability rule:** Every format file + every scene module shares the same placeholder schema:
+`[BRAND_NAME]` `[PRODUCT_NAME]` `[PRICE]` `[OFFER]` `[LANDING_PAGE]` `[AI_ACTOR_AGE]`
+Swap these from the brand-kit.md and the module is production-ready.
+
+---
+
+## FORMAT LIBRARY
+
+| ID | Format Name | Length | Scenes | Category | Muse | Status |
+|----|-------------|--------|--------|----------|------|--------|
+| `bedroom-minimic-talk` | Bedroom Mini-Mic Talk | 23s | 6 | Skincare / Beauty Tech / Any | @frankyshaw Korean skincare Reel | ✅ PROVEN |
+| `villain-animation` | Villain Object Animation | 98s | 9 | Pet / Home / Supplement | TheraPet AI Animation | ✅ PROVEN |
+| `process-specialist-medical` | The Process Specialist | ~50s | 5 | Medical / Regenerative Medicine / Healthcare Authority | Greentree Medical Center original | ✅ PROVEN |
+
+**No match? → Use frame extraction methodology:** `templates/ad-formats/frame-analysis.md`
+After completing the brief, freeze the new format using that file's Phase 6 instructions.
+
+**Format files:** `templates/ad-formats/<ID>.md`
+
+---
+
+## SCENE MODULE LIBRARY
+
+Modules are plug-in components. Mix across formats. Each module has a JS stub ready to paste.
+
+### HOOKS (Scene 1 — swap per variation)
+
+| ID | Hook Name | Best Format | Trigger |
+|----|-----------|-------------|---------|
+| `meme-overlay` | Meme Overlay Hook | `bedroom-minimic-talk` | Relatable lifestyle meme (tired, broke, stressed) |
+| `tiktok-comment` | TikTok Comment "Is this legit?" | `bedroom-minimic-talk` | Skepticism-first, high-objection categories |
+| `pov-confession` | POV Mirror Confession | `bedroom-minimic-talk` | Mirror + candid skin moment |
+| `dollar-amount` | Dollar Amount Confession | `bedroom-minimic-talk` + `villain-animation` | "Spent $X. Didn't work." |
+| `villain-hook` | Villain Character Hook | `villain-animation` | Product objects as animated villain characters |
+
+**Module files:** `templates/scene-modules/hooks/<ID>.md`
+
+### BODY SCENES (Scenes 2–N)
+
+| ID | Module Name | Best Format | Beat |
+|----|-------------|-------------|------|
+| `minimic-problem` | Mini-Mic Problem Confession | `bedroom-minimic-talk` | Authority + failed solutions |
+| `tiktok-skeptic-pivot` | TikTok Skeptic Pivot | `bedroom-minimic-talk` | "Is this legit?" disarm + product intro |
+| `product-demo-glow` | Product Demo (Light/Glow) | `bedroom-minimic-talk` | Device with visible effect (red light, UV, glow) |
+| `villain-agitation` | Villain Agitation Stack | `villain-animation` | 1–4× stacked agitation scenes with villain objects |
+| `before-after-flatlay` | Before/After + Flat Lay | `bedroom-minimic-talk` | Split screen + product flat lay + "this is the real deal." |
+
+**Module files:** `templates/scene-modules/body/<ID>.md`
+
+### CTAs (Final Scene)
+
+| ID | CTA Name | Best Format | Offer Type |
+|----|----------|-------------|------------|
+| `bogo-meme-bookend` | BOGO + Meme Bookend Close | `bedroom-minimic-talk` | Buy 1 Get 1 / % Off / Flash Offer |
+| `guarantee-close` | Guarantee Calendar Close | `villain-animation` | 30/60-day satisfaction guarantee |
+
+**Module files:** `templates/scene-modules/cta/<ID>.md`
+
+---
+
+## QUICK BRIEF ASSEMBLY GUIDE
+
+| Brief Type | Start With | Hook Module | Body Modules | CTA Module |
+|------------|------------|-------------|--------------|------------|
+| Skincare UGC (23s) | `bedroom-minimic-talk` | `meme-overlay` OR `tiktok-comment` | `minimic-problem` + `tiktok-skeptic-pivot` + `product-demo-glow` + `before-after-flatlay` | `bogo-meme-bookend` |
+| Pet/Home Device (90s+) | `villain-animation` | `villain-hook` | `villain-agitation` × 3–4 + product reveal | `guarantee-close` |
+| Any brand, new muse | Extract frames → build new format → freeze here | — | — | — |
+
+---
+
+## FREEZING A NEW FORMAT
+
+After completing a muse-based brief, freeze the format:
+1. Create `templates/ad-formats/<new-id>.md` using the schema in any existing format file
+2. Add a row to this INDEX table
+3. Extract the reusable scene modules → add to `scene-modules/` if not already there
+4. Update `skills.md` QUICK REFERENCE table to include the new format
+
+---
+
+*Template Library — Creative Strategy Worker Kit — April 2026*

package/assets/worker-kits/creative-strategist-v1/templates/ad-formats/bedroom-minimic-talk.md

@@ -0,0 +1,197 @@
+# Ad Format: Bedroom Mini-Mic Talk
+> ID: `bedroom-minimic-talk`
+> Category: Skincare / Beauty Tech / Consumer Product (any)
+> Length: 20–30 seconds (proven at 23s)
+> Scene Count: 6
+> Hook Variations: 5 (A–E)
+> Status: ✅ PROVEN — Solawave BOGO brief, April 2026
+> Aspect Ratios: 9:16 primary, 1:1 secondary
+
+---
+
+## MUSE REFERENCE
+
+- **Creator:** @frankyshaw (Instagram / TikTok)
+- **URL:** https://www.instagram.com/reels/DU1lWOeDsdg/
+- **Original product featured:** Dr. Melaxin Cemenrete (Korean skincare)
+- **Local muse file:** `~/Downloads/Korean skincare truth…mp4`
+- **Runtime:** 23 seconds | 720×1280 | 9:16 vertical
+- **Why it works:** High-spend, high-persuasion skincare category. Meme-bookend (opens tired/closes approving) creates an emotional payoff that feels earned. Mini-mic prop signals authenticity without production cost. TikTok comment overlay intercepts the #1 objection before it forms. Self-aware humor prevents it from feeling like an ad.
+
+---
+
+## FORMAT SIGNALS (non-negotiable)
+
+These elements define the format. Remove any one and the format stops working.
+
+1. **Mini-mic prop** — silver condenser-style microphone held at chin/chest level in every close-up. This is the TikTok "I'm about to tell you the truth" signal.
+2. **Meme bookend** — viral meme overlay opens the ad (relatable problem) and closes it (approving/satisfied). Same meme character, emotional state flips from tired → happy. DW from Arthur was the original; any relatable viral character works.
+3. **Bedroom / cozy desk setting** — warm ambient light, slightly messy background. Specifically NOT a studio. Authenticity depends on this.
+4. **Karaoke-style captions** — white text, black outline, key words bolded. Bottom third. Essential — 70%+ views are silent.
+5. **Product shown 3× minimum** — held casually (Scene 2), in use/active state (Scene 4), flat lay with arrows (Scene 5). Never just once.
+6. **"this is the real deal."** — this exact phrase with arrows pointing at the product in the flat lay scene (Scene 5). Proven persuasion trigger. Do not paraphrase.
+7. **TikTok comment overlay** — "Is this legit?" comment bubble overlaid in Scene 3. Addresses skepticism from inside the format, not as a defensive rebuttal.
+
+---
+
+## PROVEN SCENE STRUCTURE
+
+| # | Scene Name | Timecode | Beat | Sacred Element |
+|---|------------|----------|------|----------------|
+| 1 | Opening Hook | 0–3s | Pattern interrupt — scroll stop | Meme overlay + problem statement. 5 variations (A–E). |
+| 2 | Authority & Problem | 3–8s | Shared experience builds credibility | Mini-mic, product held casually, "$X spent, nothing worked" |
+| 3 | Skeptic Pivot | 8–13s | Disarm objection before it forms | TikTok comment "Is this legit?" overlay + product reveal |
+| 4 | Product Demo | 13–18s | Product in action — visual proof | Active visual effect (red light, glow, motion). Product in use. |
+| 5 | Before/After + Authority | 18–21s | Receipt / social proof | Split screen + flat lay + arrows + "this is the real deal." |
+| 6 | CTA Close | 21–23s | Convert | Meme bookend (approving) + offer overlay + "link in bio" |
+
+---
+
+## SCENE MODULES USED IN THIS FORMAT
+
+Plug these directly from `scene-modules/`:
+
+| Scene | Module ID | File |
+|-------|-----------|------|
+| 1 | `meme-overlay` OR `tiktok-comment` OR `pov-confession` OR `dollar-amount` | `hooks/<id>.md` |
+| 2 | `minimic-problem` | `body/minimic-problem.md` |
+| 3 | `tiktok-skeptic-pivot` | `body/tiktok-skeptic-pivot.md` |
+| 4 | `product-demo-glow` | `body/product-demo-glow.md` |
+| 5 | `before-after-flatlay` | `body/before-after-flatlay.md` |
+| 6 | `bogo-meme-bookend` | `cta/bogo-meme-bookend.md` |
+
+---
+
+## ADAPTATION RULES
+
+### Keep (sacred)
+- Scene count: exactly 6
+- Mini-mic prop in Scenes 1, 2, 3, 6
+- Meme overlay in Scene 1 (hook) AND Scene 6 (approving bookend) — same meme, emotional flip
+- TikTok comment overlay in Scene 3
+- "this is the real deal." + arrows in Scene 5
+- Self-aware humor beat — one moment in Scene 3–4 (breaks 4th wall)
+- Bedroom/cozy setting throughout — never studio
+
+### Swap (per brand)
+- The specific meme character (DW from Arthur → any relatable viral character)
+- The product shown — must have a visually active state (glow, motion, transformation)
+- The dollar amount in Scene 2 ("$300 on serums" → "$X on [category product]")
+- The TikTok comment text — keep structure, swap the product reference
+- The offer text in Scene 6 ("BOGO" → "50% off" → "Free trial" → etc.)
+
+### Never
+- Studio lighting or production set — ruins the UGC authenticity
+- Full-frame video meme cuts — meme must be overlay on creator's frame (eyes always visible above)
+- Voiceover-only — the actor must be on screen speaking (this format is UGC dialogue, not VO)
+- More than 3 seconds of uninterrupted talking head — always break with a visual
+- Product shown without active state — for beauty tech, the glow/effect IS the product
+
+---
+
+## AI ACTOR SPEC (default — adapt per brand)
+
+```yaml
+age_range:      "22–32"
+gender:         "Female-presenting"
+look:           "Natural, warm skin tone. Light or no visible makeup. Hair loosely pulled back or down."
+outfit:         "Oversized hoodie or neutral crew-neck top. Bedroom-casual — NOT styled."
+setting:        "Cozy desk or bedroom. Warm ambient light (lamp or diffused window). Slight background clutter (books, skincare items, etc.) — NOT minimalist."
+prop:           "Silver condenser-style mini microphone. Essential. Always in hand for Scenes 1–3 and 6."
+energy:         "Conspiratorial best-friend energy. 'I looked this up so you don't have to.' NOT spokesperson."
+```
+
+---
+
+## DOCX JS STUBS
+
+Paste these sceneBlock() calls into the brief JS file. Replace `[PLACEHOLDERS]`.
+
+```js
+// SCENE 1 — Hook Window (use for the shared scene setup above the 5 hook cards)
+sceneBlock("SCENE 1 — HOOK WINDOW", "0–3 seconds  |  MUST stop the scroll", [
+  ["Visual Direction", "AI actor at desk/bedroom. Meme overlay fills lower 60% of frame. Actor's eyes visible above meme. Mini-mic in hand at chin level. Warm ambient lighting."],
+  ["On-Screen Text",   "[Hook line from variation — white bold caption, bottom third]"],
+  ["AI Actor VO",      "[Hook line from active variation — natural delivery, not scripted]"],
+  ["Purpose",          "Stop the scroll. Pattern-interrupt with meme format. Identify pain point before viewer can tap away."],
+])
+
+// SCENE 2 — Authority & Problem
+sceneBlock("SCENE 2 — AUTHORITY & PROBLEM", "3–8 seconds  |  Consistent across all variations", [
+  ["Visual Direction",  "AI actor close-up. Mini-mic in one hand, [PRODUCT_NAME] held casually in the other. Skincare shelf visible, slightly out-of-focus background."],
+  ["Actor Line",        "'I've tried [CATEGORY_PRODUCTS]. [DOLLAR_SPENT] later. Nothing gave me what I actually needed for [PAIN_POINT].'"],
+  ["On-Screen Text",    "'[products listed].' — caption. Key words bold."],
+  ["Purpose",           "Build credibility through shared experience. She's not naive — she's tried everything. Positions [PRODUCT_NAME] reveal as earned discovery."],
+  ["Transition",        "Direct cut to close-up of [PRODUCT_NAME] being lifted into frame."],
+])
+
+// SCENE 3 — Skeptic Pivot + Product Intro
+sceneBlock("SCENE 3 — SKEPTIC PIVOT + PRODUCT INTRO", "8–13 seconds  |  Consistent across all variations", [
+  ["Visual Direction",  "TikTok comment bubble overlaid: 'Is this legit tho?' — actor glances at it, smiles, looks back at camera. [PRODUCT_NAME] now held up, [ACTIVE_STATE]."],
+  ["Actor Line",        "'That's literally what I said. So I looked it up. [MECHANISM] — [WHAT IT DOES] — in [PRODUCT_FORM] you use at home.'"],
+  ["On-Screen Text",    "TikTok comment: 'Is this legit tho?' → clears. Caption: '[MECHANISM]. at home.' — bold highlight on [MECHANISM]."],
+  ["Purpose",           "Intercept #1 objection ('is this a gimmick?') before viewer consciously forms it. [ACTIVE_STATE] = visual proof it does something."],
+  ["Transition",        "Cut to [PRODUCT_NAME] in use — [ACTIVE_STATE] in motion."],
+])
+
+// SCENE 4 — Product Demo
+sceneBlock("SCENE 4 — PRODUCT DEMO", "13–18 seconds  |  Consistent across all variations", [
+  ["Visual Direction",  "Close-up of [PRODUCT_NAME] in use: [USE_AREA_1], [USE_AREA_2], [USE_AREA_3]. [ACTIVE_STATE] visible and cinematic. Skin looks luminous, dewy."],
+  ["Actor Line",        "'[MECHANISM_SHORT] — [BENEFIT]. You use it for [TIME]. Done.'"],
+  ["On-Screen Text",    "'[MECHANISM_SHORT]' — caption. Then: '[TIME]. That's it.' — bold, centered."],
+  ["Purpose",           "Show the product WORKING. [ACTIVE_STATE] is [BRAND]'s visual superpower. Make viewer want that effect on their own skin."],
+  ["Transition",        "Cut to split-screen: before LEFT — [PRODUCT_NAME] in use RIGHT."],
+])
+
+// SCENE 5 — Before/After + Product Authority
+sceneBlock("SCENE 5 — BEFORE/AFTER + PRODUCT AUTHORITY", "18–21 seconds  |  Consistent across all variations", [
+  ["Visual Direction",  "(1) Split-screen 1.5s: bare skin LEFT — same with [PRODUCT_NAME] in use RIGHT.\n\n(2) Product flat lay: [PRODUCT_NAME] centered on clean surface. [ACTIVE_STATE]. 3 white arrows point down at product. Warm lighting."],
+  ["Actor Line",        "'This is the real deal. [PERSONAL_RESULT_STATEMENT].'"],
+  ["On-Screen Text",    "Split: LEFT 'before [BRAND_NAME]' / RIGHT '[TIMEFRAME]'\n\nFlat lay: 'this is the real deal.' — bold white + 3 animated arrows pointing down. '[BRAND_NAME]' below."],
+  ["Purpose",           "Social proof + product authority. Split-screen is the receipt. 'this is the real deal.' closes the credibility loop before the CTA."],
+  ["Transition",        "Hard cut to CTA frame."],
+])
+
+// SCENE 6 — CTA Close
+sceneBlock("SCENE 6 — CTA + OFFER CLOSE", "21–23 seconds  |  Consistent across all variations", [
+  ["Visual Direction",  "Actor back on camera, mini-mic in hand, [PRODUCT_NAME] raised toward camera ([ACTIVE_STATE]). Approving/confident expression. Optional: meme bookend (approving version of Scene 1 meme) for 0.5–1s."],
+  ["Actor Line",        "'[OFFER_TEXT] right now — link in bio.'"],
+  ["On-Screen Text",    "'[OFFER_TEXT]' — large bold\n'[LANDING_PAGE]' — below\n'Shop Now →'\n(Optional: 'Limited time | Results may vary')"],
+  ["Purpose",           "Drive the one action: click. [OFFER] is the urgency mechanism. 2 seconds max — viewer already knows. Just close."],
+])
+```
+
+---
+
+## AI GENERATION PROMPTS (per-scene stubs)
+
+Replace `[PLACEHOLDERS]` with brand-specific values.
+
+```
+SCENE 1 — Muse Hook
+Photoreal female creator, [AI_ACTOR_AGE], natural look, warm skin tone. Bedroom desk. Casual [OUTFIT]. Silver condenser mini-mic in hand. [MEME_CHARACTER] overlay fills lower 60% — creator's eyes visible above. She glances at meme, looks up with knowing half-smile. Authentic TikTok creator bedroom reel. 9:16. 3 seconds.
+
+SCENE 2 — Authority & Problem
+Same creator. Mini-mic in left hand. [PRODUCT_NAME] held casually in right (not presenting). [CATEGORY_ITEMS] slightly out-of-focus on shelf behind. She speaks candidly, slightly frustrated then resolving. Warm golden light. Tight angles: face / hands / shelf. 9:16. 5 seconds.
+
+SCENE 3 — Skeptic Pivot + Reveal
+Same creator. TikTok comment bubble overlaid: 'Is this legit tho?' — she glances at it, smiles, looks at camera. Turns [PRODUCT_NAME] toward lens — [ACTIVE_STATE] faces camera. [ACTIVE_STATE] cinematic and warm. Handheld feel. 9:16. 5 seconds.
+
+SCENE 4 — Product Demo
+Extreme close-up of [PRODUCT_NAME] gliding along skin: [USE_AREA_1], [USE_AREA_2], [USE_AREA_3]. [ACTIVE_STATE] warm and cinematic. Dewy healthy skin texture. Micro-clips, cut every 1.5–2s. Creator's voice continues over. 9:16. 5 seconds.
+
+SCENE 5 — Before/After + Flat Lay
+CLIP 1: Split-screen. LEFT bare natural skin label 'before [BRAND_NAME]' / RIGHT [PRODUCT_NAME] in use label '[TIMEFRAME]'. Matching warm light both sides.
+CLIP 2: [PRODUCT_NAME] centered on white/marble surface. [ACTIVE_STATE]. 3 white arrows pointing down. 'this is the real deal.' bold white text. 9:16. 3 seconds.
+
+SCENE 6 — CTA
+Creator energized, [PRODUCT_NAME] raised toward camera ([ACTIVE_STATE]). Warm, direct smile. Optional: meme bookend 0.5s. Fades to: '[OFFER_TEXT]' bold + '[LANDING_PAGE]' + 'Shop Now →'. 9:16. 2 seconds.
+```
+
+---
+
+## FIRST DEPLOYED — Solawave BOGO Campaign
+
+- Brief: `~/Downloads/Solawave_VideoBrief_KoreanSkincaretruth_v1_20260409.docx`
+- Brand kit: `brands/solawave/brand-kit.md`
+- Script: `/tmp/docx_work/solawave_brief_v1.js`