@growthub/cli 0.3.41 → 0.3.43

package/assets/shared-templates/ad-formats/villain-animation.md

@@ -0,0 +1,183 @@
+# Ad Format: Villain Object Animation
+> ID: `villain-animation`
+> Category: Pet Products / Home Devices / Supplements / Any product displacing an incumbent
+> Length: 90–120 seconds (proven at 98s)
+> Scene Count: 9
+> Hook Variations: 5 (A–E)
+> Status: ✅ PROVEN — Clarifion ODRx brief, April 2026
+> Aspect Ratios: 9:16 primary, 1:1 secondary
+
+---
+
+## MUSE REFERENCE
+
+- **Creator/Brand:** TheraPet (AI animation ad)
+- **URL:** https://www.facebook.com/100068524006696/posts/1227321179562004
+- **Original product featured:** TheraPet pheromone plug-in device (pet behavior / cat marking)
+- **Local muse file:** `~/Downloads/AQN2IbZ…mp4`
+- **Runtime:** 98.47 seconds | 360×640 | 9:16 vertical | 30fps
+- **Why it works:** Long-form agitation stack + villain character format creates emotional investment before the product appears. 4× agitation scenes build genuine frustration — by the time the hero product arrives, the viewer is psychologically primed to want it. Animated villain objects prevent competitor brand legal issues while being more visually memorable than live footage. Tone flip at Scene 6 is a hard emotional reset — the color/warmth change signals "it's over now."
+
+---
+
+## FORMAT SIGNALS (non-negotiable)
+
+1. **Animated villain objects** — competing/failed products rendered as cartoon characters with expressive faces, small arms, frustrated/evil expressions. Never show real competitor branding — use generic category labels ("Enzyme Cleaner," "Scented Plug-In," "Litter Bag").
+2. **4× agitation stack** — Scenes 2–5 are each a different failed solution. Each one ends with the villain still losing / the problem persisting. Do not compress to fewer agitation scenes — the stack is what builds the emotional case.
+3. **Karaoke word-by-word text** — 1–4 words at a time, key word highlighted in brand accent color. This text rhythm is sacred. Full sentences break the format.
+4. **Hard tone flip at Scene 6** — full color, lighting, energy reversal. Cold/chaotic/frustrated → warm/golden/calm. This scene flip is the emotional payoff. It must be distinct — not a gentle transition.
+5. **Product trio reveal** — 3 hero product units on the floor/surface in formation before being plugged in. This staging is consistent across the muse.
+6. **Gray-haired woman social proof** — Carol-type persona in Scene 8 with a calendar on the wall showing the guarantee period. This is the trust anchor before the CTA.
+7. **Stacked product boxes CTA** — Scene 9 shows bundled/stacked product boxes with satisfied animals/characters. Product must be in its packaging, not just the unit.
+
+---
+
+## PROVEN SCENE STRUCTURE
+
+| # | Scene Name | Timecode | Beat | Sacred Element |
+|---|------------|----------|------|----------------|
+| 1 | Hook | 0–17s | Scroll stop — villain established | Villain between 3 competing devices. Agitation energy. Hook line variations A–E. |
+| 2 | Agitation 1 | 17–29s | Failed solution #1 | Villain INSIDE the failed product. Specific dollar amount wasted. |
+| 3 | Agitation 2 | 29–41s | Failed solution #2 | Different villain character / product category. "You've tried [X]..." |
+| 4 | Agitation 3 | 41–50s | Failed solution #3 | Different villain — natural/DIY solutions that also fail. |
+| 5 | Agitation 4 | 50–62s | Failed solution #4 | Most extreme failed solution — medical/pharmaceutical or highest-stakes option. |
+| 6 | Product Intro — TONE FLIP | 62–74s | Hero enters — full emotional reset | Warm lighting ON. Hero product in trio formation on floor, glowing. Problem framing drops. |
+| 7 | Product in Action | 74–83s | Mechanism proof | Product plugged in / in use. Animal/character calm below it. Low camera angle. |
+| 8 | Social Proof | 83–92s | Trust anchor | Carol-type persona + satisfied animals + calendar (guarantee days). |
+| 9 | CTA | 92–98s | Convert | Stacked product boxes + animals + satisfaction guarantee text. |
+
+---
+
+## SCENE MODULES USED IN THIS FORMAT
+
+| Scene | Module ID | File |
+|-------|-----------|------|
+| 1 | `villain-hook` | `hooks/villain-hook.md` |
+| 2–5 | `villain-agitation` × 4 | `body/villain-agitation.md` |
+| 6–7 | product intro + in-action (format-specific — use inline, not modular) | — |
+| 8 | social proof persona (format-specific — use inline) | — |
+| 9 | `guarantee-close` | `cta/guarantee-close.md` |
+
+---
+
+## ADAPTATION RULES
+
+### Keep (sacred)
+- 9 scenes — no exceptions
+- 4 agitation scenes (Scenes 2–5) — never compress to fewer
+- Animated villain object format — never swap to real competitor footage
+- Hard tone flip at Scene 6 — warm/golden must be visually distinct from Scenes 1–5
+- Karaoke word-by-word text rhythm — 1–4 words at a time
+- Gray-haired woman persona in Scene 8 — age and warmth signal are part of the trust mechanic
+- Stacked product boxes in CTA — not just the device
+
+### Swap (per brand)
+- Villain character design — match the category (litter bag for pet, pill bottle for supplement, etc.)
+- Dollar amounts — match what target audience actually spends ($300 on litter, etc.)
+- Calendar day count — match guarantee period exactly (30 days for ODRx, 60 days for TheraPet)
+- Animal type — match product's target animal (cats, dogs, etc.)
+- Guarantee language — must match compliance exactly
+- Product glow color — match brand's device color/LED color
+
+### Never
+- Real competitor brand names — use generic labels
+- "Home stops smelling" → check compliance, may need "room" instead
+- Specific medical claims in agitation scenes — "zombifying" language only if cleared
+- Tone flip before Scene 6 — the first 5 scenes must stay cold/frustrated
+
+---
+
+## AI ACTOR / ANIMATION SPEC
+
+```yaml
+character_style:    "Animated 3D — expressive faces, small arms, exaggerated frustrated emotions"
+villain_format:     "Product objects as characters — litter bags, pill bottles, spray cans, etc. each with villain face"
+hero_product:       "Clean, glowing, warm — NOT animated with face. Product is aspirational, not a character."
+social_proof_persona: "Animated woman, 60–70, gray or white hair, warm smile. 'Carol'-type. Relatable grandmother energy."
+setting_villain:    "Chaotic, dark, cluttered — matches the frustration of the problem"
+setting_hero:       "Warm, golden, organized — immediate visual contrast from villain scenes"
+```
+
+---
+
+## DOCX JS STUBS
+
+Paste these sceneBlock() calls. Replace `[PLACEHOLDERS]`.
+
+```js
+// SCENE 1 — Hook (use sceneBlock + 5 hookCards above it)
+sceneBlock("SCENE 1 — HOOK", "0–17s  |  MUST stop the scroll", [
+  ["Visual Direction", "Animated setting: [PROBLEM_ENVIRONMENT]. Villain character ([VILLAIN_1_TYPE] with angry face + small arms) positioned between 3 competing [PRODUCT_CATEGORY] devices. Chaotic, dim, frustrated energy."],
+  ["On-Screen Text",   "Karaoke word-by-word: [HOOK_LINE] — 1–4 words at a time. Key word highlighted in [BRAND_ACCENT_COLOR]."],
+  ["VO",               "[HOOK_VO_LINE]"],
+  ["Purpose",          "Establish the problem AND the villain in one scene. Viewer must recognize their own frustration immediately."],
+])
+
+// SCENE 2 — Agitation 1
+sceneBlock("SCENE 2 — AGITATION 1", "17–29s  |  Consistent across all variations", [
+  ["Visual Direction", "[VILLAIN_1_TYPE] INSIDE the failed product ([SPECIFIC_PRODUCT]). [ANIMAL/CHARACTER] still frustrated. Same chaotic setting."],
+  ["On-Screen Text",   "Karaoke: '[DOLLAR_AMOUNT_WASTED] / [PRODUCT_CATEGORY] / [FAILURE_STATEMENT]'"],
+  ["VO",               "[AGITATION_1_VO]"],
+  ["Purpose",          "Quantify the pain. Dollar amount makes it visceral. Villain inside the product = the problem is in the product, not the user."],
+])
+
+// SCENES 3–5: repeat sceneBlock pattern with different villain types and products
+
+// SCENE 6 — Tone Flip + Product Intro
+sceneBlock("SCENE 6 — TONE FLIP + PRODUCT INTRO", "62–74s  |  EMOTIONAL RESET", [
+  ["Visual Direction", "FULL TONE FLIP: warm golden lighting replaces cold/chaotic. [HERO_PRODUCT] × 3 units in trio formation on [SURFACE], [ACTIVE_STATE] glowing. [ANIMAL/CHARACTER] present and CALM. No villain characters."],
+  ["On-Screen Text",   "Karaoke: '[UNLIKE_THOSE / PRODUCT_NAME / ALL IN ONE]' — positive framing for first time"],
+  ["VO",               "[PRODUCT_INTRO_VO — first mention of hero product by name]"],
+  ["Purpose",          "Full emotional reset. Problem era is over. Every visual signal (color, warmth, calm animals) signals the solution has arrived."],
+])
+
+// SCENE 7 — Product in Action
+sceneBlock("SCENE 7 — PRODUCT IN ACTION", "74–83s  |  Mechanism proof", [
+  ["Visual Direction", "[HERO_PRODUCT] plugged in / in use. [ACTIVE_STATE] visible. [ANIMAL/CHARACTER] calm and resting below or near device. Low camera angle looking up at product."],
+  ["On-Screen Text",   "Karaoke: '[MECHANISM] / [KEY_BENEFIT] / [TIME_CLAIM]'"],
+  ["VO",               "[MECHANISM_VO — how it works, simply]"],
+  ["Purpose",          "Show the product DOING SOMETHING. The [ACTIVE_STATE] is the proof. Low camera angle makes product feel significant."],
+])
+
+// SCENE 8 — Social Proof
+sceneBlock("SCENE 8 — SOCIAL PROOF", "83–92s  |  Trust anchor", [
+  ["Visual Direction", "Animated [PERSONA_AGE]-year-old woman, warm smile. [ANIMAL/CHARACTER] happy beside her. Calendar on wall showing [GUARANTEE_DAYS] days."],
+  ["On-Screen Text",   "Karaoke: '[GUARANTEE_DAYS] DAYS / [PRODUCT_BENEFIT] / [ACTION]'"],
+  ["VO",               "[SOCIAL_PROOF_VO]"],
+  ["Purpose",          "Human trust anchor before the ask. Calendar = risk reversal is real. Persona age should match target audience."],
+])
+
+// SCENE 9 — CTA
+sceneBlock("SCENE 9 — CTA", "92–98s  |  Convert", [
+  ["Visual Direction", "Bokeh/clean background. Stacked [HERO_PRODUCT] boxes. [ANIMAL/CHARACTER] happy. Satisfaction guarantee badge visible."],
+  ["On-Screen Text",   "Karaoke: '[SOCIAL_PROOF_NUMBER] / [OFFER_TEXT] / [GUARANTEE_TEXT]'"],
+  ["VO",               "[CTA_VO — product name + action + guarantee]"],
+  ["Purpose",          "Drive the one action. Stacked boxes signal availability/popularity. Guarantee removes final objection."],
+])
+```
+
+---
+
+## AI GENERATION PROMPTS (per-scene stubs)
+
+```
+SCENE 1 — Villain Hook
+3D animated [PROBLEM_ENVIRONMENT]. [VILLAIN_1_TYPE] character with angry cartoon face and small arms stands between 3 competing [PRODUCT_CATEGORY] devices. Dark, chaotic, frustrated color palette. [ANIMAL/CHARACTER] present looking unhappy. Karaoke text overlaid word-by-word. 9:16. 17 seconds.
+
+SCENES 2–5 — Agitation Stack
+3D animated [VILLAIN_N_TYPE] character inside/near [FAILED_PRODUCT]. Same chaotic setting. Each scene ends with villain laughing or problem persisting. 9:16. 8–12 seconds each.
+
+SCENE 6 — Tone Flip
+DRAMATIC TRANSITION: cold/chaotic → warm/golden. [HERO_PRODUCT] × 3 units on [SURFACE] glowing [ACTIVE_COLOR]. [ANIMAL/CHARACTER] calm and peaceful. Soft warm ambient lighting replaces all previous harsh tones. 9:16. 12 seconds.
+
+SCENE 9 — CTA Close
+Clean bokeh background. Stacked [HERO_PRODUCT] boxes in pyramid/stack arrangement. [ANIMAL/CHARACTER] happy sitting nearby. Satisfaction guarantee badge in corner. Warm, aspirational lighting. 9:16. 6 seconds.
+```
+
+---
+
+## FIRST DEPLOYED — Clarifion ODRx Campaign
+
+- Brief: `~/Downloads/Clarifion_ODRx_VideoBrief_TheraPetAI_v1_20260408.docx`
+- Brand kit: `brands/clarifion/brand-kit.md`
+- Script: `/tmp/docx_work/odrx_brief_v3.js`

package/assets/shared-templates/manifest.json

@@ -0,0 +1,23 @@
+{
+  "version": "1.0.0",
+  "frozenAt": "2026-04-12T00:00:00.000Z",
+  "source": "creative-strategist-v1",
+  "templates": [
+    { "id": "ad-formats/bedroom-minimic-talk",     "slug": "bedroom-minimic-talk",     "type": "ad-format",    "family": "video-creative", "path": "ad-formats/bedroom-minimic-talk.md" },
+    { "id": "ad-formats/villain-animation",        "slug": "villain-animation",        "type": "ad-format",    "family": "video-creative", "path": "ad-formats/villain-animation.md" },
+    { "id": "ad-formats/process-specialist-medical","slug": "process-specialist-medical","type": "ad-format",  "family": "video-creative", "path": "ad-formats/process-specialist-medical.md" },
+    { "id": "ad-formats/frame-analysis",           "slug": "frame-analysis",           "type": "ad-format",    "family": "video-creative", "path": "ad-formats/frame-analysis.md" },
+    { "id": "scene-modules/hooks/meme-overlay",    "slug": "meme-overlay",             "type": "scene-module", "subtype": "hook", "family": "video-creative", "path": "scene-modules/hooks/meme-overlay.md" },
+    { "id": "scene-modules/hooks/tiktok-comment",  "slug": "tiktok-comment",           "type": "scene-module", "subtype": "hook", "family": "video-creative", "path": "scene-modules/hooks/tiktok-comment.md" },
+    { "id": "scene-modules/hooks/pov-confession",  "slug": "pov-confession",           "type": "scene-module", "subtype": "hook", "family": "video-creative", "path": "scene-modules/hooks/pov-confession.md" },
+    { "id": "scene-modules/hooks/dollar-amount",   "slug": "dollar-amount",            "type": "scene-module", "subtype": "hook", "family": "video-creative", "path": "scene-modules/hooks/dollar-amount.md" },
+    { "id": "scene-modules/hooks/villain-hook",    "slug": "villain-hook",             "type": "scene-module", "subtype": "hook", "family": "video-creative", "path": "scene-modules/hooks/villain-hook.md" },
+    { "id": "scene-modules/body/minimic-problem",  "slug": "minimic-problem",          "type": "scene-module", "subtype": "body", "family": "video-creative", "path": "scene-modules/body/minimic-problem.md" },
+    { "id": "scene-modules/body/tiktok-skeptic-pivot","slug": "tiktok-skeptic-pivot",  "type": "scene-module", "subtype": "body", "family": "video-creative", "path": "scene-modules/body/tiktok-skeptic-pivot.md" },
+    { "id": "scene-modules/body/product-demo-glow","slug": "product-demo-glow",        "type": "scene-module", "subtype": "body", "family": "video-creative", "path": "scene-modules/body/product-demo-glow.md" },
+    { "id": "scene-modules/body/villain-agitation","slug": "villain-agitation",        "type": "scene-module", "subtype": "body", "family": "video-creative", "path": "scene-modules/body/villain-agitation.md" },
+    { "id": "scene-modules/body/before-after-flatlay","slug": "before-after-flatlay",  "type": "scene-module", "subtype": "body", "family": "video-creative", "path": "scene-modules/body/before-after-flatlay.md" },
+    { "id": "scene-modules/cta/bogo-meme-bookend", "slug": "bogo-meme-bookend",        "type": "scene-module", "subtype": "cta",  "family": "video-creative", "path": "scene-modules/cta/bogo-meme-bookend.md" },
+    { "id": "scene-modules/cta/guarantee-close",   "slug": "guarantee-close",          "type": "scene-module", "subtype": "cta",  "family": "video-creative", "path": "scene-modules/cta/guarantee-close.md" }
+  ]
+}

package/assets/shared-templates/scene-modules/INDEX.md

@@ -0,0 +1,151 @@
+# Scene Module Library — INDEX
+> These are the plug-in building blocks. Each module = one scene or one hook variation.
+> Pull a module file → swap `[PLACEHOLDERS]` from brand-kit.md → paste into brief JS.
+> All modules are format-compatible as noted. Mix across formats where marked.
+
+---
+
+## HOW MODULES WORK
+
+Every module contains:
+- **What it does** — the job this scene performs in the ad
+- **Visual direction** — camera, character, setting, lighting
+- **On-screen text** — exact template with `[PLACEHOLDERS]`
+- **Actor dialogue** — full template with delivery notes
+- **JS stub** — ready-to-paste `sceneBlock()` or `hookCard()` row content
+- **AI generation prompt** — ready-to-paste Veo 3 / Runway prompt stub
+- **Brand-kit placeholders** — maps each `[PLACEHOLDER]` to its source field
+
+**Placeholder schema (universal across all modules):**
+```
+[BRAND_NAME]         → brand-kit.md → client_name
+[PRODUCT_NAME]       → brand-kit.md → primary_service
+[PRICE]              → brief content / website
+[OFFER_TEXT]         → brand-kit.md → cta_offer
+[LANDING_PAGE]       → brand-kit.md → landing_page
+[PAIN_POINT]         → brand-kit.md → target_pain_point
+[MECHANISM]          → brand-kit.md → approved_phrases
+[ACTIVE_STATE]       → brief content (device glow, motion, effect)
+[AI_ACTOR_AGE]       → brand-kit.md → ai_actor_age_range
+[ACCENT_COLOR]       → brand-kit.md → colors.secondary (hex, no #)
+[GUARANTEE_DAYS]     → brand-kit.md → compliance_notes
+```
+
+---
+
+## HOOKS
+
+> Scene 1 only. One hook per variation (A–E). Scenes 2–N identical across all variations.
+
+| File | ID | Best For | Format |
+|------|----|----------|--------|
+| `hooks/meme-overlay.md` | `meme-overlay` | Relatable lifestyle pain (tired, broke, frustrated) | `bedroom-minimic-talk` |
+| `hooks/tiktok-comment.md` | `tiktok-comment` | High-skepticism categories; objection-first opens | `bedroom-minimic-talk` |
+| `hooks/pov-confession.md` | `pov-confession` | Mirror moment; female 25–35 demo; skincare/beauty | `bedroom-minimic-talk` |
+| `hooks/dollar-amount.md` | `dollar-amount` | Any category where overspending is the shared pain | `bedroom-minimic-talk`, `villain-animation` |
+| `hooks/villain-hook.md` | `villain-hook` | Animated format; any product displacing incumbents | `villain-animation` |
+
+**Recommended hook pairings (5-variation set):**
+```
+bedroom-minimic-talk (skincare/beauty tech):
+  A: meme-overlay      ← direct muse mirror — test first
+  B: tiktok-comment    ← highest persuasion for skeptical categories
+  C: dollar-amount     ← works for 28–40 Facebook/Meta feed
+  D: product-reveal*   ← custom hook; device with active glow in frame 1
+  E: pov-confession    ← native TikTok; mirror moment
+
+villain-animation (pet / home / supplement):
+  A–E: villain-hook × 5 with different VO lines (see villain-hook.md → Hook Variations section)
+```
+*product-reveal hook = custom variant; write inline in brief, no module file needed.
+
+---
+
+## BODY SCENES
+
+> Scenes 2–N. Identical across all hook variations.
+
+| File | ID | Scene # | Format | Beat |
+|------|----|---------|--------|------|
+| `body/minimic-problem.md` | `minimic-problem` | 2 | `bedroom-minimic-talk` | Authority + failed solutions confession |
+| `body/tiktok-skeptic-pivot.md` | `tiktok-skeptic-pivot` | 3 | `bedroom-minimic-talk` | Skeptic disarm + product intro |
+| `body/product-demo-glow.md` | `product-demo-glow` | 4 | `bedroom-minimic-talk` | Product in active use (glow/effect visible) |
+| `body/villain-agitation.md` | `villain-agitation` | 2–5 (×4) | `villain-animation` | Stacked failed solutions as villain characters |
+| `body/before-after-flatlay.md` | `before-after-flatlay` | 5 | `bedroom-minimic-talk` | Split-screen + "this is the real deal." flat lay |
+
+**Sequencing rules:**
+```
+bedroom-minimic-talk order:
+  minimic-problem → tiktok-skeptic-pivot → product-demo-glow → before-after-flatlay → [CTA]
+
+villain-animation order:
+  villain-agitation × 4 → [product intro inline] → [social proof inline] → [CTA]
+  (product intro + social proof are format-specific — write inline, not from modules)
+```
+
+---
+
+## CTAs
+
+> Final scene only. One CTA per brief. Select based on offer type + format.
+
+| File | ID | Format | Offer Type |
+|------|----|--------|------------|
+| `cta/bogo-meme-bookend.md` | `bogo-meme-bookend` | `bedroom-minimic-talk` | BOGO / % off / any flash offer |
+| `cta/guarantee-close.md` | `guarantee-close` | `villain-animation` | Guarantee + social proof number |
+
+**Offer → module mapping:**
+```
+Buy 1 Get 1 FREE       → bogo-meme-bookend
+% Discount             → bogo-meme-bookend  (swap offer text)
+Free trial             → bogo-meme-bookend  (swap offer text)
+Satisfaction guarantee → guarantee-close
+Bundle deal            → guarantee-close or bogo-meme-bookend depending on format
+```
+
+---
+
+## ASSEMBLY RECIPES
+
+Copy-paste these to brief the production team or start a new JS file.
+
+### Recipe 1: Skincare/Beauty Tech — 23s BOGO (bedroom-minimic-talk)
+```
+Scene 1:  hooks/meme-overlay.md         (Hook A — test first)
+          hooks/tiktok-comment.md        (Hook B)
+          hooks/dollar-amount.md         (Hook C)
+          [custom product-reveal hook]   (Hook D — write inline)
+          hooks/pov-confession.md        (Hook E)
+Scene 2:  body/minimic-problem.md
+Scene 3:  body/tiktok-skeptic-pivot.md
+Scene 4:  body/product-demo-glow.md
+Scene 5:  body/before-after-flatlay.md
+Scene 6:  cta/bogo-meme-bookend.md
+```
+
+### Recipe 2: Pet / Home / Supplement — 90–120s Villain Format
+```
+Scene 1:  hooks/villain-hook.md         (5 variations A–E)
+Scene 2:  body/villain-agitation.md     (Agitation 1 — COST)
+Scene 3:  body/villain-agitation.md     (Agitation 2 — EFFORT)
+Scene 4:  body/villain-agitation.md     (Agitation 3 — FUTILITY)
+Scene 5:  body/villain-agitation.md     (Agitation 4 — RISK)
+Scene 6:  [product intro — write inline]
+Scene 7:  [product in action — write inline]
+Scene 8:  [social proof persona — write inline]
+Scene 9:  cta/guarantee-close.md
+```
+
+---
+
+## ADDING NEW MODULES
+
+When you build a new brief and a scene is clearly reusable:
+1. Create `scene-modules/<type>/<new-id>.md` using any existing module as the template
+2. Add a row to the relevant table above
+3. Add it to `ad-formats/INDEX.md` under the compatible format
+4. Note which brief it was first deployed in at the bottom of the module file
+
+---
+
+*Scene Module Library — Creative Strategy Worker Kit — April 2026*

package/assets/shared-templates/scene-modules/body/before-after-flatlay.md

@@ -0,0 +1,143 @@
+# Scene Module: Before/After + Product Flat Lay
+> ID: `before-after-flatlay`
+> Type: body (Scene 5)
+> Compatible Formats: `bedroom-minimic-talk`
+> Timecode: 18–21s (in 23s format)
+> Status: ✅ PROVEN — Solawave BOGO (Scene 5)
+
+---
+
+## WHAT IT DOES
+
+Two rapid clips back-to-back. First: a split-screen before/after that delivers the social proof in a single glance. Second: a product flat lay with arrows pointing at it and the phrase "this is the real deal." — the product authority close. Together these 3 seconds are the brief's receipt: proof it works, proof of what to buy.
+
+**Why it works:** The split-screen is the most trusted visual format for product proof on TikTok/Reels — viewers parse it instantly. The flat lay + arrows is borrowed from the muse's most persuasive moment — it says "I'm putting the camera on the thing that actually matters" without any words needing to explain it. "this is the real deal." is the copy that closes this scene — it's been proven in the muse and should not be paraphrased.
+
+---
+
+## VISUAL DIRECTION
+
+```
+CLIP 1 — Split-Screen (1.5 seconds):
+  LEFT side:   Bare, natural skin (or before-product state). Label: "before [BRAND_NAME]"
+  RIGHT side:  Same creator/subject with [PRODUCT_NAME] in use ([ACTIVE_STATE]). Label: "[TIMEFRAME]"
+  Lighting:    Matching warm light both sides. NOT dramatic — subtle, believable difference.
+  Note:        "Before" should look normal/real — not intentionally bad. Authenticity > drama.
+
+CLIP 2 — Product Flat Lay (1.5 seconds):
+  Subject:     [PRODUCT_NAME] centered on clean surface (white, marble, or warm wood).
+               [ACTIVE_STATE] ON — product facing camera.
+  Arrows:      3 white animated arrows pointing DOWN toward the product.
+               Appear in sequence (staggered 0.2s each) — not all at once.
+  Text:        "this is the real deal." — bold white text. Appears after arrows.
+  Brand:       "[BRAND_NAME]" in smaller text below.
+  Lighting:    Warm, slightly aspirational. Clean but not clinical.
+```
+
+---
+
+## ON-SCREEN TEXT
+
+```
+CLIP 1 — Split-Screen labels:
+  Left:  "before [BRAND_NAME]" — small, white, top or bottom of left panel
+  Right: "[TIMEFRAME]" — e.g. "week 3" / "day 14" / "30 days"
+         Small, white, top or bottom of right panel.
+  
+  Note: "week 3" not "after 3 weeks" — brevity is required.
+  Note: do not use "after" label — it implies a clinical claim. Use timeframe only.
+
+CLIP 2 — Flat Lay:
+  Line 1: "this is the real deal." — bold, white, all lowercase (muse style)
+  Line 2: "[BRAND_NAME]" — slightly smaller, white
+  Arrows: animated (not static) — stagger entry for dynamism
+```
+
+---
+
+## ACTOR DIALOGUE
+
+```
+Spoken over BOTH clips (continuous):
+
+Pattern: [personal result statement — specific but not a clinical claim]
+
+Template:
+  "This is the real deal. [PERSONAL_RESULT] since before I had a reason to worry about it."
+
+Examples:
+  "This is the real deal. My skin hasn't looked this good since before I had a reason to worry about it."
+  "This is the real deal. The marking stopped. Week 3 — completely different house."
+  "This is the real deal. I stopped counting how many serums are in the trash."
+
+Delivery: Quiet conviction. Not shouting. Not a sales line. Just the truth.
+          "This is the real deal." — slight pause before it. Let it land.
+```
+
+---
+
+## TIMEFRAME CALIBRATION
+
+```
+Use a timeframe that is:
+  - Long enough to be believable (not "next day")
+  - Short enough to be motivating (not "after 6 months")
+  - Consistent with brand compliance guidelines
+
+Calibration guide:
+  Skincare device:   "week 3" / "week 4" / "day 21"
+  Supplement:        "day 30" / "week 6"
+  Pet behavior:      "week 2" / "week 3" (behavior changes faster)
+  Air quality:       "day 3" / "first week" (immediate-ish results credible)
+  
+  Check brand-kit.md → compliance_notes before setting timeframe.
+  Never use exact % improvement without clinical backing.
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `[BRAND_NAME]` | `brand-kit.md → client_name` | "Solawave" |
+| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave wand" |
+| `[ACTIVE_STATE]` | Brief content | "red light glowing" |
+| `[TIMEFRAME]` | Brief content (compliance-checked) | "week 3" |
+| `[PERSONAL_RESULT]` | Brief content | "My skin hasn't looked this good..." |
+
+---
+
+## COMPLIANCE CHECK (run before finalizing)
+
+```
+[ ] No "before/after" labels (use timeframe on right side only)
+[ ] No specific % improvement claim
+[ ] "Results may vary" included in Scene 6 bottom strip if making any outcome statement
+[ ] Timeframe is plausible and consistent with brand-kit.md → compliance_notes
+[ ] "this is the real deal." is a subjective personal statement — not a clinical claim ✓
+```
+
+---
+
+## JS STUB (sceneBlock row content)
+
+```js
+// Drop into sceneBlock() rows array for Scene 5
+["Visual Direction",  "(1) Split-screen 1.5s: bare [skin/state] LEFT 'before [BRAND_NAME]' — [PRODUCT_NAME] in use RIGHT '[TIMEFRAME]'. Matching warm light both sides.\n\n(2) Product flat lay: [PRODUCT_NAME] centered on [SURFACE]. [ACTIVE_STATE]. 3 staggered white arrows pointing down. 'this is the real deal.' bold white. '[BRAND_NAME]' below."],
+["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 + '[BRAND_NAME]'"],
+["Compliance note",   "No % claims. No 'after' label. '[TIMEFRAME]' only. 'Results may vary' in Scene 6 strip."],
+["Purpose",           "Social proof + product authority. Split-screen is the receipt. 'this is the real deal.' closes the credibility loop before CTA."],
+["Transition",        "Hard cut to CTA frame."],
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+CLIP 1 (split-screen): Two-panel vertical split. LEFT: creator bare natural [skin/state], soft warm light, small label 'before [BRAND_NAME]'. RIGHT: same creator with [PRODUCT_NAME] in use [ACTIVE_STATE], small label '[TIMEFRAME]'. Matching warm ambient light both panels. Authentic, subtle difference — not dramatic. 9:16. 1.5 seconds.
+
+CLIP 2 (flat lay): [PRODUCT_NAME] centered on [white marble/warm wood] surface. [ACTIVE_STATE] facing camera. Warm soft light. 3 white arrows animated in sequence pointing down at product. 'this is the real deal.' appears in bold white after arrows. Clean, minimal. 9:16. 1.5 seconds.
+```

package/assets/shared-templates/scene-modules/body/minimic-problem.md

@@ -0,0 +1,109 @@
+# Scene Module: Mini-Mic Problem Confession
+> ID: `minimic-problem`
+> Type: body (Scene 2)
+> Compatible Formats: `bedroom-minimic-talk`
+> Timecode: 3–8s (in 23s format)
+> Status: ✅ PROVEN — Solawave BOGO (Scene 2)
+
+---
+
+## WHAT IT DOES
+
+The creator lists the things she's already tried — with specificity. Mini-mic in hand, product held casually in the other (not showcasing it yet). The point is to establish shared experience: she's not naive, she's done the work, nothing worked. This converts the viewer from skeptic to peer before the product is ever named.
+
+**Why it works:** Shared struggle = trust. If she's tried the same $300 serums and $120 eye creams the viewer has, she has earned the right to recommend something. The casual product hold (not presenting it) creates subconscious anticipation — the viewer wonders what she's holding — without feeling sold to.
+
+---
+
+## VISUAL DIRECTION
+
+```
+Frame:    Creator close-up. Mini-mic in one hand at chin/chest level.
+          [PRODUCT_NAME] held casually in OTHER hand — not presented, just held.
+          Skincare/category items slightly out-of-focus in background (shelf, counter).
+Lighting: Warm ambient — same bedroom setup as hook scene.
+Camera:   Tight angles alternating: face → hands/product → face.
+          Slight low angle — intimate, confiding.
+Duration: 4–5 seconds.
+```
+
+---
+
+## ON-SCREEN TEXT
+
+```
+Lists the failed products/attempts the creator has tried.
+Appears as stacked caption beats, not all at once.
+
+Template:
+  "[FAILED_CATEGORY_1]. [FAILED_CATEGORY_2]. [FAILED_CATEGORY_3]."
+  Key words bolded. White text, black outline. Bottom third.
+
+Examples:
+  "serums. eye creams. sheet masks."
+  "$600 red light panels. microneedling. facials."
+  "clay litter. crystal litter. enzyme cleaner."
+  "supplements. probiotics. prescription topicals."
+```
+
+---
+
+## ACTOR DIALOGUE
+
+```
+Pattern: [category items tried + dollar anchor] + [the honest failure] + [leads into product]
+
+Full template:
+  "I've tried [FAILED_1]. [FAILED_2]. [FAILED_3]. [DOLLAR_AMOUNT] later.
+   Nothing was giving me what I actually needed for [PAIN_POINT]."
+
+Short template (for tighter edits):
+  "[DOLLAR_AMOUNT] on [CATEGORY_PRODUCTS]. Nothing for [PAIN_POINT]. Until this."
+
+Delivery: Candid, slightly frustrated — but resolved. She's past the frustration.
+          This is the origin story, not the complaint. Keep it moving.
+          Target: 4–5 seconds spoken, ~30–35 words max.
+```
+
+---
+
+## TRANSITION OUT
+
+```
+Direct cut to the product being lifted into frame (Scene 3 — Skeptic Pivot).
+OR: Creator lifts the product naturally at end of line — camera follows.
+Do NOT fade or wipe — this format uses hard cuts throughout.
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `[FAILED_1/2/3]` | Brief content + category research | "serums / eye creams / sheet masks" |
+| `[DOLLAR_AMOUNT]` | Brief content | "$300" |
+| `[CATEGORY_PRODUCTS]` | Brief content | "serums and red light panels" |
+| `[PAIN_POINT]` | `brand-kit.md → target_pain_point` | "fine lines" / "cat odor" |
+| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave wand" |
+
+---
+
+## JS STUB (sceneBlock row content)
+
+```js
+// Drop into sceneBlock() rows array for Scene 2
+["Visual Direction", "AI actor close-up, mini-mic in one hand at chin level. [PRODUCT_NAME] held casually in other hand — not presenting, just holding. [CATEGORY_ITEMS] slightly out-of-focus on shelf behind. Warm ambient light. Tight alternating angles: face / hands."],
+["Actor Line",       "'I've tried [FAILED_1], [FAILED_2], [FAILED_3]. [DOLLAR_AMOUNT] later. Nothing was giving me what I actually needed for [PAIN_POINT].'"],
+["On-Screen Text",   "'[FAILED_1]. [FAILED_2]. [FAILED_3].' — stacked caption beats. Key words bold."],
+["Purpose",          "Build credibility through shared experience. Positions [PRODUCT_NAME] reveal as earned discovery, not ad pitch."],
+["Transition",       "Direct cut to [PRODUCT_NAME] lifted into frame for Scene 3."],
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+Photoreal female creator, [AI_ACTOR_AGE], natural look. Bedroom desk. Silver mini-mic in left hand at chin level. [PRODUCT_NAME] held casually in right hand (not presenting — just in hand). [CATEGORY_ITEMS] slightly blurred on shelf behind. She speaks directly and candidly — slightly frustrated resolving to confident. Warm golden ambient light. Tight alternating angles: face close-up / hands + product. Handheld feel. 9:16. 5 seconds.
+```