⚠️ MANDATORY ARTIFACT

Append to .genius/memory/decisions.json:

{"id": "d-XXX", "decision": "COPY: [section] — [approach]", "reason": "[why this tone/style]", "timestamp": "ISO-date", "tags": ["copy", "decision"]}

On Complete

Append to .genius/memory/decisions.json:

{"id": "d-XXX", "decision": "COPY COMPLETE: [sections] with A/B variants", "reason": "all sections covered", "timestamp": "ISO-date", "tags": ["copy", "complete"]}

Prerequisites

REQUIRED: MARKETING-STRATEGY.xml, messaging framework, target personas

Copy Categories

Landing Page (Hero → Features → Social Proof → CTA)

• Headline: Benefit-first, specific, compelling
• Subheadline: Supporting detail
• CTA: Action + Value ("Start Free Trial", not "Submit")

Emails (Welcome, Activation, Retention)

• Subject lines with A/B variants
• Personal, conversational tone
• Clear single CTA per email

UI Copy (Buttons, Labels, Errors, Empty States)

• Consistent voice throughout
• Helpful error messages
• Encouraging empty states

Output: COPY.md

Component-mapped copy with A/B variants for key sections.

Playground Integration

Template

playgrounds/templates/copy-ab-tester.html

Flow

1. Generate Variants: Create 2-3 copy variants for the requested section
2. Build Output: Create .genius/outputs/COPY-OPTIONS.html with variants injected
3. User Review: User interactively compares and refines:
   • 3 variants side by side
   • Tone sliders (formal/casual, serious/playful, technical/simple)
   • Format preview (landing page, email, social, ad)
4. Capture Selection: Final prompt contains chosen variant with validated tone

Variant Format

{
  headline: "Main headline text",
  subheadline: "Supporting subheadline",
  cta: "Call to action button text",
  body: "Body copy paragraph"
}

Injection Example

When creating COPY-OPTIONS.html, inject variants into the template's state:

// Replace the default state.variants with generated copy
state.variants = {
  a: {
    headline: "Ship 10x Faster with AI",
    subheadline: "The platform developers actually love",
    body: "Stop writing boilerplate. Let AI handle the repetitive work while you focus on what matters.",
    cta: "Start Free Trial"
  },
  b: {
    headline: "Code Less. Build More.",
    subheadline: "AI-powered development for modern teams",
    body: "Join 50,000+ developers who ship faster with intelligent code assistance.",
    cta: "Try It Free"
  },
  c: {
    headline: "Your AI Pair Programmer",
    subheadline: "From idea to production in minutes",
    body: "The smartest way to write code. Autocomplete on steroids, powered by the latest AI.",
    cta: "Get Started"
  }
};

User Interaction

The playground allows users to:

• Compare: See all 3 variants rendered side by side
• Adjust Tone: Sliders for formal↔casual, serious↔playful, technical↔simple
• Preview Formats: Switch between landing page, email, social, and ad layouts
• Select Winner: Click to select the preferred variant
• Copy Output: Generated prompt includes selected variant + tone settings

Output Location

.genius/outputs/COPY-OPTIONS.html — User opens in browser for interactive comparison

🗂️ Post-Output: Refresh Dashboard (MANDATORY)

After generating any .genius/*.html playground file:

1. Follow .claude/commands/genius-dashboard.md instructions to regenerate .genius/DASHBOARD.html
2. Open it immediately:

   open .genius/DASHBOARD.html 2>/dev/null || echo "📂 Open: $(pwd)/.genius/DASHBOARD.html"
   

   (On macOS/Linux this opens in the default browser. If it fails, the full path is printed as a clickable link.)

Handoffs

From: genius-marketer

Receives: MARKETING-STRATEGY.xml, messaging framework, personas

To: genius-dev

Provides: COPY.md with component-mapped copy, all UI text strings

To: genius-integration-guide (parallel)

Coordinates: CTA tracking, email service setup

Next Step (Auto-Chain)

When this skill completes its work: → Automatically suggest: "Copy complete! Ready to set up service integrations? I'll hand off to genius-integration-guide." → If user approves: route to genius-integration-guide → Update state.json: currentSkill = "genius-integration-guide"

Definition of Done

Copy MUST be:

1. Immediately usable: Copy-paste ready, no placeholders like [YOUR PRODUCT NAME]
2. Complete: All sections filled (hero, features, CTA, footer)
3. Consistent voice: Same tone throughout
4. Specific benefits: "Save 2 hours/day" not "saves time"
5. Clear CTAs: Specific action + specific outcome (e.g., "Start free trial — no credit card")

If you don't have specific product details → ask before guessing. Generic copy is worse than no copy.