@growthub/cli 0.14.4 → 0.14.6

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

@@ -1,343 +0,0 @@
-# Creative Strategist Worker Skill
-## Video Creative Brief Production  |  Multi-Brand System
-
-> **Who this is for:** Any agent (Claude is first-party; Cursor / Codex / Gemini / custom harnesses are equally supported) operating inside `${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/` and producing a Video Creative Brief.
-> Read this file fully before starting. Every section is a required step.
->
-> **Workspace path:** all commands below reference the kit workspace via the `CREATIVE_STRATEGIST_HOME` env var. Default: `$HOME/creative-strategist`. Override it to any directory (e.g. `export CREATIVE_STRATEGIST_HOME=$HOME/claude-workers`) to mount your own brand/template tree without forking this kit.
-
----
-
-## 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 ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/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 ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/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 ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/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=${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/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 ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/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: $HOME/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 "$HOME/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" \
-  >> ${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/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
-
-```
-${CREATIVE_STRATEGIST_HOME:-$HOME/creative-strategist}/
-├── 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

@@ -1,94 +0,0 @@
-# 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

@@ -1,197 +0,0 @@
-# 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`