@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/copywriting/SKILL.md

@@ -0,0 +1,349 @@
+---
+name: copywriting
+description: Write marketing copy for websites, landing pages, and product pages.
+depends-on:
+  - hook-generator
+metadata:
+  version: 1.2.0
+---
+
+# Copywriting
+
+You are an expert conversion copywriter. Your goal is to write marketing copy that is clear, compelling, and drives action.
+
+## Before Writing
+
+**Check for brand-specific assets in businesses/{business}/brand/ first:**
+If `businesses/{business}/brand/` exists (or `businesses/{business}/brand/` in older setups), read it before asking questions. Use that context and only ask for information not already covered or specific to this task.
+
+Gather this context (ask if not provided):
+
+### 1. Page Purpose
+- What type of page? (homepage, landing page, pricing, feature, about)
+- What is the ONE primary action you want visitors to take?
+
+### 2. Audience
+- Who is the ideal customer?
+- What problem are they trying to solve?
+- What objections or hesitations do they have?
+- What language do they use to describe their problem?
+
+### 3. Product/Offer
+- What are you selling or offering?
+- What makes it different from alternatives?
+- What's the key transformation or outcome?
+- Any proof points (numbers, testimonials, case studies)?
+
+### 4. Context
+- Where is traffic coming from? (ads, organic, email)
+- What do visitors already know before arriving?
+
+---
+
+## Awareness Gate (MANDATORY)
+
+Before any copy work, determine the target audience's awareness level:
+
+1. **Can you determine awareness level from the prompt/context?**
+   - For SEO: keyword intent maps to awareness level
+     - Informational ("how to fix X") → Problem-aware
+     - Comparative ("X vs Y") → Solution-aware
+     - Branded ("your product") → Product-aware
+     - Transactional ("buy X") → Most-aware
+   - For social: content topic + audience → awareness level
+   - For email: subscriber stage → awareness level
+
+2. **If YES** → Proceed with awareness-matched strategy
+   - Load `references/awareness-level-guide.md`
+   - Select copy framework based on awareness level
+
+3. **If NO** → ASK THE USER before proceeding:
+   "What awareness level is your target audience at?"
+   - Unaware — doesn't know they have a problem
+   - Problem-aware — knows the problem, doesn't know solutions exist
+   - Solution-aware — knows solutions exist, doesn't know your product
+   - Product-aware — knows your product, not convinced it's right
+   - Most-aware — ready to buy, just needs the offer
+
+---
+
+## Copywriting Principles
+
+### Clarity Over Cleverness
+If you have to choose between clear and creative, choose clear.
+
+### Benefits Over Features
+Features: What it does. Benefits: What that means for the customer.
+
+### Specificity Over Vagueness
+- Vague: "Save time on your workflow"
+- Specific: "Cut your weekly reporting from 4 hours to 15 minutes"
+
+### Customer Language Over Company Language
+Use words your customers use. Mirror voice-of-customer from reviews, interviews, support tickets.
+
+### One Idea Per Section
+Each section should advance one argument. Build a logical flow down the page.
+
+---
+
+## Writing Style Rules
+
+### Core Principles
+
+1. **Simple over complex** — "Use" not "utilize," "help" not "facilitate"
+2. **Specific over vague** — Avoid "streamline," "optimize," "innovative"
+3. **Active over passive** — "We generate reports" not "Reports are generated"
+4. **Confident over qualified** — Remove "almost," "very," "really"
+5. **Show over tell** — Describe the outcome instead of using adverbs
+6. **Honest over sensational** — Fabricated statistics or testimonials erode trust and create legal liability
+
+### Quick Quality Check
+
+- Jargon that could confuse outsiders?
+- Sentences trying to do too much?
+- Passive voice constructions?
+- Exclamation points? (remove them)
+- Marketing buzzwords without substance?
+
+For thorough line-by-line review, use the **copy-editing** skill after your draft.
+
+---
+
+## Best Practices
+
+### Be Direct
+Get to the point. Don't bury the value in qualifications.
+
+❌ Slack lets you share files instantly, from documents to images, directly in your conversations
+
+✅ Need to share a screenshot? Send as many documents, images, and audio files as your heart desires.
+
+### Use Rhetorical Questions
+Questions engage readers and make them think about their own situation.
+- "Hate returning stuff to Amazon?"
+- "Tired of chasing approvals?"
+
+### Use Analogies When Helpful
+Analogies make abstract concepts concrete and memorable.
+
+### Pepper in Humor (When Appropriate)
+Puns and wit make copy memorable—but only if it fits the brand and doesn't undermine clarity.
+
+---
+
+## Page Structure Framework
+
+### Above the Fold
+
+**Headline**
+- Your single most important message
+- Communicate core value proposition
+- Specific > generic
+
+**Hook-generator integration:** Spawn a hook-generator subagent for headline candidates:
+```
+Load the hook-generator skill and execute the full Phase 1-6 pipeline with this context.
+Context:
+- WHO: <audience from brief>
+- WHAT/WHY: <core value proposition>
+- Knife: <primary pain point>
+- Platform: <web / email / social — map from page type>
+- Brand: <brand name>
+- Target Score: 85
+Return ONLY this JSON array: [{"hook":"...","score":<0-100>,"pattern":"...","formula":"..."}]
+```
+Use scored hooks as headline candidates. If subagent fails, fall back to the example formulas below.
+
+**Example formulas (fallback):**
+- "{Achieve outcome} without {pain point}"
+- "The {category} for {audience}"
+- "Never {unpleasant event} again"
+- "{Question highlighting main pain point}"
+
+**For comprehensive headline formulas**: See [references/copy-frameworks.md](references/copy-frameworks.md)
+
+**For natural transition phrases**: See [references/natural-transitions.md](references/natural-transitions.md)
+
+**Subheadline**
+- Expands on headline
+- Adds specificity
+- 1-2 sentences max
+
+**Primary CTA**
+- Action-oriented button text
+- Communicate what they get: "Start Free Trial" > "Sign Up"
+
+### Core Sections
+
+| Section | Purpose |
+|---------|---------|
+| Social Proof | Build credibility (logos, stats, testimonials) |
+| Problem/Pain | Show you understand their situation |
+| Solution/Benefits | Connect to outcomes (3-5 key benefits) |
+| How It Works | Reduce perceived complexity (3-4 steps) |
+| Objection Handling | FAQ, comparisons, guarantees |
+| Final CTA | Recap value, repeat CTA, risk reversal |
+
+**For detailed section types and page templates**: See [references/copy-frameworks.md](references/copy-frameworks.md)
+
+---
+
+## CTA Copy Guidelines
+
+**Weak CTAs (avoid):**
+- Submit, Sign Up, Learn More, Click Here, Get Started
+
+**Strong CTAs (use):**
+- Start Free Trial
+- Get [Specific Thing]
+- See [Product] in Action
+- Create Your First [Thing]
+- Download the Guide
+
+**Formula:** [Action Verb] + [What They Get] + [Qualifier if needed]
+
+Examples:
+- "Start My Free Trial"
+- "Get the Complete Checklist"
+- "See Pricing for My Team"
+
+---
+
+## Page-Specific Guidance
+
+### Homepage
+- Serve multiple audiences without being generic
+- Lead with broadest value proposition
+- Provide clear paths for different visitor intents
+
+### Landing Page
+- Single message, single CTA
+- Match headline to ad/traffic source
+- Complete argument on one page
+
+### Pricing Page
+- Help visitors choose the right plan
+- Address "which is right for me?" anxiety
+- Make recommended plan obvious
+
+### Feature Page
+- Connect feature → benefit → outcome
+- Show use cases and examples
+- Clear path to try or buy
+
+### About Page
+- Tell the story of why you exist
+- Connect mission to customer benefit
+- Still include a CTA
+
+---
+
+## Voice and Tone
+
+Before writing, establish:
+
+**Formality level:**
+- Casual/conversational
+- Professional but friendly
+- Formal/enterprise
+
+**Brand personality:**
+- Playful or serious?
+- Bold or understated?
+- Technical or accessible?
+
+Maintain consistency, but adjust intensity:
+- Headlines can be bolder
+- Body copy should be clearer
+- CTAs should be action-oriented
+
+---
+
+## Output Format
+
+When writing copy, provide:
+
+### Page Copy
+Organized by section:
+- Headline, Subheadline, CTA
+- Section headers and body copy
+- Secondary CTAs
+
+### Annotations
+For key elements, explain:
+- Why you made this choice
+- What principle it applies
+
+### Alternatives
+For headlines and CTAs, provide 2-3 options:
+- Option A: [copy] — [rationale]
+- Option B: [copy] — [rationale]
+
+### Meta Content (if relevant)
+- Page title (for SEO)
+- Meta description
+
+---
+
+## Related Skills
+
+- **copy-editing**: For polishing existing copy (use after your draft)
+- **page-cro**: If page structure/strategy needs work, not just copy
+- **email-sequence**: For email copywriting
+- **popup-cro**: For popup and modal copy
+- **ab-test-setup**: To test copy variations
+- **quality-gate**: For scoring drafts (standard + tournament mode with 5 parallel judges)
+
+---
+
+## STEP N: Copywriting Tournament (RECOMMENDED for headlines & CTAs)
+
+For high-impact elements (headlines, hero sections, CTAs), run a tournament to find the best variant:
+
+1. Generate 3-5 variants of the key copy element (different angles, formulas, or approaches)
+2. Save each variant to a tournament directory:
+   - `content/tournaments/{slug}/variant-1.md`
+   - `content/tournaments/{slug}/variant-2.md`
+   - ... up to variant-{N}.md
+3. Spawn 5 PARALLEL `build` subagents using the Task tool (one per judge persona):
+   - Each gets the judge subagent prompt from `Skill: quality-gate` tournament section
+   - persona_file paths:
+     - `~/.claude/skills/quality-gate/judge-personas/skeptic.md`
+     - `~/.claude/skills/quality-gate/judge-personas/scanner.md`
+     - `~/.claude/skills/quality-gate/judge-personas/buyer.md`
+     - `~/.claude/skills/quality-gate/judge-personas/expert.md`
+     - `~/.claude/skills/quality-gate/judge-personas/outsider.md`
+   - Each gets: tournament_dir, variant_count, mode=`copy`, original_prompt
+4. Collect all 5 JSON results
+5. Aggregate: sum weighted_avg across judges per variant → rank → pick winner
+6. Apply recommended_edits from aggregation to the winner
+7. Save the edited winner as the draft file
+8. Proceed to standard quality-gate below with the winner
+
+**When to tournament:** Headlines, hero copy, CTAs, value propositions. Skip for body copy where clarity matters more than persuasion.
+
+---
+
+## FINAL STEP: Quality Gate (MANDATORY — DO NOT SKIP)
+
+Before presenting ANY draft to Jairo, run the quality gate:
+
+1. Save your complete draft to a file (e.g., `content/drafts/{slug}.md` or a temp file)
+2. Spawn a `build` subagent using the Task tool with the quality-gate prompt from `Skill: quality-gate`
+3. Pass these inputs to the subagent:
+   - **draft_path**: absolute path to the saved draft
+   - **mode**: `copy`
+   - **original_prompt**: the writing prompt that started this task
+   - **attempt**: current attempt number (start at 1)
+4. Parse the JSON result from the subagent
+5. If FAIL and attempt < 3:
+   - Rewrite the draft addressing the specific `rewrite_instructions` from the quality gate
+   - Save the new draft (overwrite or new file)
+   - Spawn another subagent with attempt + 1
+6. If FAIL and attempt = 3:
+   - Present to Jairo with all score reports attached
+   - Say: "Couldn't pass quality gate after 3 attempts. Here's what's wrong and what I tried to fix."
+7. If PASS:
+   - Present to Jairo as normal (do NOT show scores — they're internal)
+8. NEVER present a draft that hasn't passed quality gate (except after 3 failed attempts)

package/skills/copywriting/evals/evals.json

@@ -0,0 +1,111 @@
+{
+  "skill_name": "copywriting",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "Write homepage copy for a SaaS tool that automates employee onboarding. Target audience is HR directors at mid-size companies (200-2000 employees). Main differentiator is that it integrates with all major HRIS systems and cuts onboarding time from 2 weeks to 2 days.",
+      "expected_output": "Should check for product-marketing-context.md first. Should write full page copy organized by section: Headline, Subheadline, CTA (above the fold), then Social Proof, Problem/Pain, Solution/Benefits, How It Works, Objection Handling, and Final CTA. Should follow copywriting principles: clarity over cleverness, benefits over features, specificity (use the '2 weeks to 2 days' stat), customer language. Headline should communicate core value proposition. CTAs should be action-oriented ('Start Free Trial' not 'Submit'). Should provide 2-3 headline alternatives with rationale. Should include annotations explaining key copy choices. Should include meta content (SEO page title and meta description).",
+      "assertions": [
+        "Checks for product-marketing-context.md",
+        "Writes full page copy organized by section",
+        "Includes Headline, Subheadline, and CTA above the fold",
+        "Includes Social Proof, Problem/Pain, Solution/Benefits, How It Works sections",
+        "Uses the '2 weeks to 2 days' specificity in copy",
+        "CTAs are action-oriented, not generic",
+        "Provides 2-3 headline alternatives with rationale",
+        "Includes annotations explaining copy choices",
+        "Includes meta content (SEO title and meta description)"
+      ],
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "Rewrite this headline: 'An Innovative AI-Powered Platform for Streamlined Business Operations' — it's for a B2B SaaS tool that helps small businesses manage invoicing and payments.",
+      "expected_output": "Should identify problems: jargon ('innovative,' 'AI-powered,' 'streamlined,' 'business operations'), too vague, company language not customer language. Should apply copywriting principles — specificity over vagueness, benefits over features, customer language over company language. Should provide 2-3 alternative headlines using formulas like '{Achieve outcome} without {pain point}' or 'The {category} for {audience}'. Each alternative should include rationale. Should also suggest a subheadline that adds specificity.",
+      "assertions": [
+        "Identifies jargon in original headline",
+        "Identifies vagueness as a problem",
+        "Identifies company language vs customer language issue",
+        "Provides 2-3 alternative headlines",
+        "Alternatives use headline formulas from the skill",
+        "Each alternative includes rationale",
+        "Suggests a subheadline"
+      ],
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "i need copy for my pricing page. we have three plans: starter ($29/mo), pro ($79/mo), business ($199/mo). it's a social media scheduling tool for marketers",
+      "expected_output": "Should trigger on the casual phrasing. Should ask or infer audience context. Should apply Pricing Page guidance: help visitors choose the right plan, address 'which is right for me?' anxiety, make recommended plan obvious. Should write plan names, descriptions, feature lists with benefit-oriented copy (not just feature names). Should include a page headline that addresses the pricing decision. CTAs should be specific per plan. Should handle objection handling (FAQ copy). Should provide alternatives for key elements.",
+      "assertions": [
+        "Triggers on casual phrasing",
+        "Applies Pricing Page guidance",
+        "Addresses 'which plan is right for me' anxiety",
+        "Makes recommended plan obvious",
+        "Writes benefit-oriented feature copy, not just feature names",
+        "Includes page headline",
+        "CTAs are specific per plan",
+        "Includes FAQ or objection handling copy",
+        "Provides alternatives for key elements"
+      ],
+      "files": []
+    },
+    {
+      "id": 4,
+      "prompt": "Write copy for our About page. We're a 3-person startup that built a developer tool for database migrations. Founded because we kept losing data during migrations at our last jobs. Tone should be professional but human.",
+      "expected_output": "Should apply About Page guidance: tell the story of why you exist, connect mission to customer benefit, still include a CTA. Should adapt voice and tone to 'professional but human' as specified. Should tell the founder origin story authentically. Should connect the personal pain to the customer's pain. Should include a CTA even on the About page. Copy should follow style rules: active voice, confident, specific. Should NOT be overly corporate or generic.",
+      "assertions": [
+        "Applies About Page guidance",
+        "Tells the story of why the company exists",
+        "Connects mission to customer benefit",
+        "Includes a CTA",
+        "Adapts tone to professional but human",
+        "Uses the founder origin story",
+        "Connects personal pain to customer pain",
+        "Uses active voice",
+        "Avoids corporate jargon"
+      ],
+      "files": []
+    },
+    {
+      "id": 5,
+      "prompt": "Can you improve this CTA? We currently have 'Learn More' on our feature page for our analytics dashboard product.",
+      "expected_output": "Should immediately identify 'Learn More' as a weak CTA per the guidelines. Should apply the CTA formula: [Action Verb] + [What They Get] + [Qualifier]. Should provide 2-3 strong alternatives like 'See the Dashboard in Action,' 'Start Your Free Trial,' or 'Explore Analytics Features.' Each alternative should include rationale and context for when it works best. Should also consider CTA hierarchy — whether this is a primary or secondary CTA, and suggest complementary CTAs if relevant.",
+      "assertions": [
+        "Identifies 'Learn More' as a weak CTA",
+        "Applies the CTA formula from the skill",
+        "Provides 2-3 strong alternatives",
+        "Each alternative includes rationale",
+        "Considers CTA hierarchy (primary vs secondary)",
+        "Suggests complementary CTAs"
+      ],
+      "files": []
+    },
+    {
+      "id": 6,
+      "prompt": "Write me a 5-email welcome sequence for new trial users of our project management tool.",
+      "expected_output": "Should recognize this is an email copywriting task, not page copywriting. Should defer to or cross-reference the email-sequence skill, which specifically handles email sequences, drip campaigns, and lifecycle emails. May provide brief general guidance but should make clear that email-sequence is the right skill for this task.",
+      "assertions": [
+        "Recognizes this as email sequence work",
+        "References or defers to email-sequence skill",
+        "Does not attempt to write a full email sequence using page copywriting patterns"
+      ],
+      "files": []
+    },
+    {
+      "id": 7,
+      "prompt": "Review this copy and tell me what's wrong: 'We are extremely excited to announce our revolutionary, cutting-edge platform that will totally transform how businesses optimize their workflows! Sign up now!!'",
+      "expected_output": "Should apply the Quick Quality Check. Should identify: exclamation points (remove them), marketing buzzwords without substance ('revolutionary,' 'cutting-edge,' 'totally transform,' 'optimize'), passive/weak constructions ('we are excited to announce'), vague language ('workflows'). Should apply writing style rules: simple over complex, specific over vague, confident over qualified, show over tell. Should rewrite the copy following these principles. Should provide 2-3 alternatives.",
+      "assertions": [
+        "Identifies exclamation point overuse",
+        "Identifies marketing buzzwords without substance",
+        "Identifies vague language",
+        "Applies writing style rules",
+        "Rewrites the copy following principles",
+        "Provides alternatives",
+        "Result is specific, clear, and jargon-free"
+      ],
+      "files": []
+    }
+  ]
+}

package/skills/copywriting/references/awareness-level-guide.md

@@ -0,0 +1,227 @@
+# Awareness Level Guide
+
+**Single source of truth for awareness-level-matched copywriting.**
+Every piece of marketing copy must identify the reader's awareness level before writing begins.
+
+---
+
+## The 5-Stage Awareness Ladder
+
+| Stage | Definition | What They Know | What They Need |
+|-------|-----------|----------------|----------------|
+| **1. Unaware** | Doesn't know they have a problem | Nothing about the problem | Problem awareness first |
+| **2. Problem-aware** | Knows the problem, doesn't know solutions exist | They have a pain point | Validation + solution discovery |
+| **3. Solution-aware** | Knows solutions exist, doesn't know your product | Solutions exist in the category | Differentiation + trust |
+| **4. Product-aware** | Knows your product, not convinced it's right | Your product exists | Proof + objection handling |
+| **5. Most-aware** | Ready to buy, just needs the offer | Everything about your product | Price, guarantee, urgency |
+
+---
+
+## Workflow: ICP → Awareness → Copy Framework
+
+**MANDATORY ORDER:**
+```
+1. ICP DEFINITION (who are we talking to?)
+   ↓
+2. AWARENESS LEVEL (what do they already know?)
+   ↓
+3. COPY FRAMEWORK SELECTION (how do we approach them?)
+   ↓
+4. COPY WRITING (execute)
+```
+
+**You cannot assess awareness level without knowing the audience.** A developer and a non-technical buyer have different awareness levels for the same product. The ICP informs the awareness assessment.
+
+---
+
+## Awareness Level Detection
+
+### For SEO Content: Keyword Intent → Awareness Level
+
+| Keyword Pattern | Intent | Awareness Level |
+|-----------------|--------|-----------------|
+| "how to fix X", "why does X happen", "what is X" | Informational | **Problem-aware** |
+| "best X for Y", "X vs Y", "top X" | Comparative | **Solution-aware** |
+| "your product name", "brand name", "review" | Navigational | **Product-aware** |
+| "buy X", "discount code", "pricing", "order" | Transactional | **Most-aware** |
+
+### For Paid Traffic: Ad Copy + Landing Page Match
+
+| Ad Promise | Landing Page Type | Awareness Level |
+|------------|-------------------|-----------------|
+| "Solve your [problem]" | Advertorial funnel | **Problem-aware** |
+| "Why [competitor] doesn't work" | Comparison page | **Solution-aware** |
+| "Try [product] free" | Product page | **Product-aware** |
+| "50% off today only" | Direct offer page | **Most-aware** |
+
+### For Social Content: Topic + Audience
+
+| Content Topic | Audience Context | Awareness Level |
+|---------------|------------------|-----------------|
+| Pain point stories | General audience | **Problem-aware** |
+| Category education | Interest-based audience | **Problem/Solution-aware** |
+| Product comparisons | Engaged followers | **Solution-aware** |
+| Product features | Existing audience | **Product-aware** |
+| Limited-time offers | Email subscribers | **Most-aware** |
+
+### For Email: Subscriber Stage
+
+| Email Type | Subscriber Stage | Awareness Level |
+|------------|------------------|-----------------|
+| Welcome sequence | New subscriber | **Problem-aware** |
+| Nurture sequence | Engaged, no purchase | **Solution-aware** |
+| Sales sequence | Product page visitors | **Product-aware** |
+| Win-back sequence | Lapsed customers | **Most-aware** |
+
+---
+
+## The 4-Step Advertorial Funnel
+
+**For Problem-Aware and Solution-Aware audiences.**
+This is the Google Ads meta that works for ALL traffic sources — paid, organic, social.
+
+### Step 1: Validate the Struggle
+
+**Job:** Make them feel understood. Build rapport through precise pain acknowledgment.
+
+**Copy patterns:**
+- "You're not alone..."
+- "If you've ever [struggle]..."
+- "The reason you [symptom] is..."
+- "Most people think [misconception]..."
+- "You've tried [common solution] and it didn't work because..."
+
+**Example:**
+> "You wake up at 3am again. Staring at the ceiling. You've tried chamomile tea, magnesium, even those sleep podcasts. Nothing sticks. You're not broken — you're just solving the wrong problem."
+
+### Step 2: Explain the Hidden Cause
+
+**Job:** Create cognitive investment. Leaving means leaving with incomplete understanding.
+
+**Copy patterns:**
+- "What most people don't realize..."
+- "The real cause isn't what you think..."
+- "Here's why [common solution] doesn't work..."
+- "The problem isn't [surface issue] — it's [root cause]..."
+- "Scientists recently discovered..."
+
+**Example:**
+> "Here's what nobody tells you: your 3am wake-up isn't a sleep problem. It's a blood sugar problem. When your glucose drops at 2-3am, your body releases cortisol to compensate. That cortisol is what jolts you awake. The chamomile tea? It never had a chance against your biochemistry."
+
+### Step 3: Introduce the Mechanism (Not the Product)
+
+**Job:** Explain HOW the problem gets fixed at a biological or structural level. Trust transfers from author to logic.
+
+**Copy patterns:**
+- "Here's how it actually works at the [biological/structural] level..."
+- "The solution isn't [surface fix], it's [root cause fix]..."
+- "When you [mechanism action], here's what happens..."
+- "The science behind this is simple..."
+
+**Example:**
+> "The fix isn't about 'relaxing more.' It's about stabilizing your blood sugar overnight. When you give your body a slow-release glucose source before bed, cortisol never spikes. Your brain stays in deep sleep instead of being yanked into light sleep. No jolt. No ceiling staring."
+
+### Step 4: Present the Product as Best Implementation
+
+**Job:** Show your product as the best implementation of a mechanism they already believe in.
+
+**Copy patterns:**
+- "The best way to [mechanism] is..."
+- "That's why we built [product]..."
+- "[Product] is the only [category] that [mechanism]..."
+- "Here's how [product] makes this easy..."
+
+**Example:**
+> "That's why we built SleepStable. It's the only magnesium supplement with slow-release glucose beads. One capsule before bed stabilizes your blood sugar for 8 hours. No more 3am wake-ups. No more ceiling staring. Just deep, uninterrupted sleep."
+
+---
+
+## Copy Framework Selection Matrix
+
+| Awareness Level | Recommended Frameworks | Anti-Patterns |
+|-----------------|----------------------|---------------|
+| **Unaware** | Story-driven, Slippery Slide, Pattern Interrupt | Don't mention product, don't assume problem knowledge |
+| **Problem-aware** | PAS, Advertorial Funnel (Steps 1-2), Emotional storytelling | Don't skip to solution, don't pitch product |
+| **Solution-aware** | Advertorial Funnel (Steps 2-4), Comparison, Before/After | Don't ignore competitors, don't assume brand trust |
+| **Product-aware** | Standard landing page, Social proof, Objection handling | Don't re-explain the problem, don't skip proof |
+| **Most-aware** | Direct offer, Urgency, Price anchor | Don't over-explain, don't waste words |
+
+---
+
+## Architecture Selection by Awareness Level
+
+### For Landing Pages
+
+| Awareness Level | Architecture | Sections |
+|-----------------|--------------|----------|
+| **Unaware** | Story-first | Story → Problem → Solution → Product → CTA |
+| **Problem-aware** | Advertorial funnel | Validate → Cause → Mechanism → Product → CTA |
+| **Solution-aware** | Advertorial funnel | Cause → Mechanism → Product → Proof → CTA |
+| **Product-aware** | Standard 8-section | Hero → Problem → Value Stack → Proof → Transformation → CTA |
+| **Most-aware** | Direct offer | Hero (offer) → Price → Guarantee → CTA |
+
+### For Blog/SEO Content
+
+| Awareness Level | Content Approach |
+|-----------------|------------------|
+| **Unaware** | Educational, problem-focused, no product mention |
+| **Problem-aware** | Problem + solution category, minimal product mention |
+| **Solution-aware** | Comparison, "how it works", product as example |
+| **Product-aware** | Product review, case study, demo |
+| **Most-aware** | Pricing, discount, how to buy |
+
+### For Social Content
+
+| Awareness Level | Content Approach |
+|-----------------|------------------|
+| **Unaware** | Pattern interrupt, story, curiosity |
+| **Problem-aware** | Pain point, relatable moment, "you're not alone" |
+| **Solution-aware** | Category education, "did you know" |
+| **Product-aware** | Feature highlight, proof, testimonial |
+| **Most-aware** | Offer, urgency, CTA |
+
+### For Email
+
+| Awareness Level | Email Approach |
+|-----------------|----------------|
+| **Unaware** | Welcome, story, problem education |
+| **Problem-aware** | Nurture, validation, solution discovery |
+| **Solution-aware** | Comparison, differentiation, proof |
+| **Product-aware** | Demo, case study, objection handling |
+| **Most-aware** | Offer, discount, urgency |
+
+---
+
+## Anti-Patterns (What NOT to Do)
+
+### DO NOT:
+- Send problem-aware traffic to a PDP (product detail page)
+- Pitch the product before validating the problem
+- Skip the mechanism explanation and jump to "buy now"
+- Assume the reader knows your brand
+- Assume the reader knows solutions exist
+- Use the same copy approach for all awareness levels
+- Write product-first copy for informational keywords
+
+### DO:
+- Match the copy architecture to the reader's psychological position
+- Build rapport before building trust
+- Explain the mechanism before presenting the product
+- Use the ICP to inform the awareness assessment
+- Ask the user if awareness level is unclear from context
+- Select the correct framework based on awareness level
+- Progress through awareness levels in nurture sequences
+
+---
+
+## Quick Reference Card
+
+```
+UNAWARE      → Story first, problem second, solution third
+PROBLEM-AWARE → Validate pain, explain cause, show mechanism
+SOLUTION-AWARE → Explain mechanism, differentiate, build trust
+PRODUCT-AWARE → Proof, comparison, objection handling
+MOST-AWARE   → Offer, price, guarantee, CTA
+```
+
+**The #1 conversion killer:** Sending problem/solution-aware traffic to a product page. This skips 3 psychological steps and kills conversion. Always match the page architecture to the reader's awareness level.