@growthub/cli 0.3.34 → 0.3.36

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/body/villain-agitation.md

@@ -0,0 +1,156 @@
+# Scene Module: Villain Agitation Stack
+> ID: `villain-agitation`
+> Type: body (Scenes 2–5)
+> Compatible Formats: `villain-animation`
+> Timecode: ~12s per scene (in 98s format); stack 4× for full agitation arc
+> Status: ✅ PROVEN — Clarifion ODRx brief (Scenes 2–5)
+
+---
+
+## WHAT IT DOES
+
+Each agitation scene introduces a different failed solution as an animated villain character. The viewer has tried this product too — and it failed them. Four stacked scenes build frustration to a crescendo before the hero product arrives. Each scene must feature a DIFFERENT villain and a DIFFERENT angle on the failure (cost, effort, danger, futility).
+
+**Why it works:** The agitation stack is the emotional engine of this format. One failed solution is forgivable. Four failed solutions, each with its own villain character, builds a case that the problem is systemic — not the viewer's fault. By Scene 5, the viewer is primed to accept anything that actually works. The villain character format externalises the blame onto the product, not the person.
+
+**Critical rule:** Stack exactly 4 agitation scenes (Scenes 2–5). Never fewer. The emotional build requires the full stack to work.
+
+---
+
+## SCENE STRUCTURE (one agitation = one villain)
+
+```
+Per-scene structure:
+  Setting:   Same problem environment as Scene 1, slightly different angle/focus.
+  Villain:   Different villain character than previous scene.
+  Focus:     A different dimension of failure: COST / EFFORT / RISK / FUTILITY.
+  Text:      Karaoke word-by-word, 1–4 words per beat.
+  VO:        Direct address — "You've tried X. And Y. Because Z. But [problem] is still there."
+  End beat:  Villain triumphant OR problem persisting — reinforces futility.
+```
+
+**4-Agitation Arc (proven order):**
+| # | Villain Type | Failure Dimension | Karaoke Focus |
+|---|---|---|---|
+| Agitation 1 | Most common solution in category | COST ("You've spent $X") | Dollar amount wasted |
+| Agitation 2 | Secondary common solution | EFFORT ("You've tried everything in X") | Number of attempts |
+| Agitation 3 | Natural/DIY alternatives | FUTILITY ("Natural options that still failed") | Still happening |
+| Agitation 4 | Most extreme/medical solution | RISK ("Even the risky option didn't help") | Side effects / extremity |
+
+---
+
+## VISUAL DIRECTION (per agitation scene)
+
+```
+Villain:   New character — different product category from previous scenes.
+           Same animation style: expressive face, small arms, frustrated/smug emotion.
+           Specific to the failed product: litter bag, pill bottle, spray can, serum tube, etc.
+
+Setting:   Same core environment. Small variation in angle or focus area.
+           Lighting: still dark/cool/chaotic — no warmth enters until Scene 6.
+
+Animals/characters: Present in every scene. Still unhappy/frustrated.
+                    Emotional state mirrors the ongoing problem, not resolution.
+
+Beat:      Scene ends with villain still "winning" — problem unresolved.
+           This is CRITICAL — do not let agitation scenes accidentally imply progress.
+```
+
+---
+
+## ON-SCREEN TEXT (karaoke)
+
+```
+Format: 1–4 words per beat, 0.5–1 second each. Key word in [BRAND_ACCENT_COLOR].
+
+Agitation 1 — COST:
+  "YOU'VE SPENT" → "$[AMOUNT]" → "IN EVERY" → "[ROOM/AREA]"
+  "RIGHT NEXT TO" → "[ANIMAL/PERSON]" → "YOU ARE JUST" → "[FAILURE_OUTCOME]"
+
+Agitation 2 — EFFORT:
+  "YOU'VE TRIED" → "[PRODUCT_CATEGORY]" → "AND YOUR [ANIMAL/PERSON]" → "[PROBLEM_PERSISTS]"
+  "[SPECIFIC_PROBLEM]" → "SYSTEM" → "[STILL]" → "HAPPENING"
+
+Agitation 3 — FUTILITY (natural/DIY):
+  "YOU'VE TRIED" → "[NATURAL_SOLUTION_1]" → "AND [SOLUTION_2]" → "AND [SOLUTION_3]"
+  "PROBLEM IS" → "[STILL]" → "EXACTLY WHERE" → "[THEY/IT] [LEFT/IS]"
+
+Agitation 4 — RISK/EXTREME:
+  "[EXTREME_OPTION]" → "SURE [SIDE_EFFECT]" → "WON'T [POSITIVE_THING]" → "WON'T [ANOTHER_POSITIVE]"
+  "YOU GOT" → "[NEGATIVE_OUTCOME]" → "YOU'RE [VERB]-ING" → "THEM"
+```
+
+---
+
+## ACTOR/VO DIALOGUE (per scene)
+
+```
+Pattern: [acknowledges the solution tried] + [why it seemed reasonable] + [why it still failed]
+
+Agitation 1 template:
+  "You've spent [AMOUNT] on [PRODUCT_CATEGORY]. Put [PRODUCT] in every [LOCATION].
+   Right next to [ANIMAL/PERSON]. You are just [FAILURE_OUTCOME]."
+
+Agitation 2 template:
+  "You've tried [PRODUCT_TYPE_1]. And [PRODUCT_TYPE_2]. And [PRODUCT_TYPE_3].
+   [PROBLEM] is [still exactly where it was / happening every day]."
+
+Agitation 3 template:
+  "You've tried [NATURAL_1] and [NATURAL_2] and [NATURAL_3].
+   The problem doesn't care. [VILLAIN] is still [LAUGHING / THERE / WINNING]."
+
+Agitation 4 template:
+  "Sure — [EXTREME_OPTION] works. But [SIDE_EFFECT_1] and [SIDE_EFFECT_2].
+   [NEGATIVE_FRAMING]. You're [VERB]-ing [THEM/IT]."
+
+Delivery: Tone escalates across the 4 scenes — empathetic (S2) → exasperated (S3) → incredulous (S4) → almost absurd (S5).
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example (ODRx) |
+|-------------|--------|----------------|
+| `[VILLAIN_N_TYPE]` | Brief content | "animated litter bag" / "pill bottle" / "enzyme cleaner" |
+| `[PRODUCT_CATEGORY]` | Brief content | "litter boxes" / "serums" / "supplements" |
+| `[AMOUNT]` | Brief content | "$300" / "$500" |
+| `[NATURAL_SOLUTION_N]` | Brief content | "vinegar" / "baking soda" / "enzyme spray" |
+| `[EXTREME_OPTION]` | Brief content | "Floxetine" / "prescription topicals" / "laser" |
+| `[BRAND_ACCENT_COLOR]` | `brand-kit.md → colors.secondary` | "2C7FF8" |
+
+---
+
+## ADAPTATION RULES
+
+- **Agitation 1** always = the most common/expected solution (highest viewer recognition)
+- **Agitation 4** always = the most extreme option (creates emotional peak before the flip)
+- Never use real competitor brand names — use generic category labels
+- Each villain must be visually distinct from all others — different shape, color, personality
+- Dollar amounts should reflect real category spend — research before writing
+- Never let any agitation scene accidentally solve the problem or imply partial improvement
+
+---
+
+## JS STUB (sceneBlock — replicate 4× with different values)
+
+```js
+// Agitation 1
+sceneBlock("SCENE 2 — AGITATION 1", "17–29s  |  Consistent across all variations", [
+  ["Visual Direction", "[VILLAIN_1_TYPE] character INSIDE / ON [FAILED_PRODUCT_1]. [ANIMAL/CHARACTER] still frustrated. Dark chaotic setting. Same environment as Scene 1."],
+  ["On-Screen Text",   "Karaoke: 'YOU\\'VE SPENT' → '$[AMOUNT]' → '[FAILURE_CONTEXT]' — key word in [ACCENT_COLOR]."],
+  ["VO",               "'You\\'ve spent [AMOUNT] on [PRODUCT_CATEGORY]. [FAILURE_DETAIL]. You are just [FAILURE_OUTCOME].'"],
+  ["Purpose",          "Quantify the cost of the problem. Dollar amount makes the pain visceral. Villain inside the product = problem is IN the product, not the viewer."],
+])
+
+// Replicate for Agitation 2, 3, 4 — change villain, product, failure dimension
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+AGITATION [N]:
+3D animated [PROBLEM_ENVIRONMENT]. New villain: [VILLAIN_N_TYPE] with expressive cartoon face ([EMOTION]) and small arms. Positioned in/near [FAILED_PRODUCT_N]. [ANIMAL/CHARACTER] nearby, still unhappy. Dark cool chaotic lighting — identical to previous agitation scenes. Villain ends scene still triumphant / problem unresolved. Karaoke text overlaid. 9:16. 12 seconds.
+```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/cta/bogo-meme-bookend.md

@@ -0,0 +1,144 @@
+# Scene Module: BOGO + Meme Bookend Close
+> ID: `bogo-meme-bookend`
+> Type: cta (Scene 6 / final scene)
+> Compatible Formats: `bedroom-minimic-talk`
+> Timecode: 21–23s (in 23s format)
+> Status: ✅ PROVEN — Solawave BOGO (Scene 6)
+
+---
+
+## WHAT IT DOES
+
+The ad closes with two elements in rapid sequence: (1) the meme bookend — same character from Scene 1, now in an approving/satisfied state — and (2) a clean offer overlay with the BOGO/discount and landing page. The meme bookend is the emotional payoff: the journey from tired/frustrated to approved/satisfied, visualised in the same character.
+
+**Why it works:** The meme bookend creates a narrative closure that feels earned, not manufactured. The viewer subconsciously tracks the character from Scene 1 (problem state) to Scene 6 (resolved state) — it's a micro-story arc in 2 seconds. The offer overlay follows immediately so the emotional high converts to action before the feeling fades. "link in bio" is the lowest-friction CTA on TikTok/Reels.
+
+---
+
+## VISUAL DIRECTION
+
+```
+Opening (0.5–1s): Optional meme bookend
+  Same meme character from Scene 1, now in APPROVING / SATISFIED state.
+  e.g. D.W. Arthur meme — smiling version / "we did it" version
+  Overlaid on creator as in Scene 1 — creator's face visible above.
+  Duration: 0.5–1 second max. Blink-and-you-see-it.
+
+Main CTA (1–1.5s): Creator on camera
+  Actor back on camera, energized. Mini-mic in one hand.
+  [PRODUCT_NAME] raised toward camera — [ACTIVE_STATE] facing lens.
+  Expression: warm, direct, genuine "you should do this" energy.
+  NOT a scripted-looking smile — real confidence.
+
+Outro (0.5s): Offer graphic overlay
+  Clean graphic appears over or after creator:
+  Large: "[OFFER_TEXT]" — bold, brand primary or white on dark
+  Medium: "[LANDING_PAGE]"
+  Small: "Shop Now →" or "Link in bio →"
+  Optional strip: "Limited time  |  Results may vary"
+```
+
+---
+
+## ON-SCREEN TEXT
+
+```
+OFFER_TEXT options (bold, large, centered):
+  "BUY 1 GET 1 FREE"
+  "[X]% OFF — TODAY ONLY"
+  "FREE [GIFT/TRIAL] WITH ORDER"
+  "LIMITED TIME OFFER"
+
+LANDING_PAGE:
+  "[BRAND_SLUG].co" or full URL — white, smaller than offer text.
+
+CTA BUTTON TEXT:
+  "Shop Now →"
+  "Link in bio →"
+  "Grab yours →"
+
+COMPLIANCE STRIP (bottom, very small):
+  "Limited time offer  |  Results may vary"
+  Only include if making outcome claims elsewhere in the ad.
+```
+
+---
+
+## ACTOR DIALOGUE
+
+```
+Pattern: [offer text spoken directly] + [lowest-friction action]
+
+Templates:
+  "[OFFER_TEXT] right now — link in bio."
+  "It's [OFFER_TEXT] right now. Link in bio, go."
+  "[OFFER_TEXT] at [LANDING_PAGE] — I'll link it."
+  "[OFFER_TEXT]. Link below."
+
+Delivery: Direct, energetic, brief. Max 8 words. No explanation of the offer.
+          The viewer already knows what Solawave is — just close.
+          The meme bookend (if used) covers the one second before this line.
+```
+
+---
+
+## OFFER TYPES THIS MODULE SUPPORTS
+
+| Offer | CTA Text | Urgency Signal |
+|-------|----------|----------------|
+| Buy 1 Get 1 Free | "BUY 1 GET 1 FREE" | Default urgency inherent |
+| % Discount | "[X]% OFF — TODAY ONLY" | "TODAY ONLY" adds scarcity |
+| Free gift with order | "FREE [GIFT] WITH YOUR ORDER" | Limited supply implied |
+| Bundle deal | "[BUNDLE NAME] — [PRICE]" | Value framing |
+| Free trial | "TRY FREE — LINK IN BIO" | Risk-free conversion |
+
+---
+
+## MEME BOOKEND SELECTION
+
+```
+Rule: Same meme character as Scene 1, emotional state FLIPPED.
+      Problem state in Scene 1 → Resolved/approving state in Scene 6.
+
+Pairings:
+  Scene 1: D.W. (tired, dark circles) → Scene 6: D.W. (smiling, "old rebecca approves")
+  Scene 1: Crying meme              → Scene 6: Same character happy/relieved
+  Scene 1: "this is fine" dog        → Scene 6: Dog in better situation / unbothered
+  Scene 1: Sad Keanu                 → Scene 6: Content Keanu (rare but works)
+  Scene 1: "me after $300 on serums" → Scene 6: "me after [PRODUCT_NAME]" same format
+
+If no meme was used in Scene 1: skip the bookend. Use creator-only CTA.
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `[OFFER_TEXT]` | `brand-kit.md → cta_offer` | "BUY 1 GET 1 FREE" |
+| `[LANDING_PAGE]` | `brand-kit.md → landing_page` | "solawave.co" |
+| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave wand" |
+| `[ACTIVE_STATE]` | Brief content | "red light glowing" |
+| `[MEME_CHARACTER_RESOLVED]` | Matches Scene 1 meme | "D.W. from Arthur — smiling version" |
+
+---
+
+## JS STUB (sceneBlock row content)
+
+```js
+// Drop into sceneBlock() rows array for Scene 6
+["Visual Direction",  "Optional: [MEME_CHARACTER_RESOLVED] bookend overlaid 0.5–1s (same character as Scene 1, approving state).\n\nActor: mini-mic in hand, [PRODUCT_NAME] raised toward camera ([ACTIVE_STATE]). Warm energized expression.\n\nOutro graphic: '[OFFER_TEXT]' bold + '[LANDING_PAGE]' + 'Shop Now →'. Optional strip: 'Limited time | Results may vary'."],
+["Actor Line",        "'[OFFER_TEXT] right now — link in bio.'"],
+["On-Screen Text",    "'[OFFER_TEXT]' — large bold\n'[LANDING_PAGE]'\n'Shop Now →'\n(Optional: 'Limited time  |  Results may vary')"],
+["Mirrors (muse)",    "Meme bookend close mirrors muse's 'old rebecca approves' exit. Humor register stays through CTA — doesn't feel like an ad break.\n\nActor holding product up = muse holding products throughout."],
+["Purpose",           "Drive the one action: click the link. [OFFER] is the urgency mechanism. 2 seconds max — viewer already knows. Just close."],
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+Photoreal female creator, [AI_ACTOR_AGE], energized expression. Bedroom setting with slightly brighter warm light than previous scenes. Mini-mic in one hand, [PRODUCT_NAME] raised toward camera in other hand ([ACTIVE_STATE] facing lens). Warm, direct smile — genuine not performative. Optional opening 0.5s: [MEME_CHARACTER_RESOLVED] overlay (approving/satisfied version of Scene 1 meme). Transitions to clean offer graphic overlay: '[OFFER_TEXT]' bold + '[LANDING_PAGE]' + 'Shop Now →'. 9:16. 2 seconds.
+```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/cta/guarantee-close.md

@@ -0,0 +1,143 @@
+# Scene Module: Guarantee Calendar Close
+> ID: `guarantee-close`
+> Type: cta (Scene 9 / final scene)
+> Compatible Formats: `villain-animation`
+> Timecode: 92–98s (in 98s format)
+> Status: ✅ PROVEN — Clarifion ODRx brief (Scene 9)
+
+---
+
+## WHAT IT DOES
+
+Closes the ad with stacked product boxes, satisfied animals/characters, and a satisfaction guarantee badge. The guarantee is the final objection remover — it converts "this looks good but I'm not sure" into "what do I have to lose?" The bokeh/clean background isolates the product and the proof, removing all cognitive clutter before the ask.
+
+**Why it works:** After 4 agitation scenes and a product reveal, the viewer wants the product but fears waste. The guarantee calendar (already seen in Scene 8 social proof) is called back here — but now it's in the context of the CTA, not just social proof. Stacked product boxes signal popularity and availability. Satisfied animals complete the emotional arc: problem → solution → peace.
+
+---
+
+## VISUAL DIRECTION
+
+```
+Setting:  Clean bokeh background. Soft warm out-of-focus environment.
+          No environment clutter — complete contrast to Scenes 1–5.
+
+Products: [HERO_PRODUCT] × 1–3 boxes stacked or arranged.
+          Shows product packaging (box), not just the device.
+          Stacking implies popularity/bundle/value.
+
+Animals/Characters: [ANIMAL/CHARACTER] present and visibly calm/happy.
+                    Positioned near or beside the product stack.
+                    This is the "everything is resolved" signal.
+
+Badge:    Satisfaction guarantee badge visible in corner or overlaid.
+          Shows [GUARANTEE_DAYS]-day guarantee explicitly.
+
+Animation: Subtle particle or glow effect optional — aspirational, not distracting.
+```
+
+---
+
+## ON-SCREEN TEXT
+
+```
+Karaoke beats (continue word-by-word rhythm from throughout the ad):
+  "[SOCIAL_PROOF_NUMBER]" → "PARENTS/CUSTOMERS" → "ALREADY" → "[TRIED/TRUSTED]"
+  "[OFFER_TEXT]" → "FREE [BENEFIT]" → "IN [TIMEFRAME]"
+  "[GUARANTEE_DAYS] DAY" → "[GUARANTEE_TYPE]" → "GUARANTEED"
+
+CTA overlay (final 2 seconds):
+  Line 1: "[OFFER_TEXT]" — large, bold
+  Line 2: "[LANDING_PAGE]"  
+  Line 3: "Shop Now →" or "Order Today →"
+  Badge:  "[GUARANTEE_DAYS]-Day Satisfaction Guarantee"
+```
+
+---
+
+## ACTOR/VO DIALOGUE
+
+```
+Pattern: [social proof number] + [offer] + [guarantee as risk-removal]
+
+Full template:
+  "[NUMBER] [CUSTOMERS/PET PARENTS] already [trusted/tried] [PRODUCT_NAME].
+   [OFFER_TEXT]. And if it doesn't work — [GUARANTEE_DAYS]-day money back. Guaranteed."
+
+Short template:
+  "[OFFER_TEXT] at [LANDING_PAGE]. [GUARANTEE_DAYS] days, money back. Try it."
+
+Delivery: Confident, calm, direct. The VO has earned trust through the ad — no need to push.
+          "Guaranteed" is the last word heard — it neutralises the final hesitation.
+```
+
+---
+
+## GUARANTEE CALIBRATION
+
+```
+Match EXACTLY to brand-kit.md → compliance_notes and the actual guarantee offered.
+
+Common guarantee periods:
+  30 days: Standard consumer product guarantee
+  60 days: Premium / higher-ticket product
+  90 days: Supplement category standard
+
+Language compliance:
+  ✅ "[N]-Day Satisfaction Guarantee"
+  ✅ "[N]-Day Money Back Guarantee"  
+  ✅ "Try it risk-free for [N] days"
+  ❌ "It will definitely work" — never
+  ❌ "100% guaranteed results" — never (results may vary required)
+  
+  Always verify against brand-kit.md → compliance_notes before finalizing.
+```
+
+---
+
+## SOCIAL PROOF NUMBER
+
+```
+Use a real number if available from brand assets.
+If not available, use ranges: "thousands of" / "over 10,000" / "[X]K+ customers"
+
+Sources to check:
+  - brand-kit.md → previous_ads / asset_links
+  - Brand website (review count, customer count)
+  - Instagram / TikTok (follower / engagement signal)
+  
+Never fabricate a specific number without brand confirmation.
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `[HERO_PRODUCT]` | `brand-kit.md → primary_service` | "Clarifion ODRx" |
+| `[ANIMAL/CHARACTER]` | Brief content | "happy cats" / "calm dog" |
+| `[GUARANTEE_DAYS]` | `brand-kit.md → compliance_notes` | "30" / "60" |
+| `[OFFER_TEXT]` | `brand-kit.md → cta_offer` | "Buy 1 Get 1 FREE" |
+| `[LANDING_PAGE]` | `brand-kit.md → landing_page` | "info.clarifionodrx.com" |
+| `[SOCIAL_PROOF_NUMBER]` | Brand research | "10,000+" / "thousands of" |
+| `[BRAND_ACCENT_COLOR]` | `brand-kit.md → colors.secondary` | "2C7FF8" |
+
+---
+
+## JS STUB (sceneBlock row content)
+
+```js
+// Drop into sceneBlock() rows array for final CTA scene
+["Visual Direction",  "Bokeh/clean background. [HERO_PRODUCT] × 1–3 boxes stacked. [ANIMAL/CHARACTER] calm and happy nearby. Satisfaction guarantee badge visible. Subtle warm glow — aspirational, not clinical."],
+["On-Screen Text",    "Karaoke: '[SOCIAL_PROOF_NUMBER]' → 'ALREADY' → '[TRUSTED]'\n\nCTA overlay: '[OFFER_TEXT]' large bold + '[LANDING_PAGE]' + 'Shop Now →' + '[GUARANTEE_DAYS]-Day Satisfaction Guarantee' badge."],
+["VO",                "'[SOCIAL_PROOF_NUMBER] [customers] already [trusted] [PRODUCT_NAME]. [OFFER_TEXT]. [GUARANTEE_DAYS] days, money back. Guaranteed.'"],
+["Purpose",           "Remove the final objection: risk of waste. Guarantee converts hesitation to action. Stacked boxes = popularity signal."],
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+3D animated bokeh background — clean, warm, soft focus. [HERO_PRODUCT] boxes stacked in pyramid or neat stack (2–3 boxes, packaging visible). [ANIMAL/CHARACTER] seated calmly beside the stack — happy, peaceful expression. Satisfaction guarantee badge in lower corner. Warm aspirational lighting. Subtle particle glow effect optional. Karaoke text overlaid word-by-word. Final 2s: CTA overlay '[OFFER_TEXT]' + '[LANDING_PAGE]' + 'Shop Now →'. 9:16. 6 seconds.
+```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/hooks/dollar-amount.md

@@ -0,0 +1,105 @@
+# Scene Module: Dollar Amount Confession Hook
+> ID: `dollar-amount`
+> Type: hook (Scene 1)
+> Compatible Formats: `bedroom-minimic-talk`, `villain-animation`
+> Status: ✅ PROVEN — Solawave BOGO (Hook C)
+
+---
+
+## WHAT IT DOES
+
+Opens with a specific dollar amount the viewer has already wasted on the category. No product shown. No solution yet. Just the number — and the frustration. The specificity of the dollar amount is what makes it land: "spent $300 on serums" is a receipt the viewer recognizes from their own life.
+
+**Why it works:** Specificity creates credibility. "$300" is a real number that signals the creator has lived the same experience. Vague language ("I tried so many things") is forgettable. A dollar amount is a memory trigger. Works across all demographics — everyone has overspent on something that didn't work.
+
+---
+
+## VISUAL DIRECTION
+
+```
+Frame:   Creator at desk, mini-mic in hand. Leaning slightly toward camera.
+         No product shown. No meme overlay. Pure spoken confession.
+         Expression: slightly exasperated → resolving to knowing.
+Lighting: Warm ambient bedroom. Consistent with rest of format.
+```
+
+**Variation: Text-over-shoulder stack**
+Dollar amount and product list appear as stacked text overlaid beside the creator's face:
+```
+"$300 on serums ❌"
+"$120 eye cream ❌"  
+"red light panel $600 ❌"
+```
+
+---
+
+## ON-SCREEN TEXT
+
+```
+Option A — Single stat:
+  "spent $[AMOUNT] on [CATEGORY]. still [PROBLEM]."
+
+Option B — Stack:
+  "$[AMOUNT_1] on [PRODUCT_1] ❌"
+  "$[AMOUNT_2] on [PRODUCT_2] ❌"
+  "$[AMOUNT_3] on [PRODUCT_3] ❌"
+
+Style:  White text, black outline. Dollar amounts bolded.
+        ❌ emoji optional — signals failure visually without words.
+```
+
+---
+
+## ACTOR DIALOGUE
+
+```
+Pattern: [dollar amount + category] + [the failure] + [discovery pivot]
+
+Templates:
+  "I was that person. [AMOUNT] on [CATEGORY]. Zero results. Then I found this."
+  "Spent [AMOUNT] on [CATEGORY_PRODUCTS]. Nothing was working. Until [PRODUCT_NAME]."
+  "I did the [AMOUNT] routine. The whole thing. Didn't move the needle."
+
+Delivery: Matter-of-fact. Not self-pitying. She's moved past it — this is the origin story.
+          Slight emphasis on the dollar amount.
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `[AMOUNT]` | Brief context / category research | "$300" / "$500" / "$150" |
+| `[CATEGORY]` | `brand-kit.md → industry` | "serums" / "supplements" / "litter" |
+| `[CATEGORY_PRODUCTS]` | Brief content | "serums, eye creams, sheet masks" |
+| `[PROBLEM]` | `brand-kit.md → target_pain_point` | "still saw fine lines" |
+| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave" |
+
+**Amount calibration by category:**
+- Skincare/beauty: $150–$400
+- Pet products: $200–$500
+- Home devices: $300–$800
+- Supplements: $100–$300
+
+---
+
+## JS STUB (hookCard)
+
+```js
+hookCard("C", "Dollar Amount Confession",
+  "VISUAL: Actor at desk, mini-mic in hand, leaning toward camera. No meme, no product. Pure confession.\n" +
+  "Optional: stacked text overlay beside face listing products + prices + ❌.\n\n" +
+  "ON-SCREEN TEXT: 'spent $[AMOUNT] on [CATEGORY]. still [PROBLEM].'\n\n" +
+  "ACTOR LINE: 'I was that person. [AMOUNT] on [CATEGORY_PRODUCTS]. Zero results. Then I found [PRODUCT_NAME].'\n\n" +
+  "NOTE: Dollar-amount specificity is the credibility signal. Pick an amount the target audience actually spends."
+)
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+Photoreal female creator, [AI_ACTOR_AGE], natural look, warm skin tone. Bedroom desk. Silver mini-mic in hand, leaning slightly toward camera. Expression: slightly exasperated at first, resolving to knowing confidence. No meme overlay. Warm ambient light. Optional: stacked text overlaid beside face ('$[AMOUNT] on [PRODUCT] ❌'). Direct, candid delivery. 9:16. 3 seconds.
+```

package/assets/worker-kits/creative-strategist-v1/templates/scene-modules/hooks/meme-overlay.md

@@ -0,0 +1,104 @@
+# Scene Module: Meme Overlay Hook
+> ID: `meme-overlay`
+> Type: hook (Scene 1)
+> Compatible Formats: `bedroom-minimic-talk`
+> Status: ✅ PROVEN — Solawave BOGO (Hook A)
+
+---
+
+## WHAT IT DOES
+
+Opens with a viral meme character overlaid on the creator's frame (lower 60% of screen). Creator's eyes are visible above the meme. The meme character expresses the target audience's pain state (tired, stressed, broke, defeated). The meme clears at ~2 seconds and the creator speaks — now the viewer is already emotionally calibrated.
+
+**Why it works:** The meme is a pre-loaded emotional shorthand. The viewer sees "D.W. Arthur tired face" and instantly downloads 8 words of emotional context in 0.5 seconds. It also signals "this person has the same taste as me" — a micro-trust signal before any product is mentioned.
+
+---
+
+## VISUAL DIRECTION
+
+```
+Frame: Creator at bedroom desk, mini-mic at chin level.
+Meme:  [MEME_CHARACTER] overlaid — fills lower 60% of frame.
+       Creator's eyes and forehead visible above.
+       Meme should match the pain state (tired = dark circles, broke = crying money, etc.)
+Duration: 1.5–2 seconds of meme before it clears or fades.
+Lighting: Warm ambient — bedroom or desk lamp.
+```
+
+**Meme selection guide:**
+- Under-eye / tired skin → D.W. from Arthur (dark circles), "4am" memes
+- Wasted money on skincare → Sad Keanu, Crying Jordan, "SPENT $300" text meme
+- Feeling old → Miss Minutes, aging character memes
+- Frustrated with solutions not working → "This is fine" dog, "I've tried everything" formats
+- Skepticism → "well yes but actually no" meme, Pacha "ugh finally" reverse
+
+---
+
+## ON-SCREEN TEXT
+
+```
+Line 1: "[RELATABLE_PAIN_STATEMENT]"
+         e.g. "me looking at my forehead every morning"
+         e.g. "oh hey 4am its me"
+         e.g. "me after spending $300 on skincare"
+
+Style:   White text, black outline. Bold key words. Bottom third.
+Timing:  Text appears with meme, stays through creator's first spoken word.
+```
+
+---
+
+## ACTOR DIALOGUE (spoken after meme clears)
+
+```
+Pattern: [acknowledgment of meme state] + [pivot to discovery]
+
+Templates:
+  "ok but actually... I found something."
+  "real. and then I found [PRODUCT_NAME]."
+  "been that person. here's what actually worked."
+  "[laugh/exhale] — ok so this changed it."
+
+Delivery: Casual, slightly conspiratorial. NOT an announcer voice. 
+          Like texting a friend the thing that fixed it.
+```
+
+---
+
+## BRAND-KIT PLACEHOLDERS
+
+| Placeholder | Source | Example |
+|-------------|--------|---------|
+| `[MEME_CHARACTER]` | User direction or brief | "D.W. from Arthur (tired face)" |
+| `[RELATABLE_PAIN_STATEMENT]` | `brand-kit.md → target_pain_point` | "me looking at my forehead every morning" |
+| `[PRODUCT_NAME]` | `brand-kit.md → primary_service` | "Solawave wand" |
+
+---
+
+## MUSE REFERENCE
+
+Muse: @frankyshaw — frame_1s.jpg, frame_2s.jpg
+Text: "oh hey 4am its me" + "getting five"
+Meme: D.W. from Arthur (cartoon character with dark circles, tired expression)
+Format: Meme overlay on creator's face. Eyes visible above. Mini-mic in hand.
+
+---
+
+## JS STUB (hookCard)
+
+```js
+hookCard("A", "Tired Skin Meme — Direct Muse Mirror",
+  "VISUAL: [MEME_CHARACTER] overlaid on lower 60% of frame. Actor's eyes visible above. Mini-mic in hand.\n\n" +
+  "ON-SCREEN TEXT: '[RELATABLE_PAIN_STATEMENT]'\n\n" +
+  "ACTOR LINE (after meme clears): '[PIVOT_LINE_TO_PRODUCT]'\n\n" +
+  "NOTE: Direct mirror of muse format. Test first — highest muse fidelity."
+)
+```
+
+---
+
+## AI GENERATION PROMPT STUB
+
+```
+Photoreal female creator, [AI_ACTOR_AGE], natural look, warm skin tone. Bedroom desk. Casual [OUTFIT]. Silver condenser mini-mic held at chin. [MEME_CHARACTER] overlay fills lower 60% of frame — creator's eyes and forehead visible above. She glances slightly downward at the meme, looks up with a knowing half-smile. Warm ambient light from left (bedside lamp). Handheld feel. Authentic TikTok creator bedroom aesthetic. 9:16. 3 seconds.
+```