@poolzin/plcode 2.1.1 → 3.0.1

package/.plcode/context/content/copywriting-frameworks.md

@@ -0,0 +1,317 @@
+# Copywriting Frameworks
+
+**Category**: content  
+**Purpose**: Proven copywriting frameworks and persuasive writing techniques  
+**Used by**: copywriter
+
+---
+
+## Overview
+
+Effective copywriting follows proven frameworks that guide readers through awareness, interest, desire, and action. This guide covers the most effective frameworks for different contexts.
+
+## Core Frameworks
+
+### 1. AIDA (Attention, Interest, Desire, Action)
+
+**Classic framework for persuasive copy**:
+
+**Attention**: Grab attention with a compelling headline
+
+```
+"Stop Wasting Hours on Manual Data Entry"
+```
+
+**Interest**: Build interest with relevant benefits
+
+```
+"Our automation tool processes 1000 entries in minutes,
+not hours. No coding required."
+```
+
+**Desire**: Create desire by showing transformation
+
+```
+"Join 10,000+ businesses that saved 20 hours per week
+and reduced errors by 95%."
+```
+
+**Action**: Clear call-to-action
+
+```
+"Start Your Free 14-Day Trial - No Credit Card Required"
+```
+
+### 2. PAS (Problem, Agitate, Solve)
+
+**Effective for pain-point driven copy**:
+
+**Problem**: Identify the reader's problem
+
+```
+"Struggling to keep your team aligned on project deadlines?"
+```
+
+**Agitate**: Amplify the pain
+
+```
+"Missed deadlines lead to frustrated clients, lost revenue,
+and team burnout. Every day without a solution costs you money."
+```
+
+**Solve**: Present your solution
+
+```
+"ProjectSync keeps everyone on the same page with real-time
+updates, automated reminders, and visual timelines."
+```
+
+### 3. BAB (Before, After, Bridge)
+
+**Show transformation clearly**:
+
+**Before**: Current state (pain)
+
+```
+"You're spending 3 hours daily answering the same customer
+questions via email."
+```
+
+**After**: Desired state (pleasure)
+
+```
+"Imagine having those 3 hours back to focus on growing your
+business while customers get instant answers 24/7."
+```
+
+**Bridge**: How to get there
+
+```
+"Our AI chatbot learns from your knowledge base and handles
+80% of customer inquiries automatically."
+```
+
+### 4. FAB (Features, Advantages, Benefits)
+
+**Product-focused framework**:
+
+**Features**: What it is
+
+```
+"Built-in analytics dashboard with real-time reporting"
+```
+
+**Advantages**: What it does
+
+```
+"Track campaign performance instantly without switching tools"
+```
+
+**Benefits**: What it means for them
+
+```
+"Make data-driven decisions faster and increase ROI by 30%"
+```
+
+### 5. The 4 Ps (Picture, Promise, Prove, Push)
+
+**Storytelling approach**:
+
+**Picture**: Paint a vivid picture
+
+```
+"Picture this: It's Monday morning. Instead of drowning in
+emails, you're reviewing last week's wins with your team."
+```
+
+**Promise**: Make a clear promise
+
+```
+"We'll help you reclaim 10 hours per week by automating
+your busywork."
+```
+
+**Prove**: Back it up with evidence
+
+```
+"Over 5,000 teams have saved an average of 12 hours weekly.
+Here's what they say..."
+```
+
+**Push**: Call to action
+
+```
+"Join them today - start your free trial now."
+```
+
+## Headline Formulas
+
+### 1. How-To Headlines
+
+```
+"How to [Achieve Desired Result] Without [Common Obstacle]"
+"How to Double Your Sales in 30 Days Without Paid Ads"
+```
+
+### 2. Number Headlines
+
+```
+"[Number] Ways to [Achieve Result]"
+"7 Proven Strategies to Boost Email Open Rates"
+```
+
+### 3. Question Headlines
+
+```
+"Are You Making These [Number] [Mistakes]?"
+"Are You Making These 5 SEO Mistakes?"
+```
+
+### 4. Negative Headlines
+
+```
+"Stop [Doing Wrong Thing] and Start [Doing Right Thing]"
+"Stop Guessing and Start Growing with Data-Driven Marketing"
+```
+
+### 5. Benefit-Driven Headlines
+
+```
+"[Achieve Result] in [Timeframe] with [Solution]"
+"Launch Your Online Store in 24 Hours with Shopify"
+```
+
+## Emotional Triggers
+
+### 1. Fear of Missing Out (FOMO)
+
+```
+"Limited spots available - only 10 left"
+"Offer ends tonight at midnight"
+"Join 50,000 early adopters"
+```
+
+### 2. Social Proof
+
+```
+"Trusted by Fortune 500 companies"
+"4.9/5 stars from 10,000+ reviews"
+"As featured in Forbes, TechCrunch, and Wired"
+```
+
+### 3. Authority
+
+```
+"Recommended by industry experts"
+"Developed by former Google engineers"
+"Award-winning customer support"
+```
+
+### 4. Reciprocity
+
+```
+"Free 30-day trial - no credit card required"
+"Download our free guide"
+"Get instant access to our resource library"
+```
+
+### 5. Scarcity
+
+```
+"Only 5 seats left for this cohort"
+"Flash sale - 24 hours only"
+"Limited edition - won't be restocked"
+```
+
+## Writing Techniques
+
+### 1. Power Words
+
+**Action words**:
+
+- Discover, Unlock, Transform, Boost, Accelerate
+- Proven, Guaranteed, Exclusive, Limited, Secret
+
+**Emotional words**:
+
+- Amazing, Incredible, Stunning, Revolutionary
+- Effortless, Simple, Easy, Quick, Instant
+
+### 2. Sensory Language
+
+**Engage the senses**:
+
+```
+Instead of: "Good coffee"
+Write: "Rich, aromatic coffee with notes of dark chocolate"
+
+Instead of: "Fast software"
+Write: "Lightning-fast software that responds instantly"
+```
+
+### 3. Specificity
+
+**Be concrete, not vague**:
+
+```
+Vague: "Save money"
+Specific: "Save $1,247 per year"
+
+Vague: "Many customers"
+Specific: "12,847 customers in 47 countries"
+```
+
+### 4. Active Voice
+
+**Use active, not passive**:
+
+```
+Passive: "Your data is protected by encryption"
+Active: "We encrypt your data with military-grade security"
+```
+
+## Best Practices
+
+1. **Know your audience** - Write for one specific person
+2. **Focus on benefits, not features** - What's in it for them?
+3. **Use simple language** - Write at 8th-grade reading level
+4. **Create urgency** - Give readers a reason to act now
+5. **Tell stories** - Stories are memorable and persuasive
+6. **Use social proof** - Testimonials, case studies, numbers
+7. **Remove friction** - Make it easy to take action
+8. **Test everything** - A/B test headlines, CTAs, copy
+9. **Edit ruthlessly** - Cut unnecessary words
+10. **Read it aloud** - Does it sound natural?
+
+## Anti-Patterns
+
+- ❌ **Jargon and buzzwords** - Confuses readers
+- ❌ **Passive voice** - Weakens your message
+- ❌ **Vague claims** - "Best in class" without proof
+- ❌ **Too many CTAs** - Confuses and dilutes action
+- ❌ **Focusing on features** - Readers care about benefits
+- ❌ **Long paragraphs** - Hard to scan and read
+- ❌ **No clear value proposition** - Why should they care?
+- ❌ **Ignoring objections** - Address concerns proactively
+
+## Copy Checklist
+
+Before publishing, ask:
+
+- [ ] Does the headline grab attention?
+- [ ] Is the value proposition clear in 5 seconds?
+- [ ] Are benefits emphasized over features?
+- [ ] Is there social proof or credibility?
+- [ ] Is there a clear, compelling CTA?
+- [ ] Have I addressed objections?
+- [ ] Is the copy scannable (headers, bullets, short paragraphs)?
+- [ ] Does it pass the "so what?" test?
+- [ ] Is it free of jargon and complex language?
+- [ ] Have I created urgency or scarcity?
+
+## References
+
+- Breakthrough Advertising by Eugene Schwartz
+- The Copywriter's Handbook by Robert Bly
+- Influence by Robert Cialdini
+- Made to Stick by Chip & Dan Heath

package/.plcode/context/content/tone-voice.md

@@ -0,0 +1,391 @@
+# Tone & Voice Guidelines
+
+**Category**: content  
+**Purpose**: Maintaining consistent brand voice and adapting tone for different contexts  
+**Used by**: copywriter, technical-writer
+
+---
+
+## Overview
+
+Voice is your brand's personality - it stays consistent. Tone is how that voice adapts to different situations and audiences. This guide helps maintain consistency while being contextually appropriate.
+
+## Voice vs. Tone
+
+### Voice (Consistent)
+
+Your brand's personality that never changes:
+
+- Professional but approachable
+- Knowledgeable but not condescending
+- Confident but humble
+- Clear and direct
+
+### Tone (Adaptive)
+
+How voice adapts to context:
+
+- **Error messages**: Apologetic, helpful
+- **Success messages**: Encouraging, celebratory
+- **Marketing**: Enthusiastic, persuasive
+- **Documentation**: Clear, instructional
+- **Support**: Empathetic, solution-focused
+
+## Voice Dimensions
+
+### 1. Formality Spectrum
+
+**Formal** ←→ **Casual**
+
+**Formal**:
+
+```
+"We appreciate your business and look forward to serving you."
+```
+
+**Casual**:
+
+```
+"Thanks for choosing us! We're excited to work with you."
+```
+
+**Choose based on**:
+
+- Industry norms
+- Audience expectations
+- Context (legal vs. social)
+
+### 2. Enthusiasm Spectrum
+
+**Reserved** ←→ **Enthusiastic**
+
+**Reserved**:
+
+```
+"Your account has been created successfully."
+```
+
+**Enthusiastic**:
+
+```
+"Welcome aboard! Your account is ready to go! 🎉"
+```
+
+**Choose based on**:
+
+- Moment significance
+- User emotional state
+- Brand personality
+
+### 3. Expertise Spectrum
+
+**Educational** ←→ **Expert**
+
+**Educational**:
+
+```
+"Let's walk through this step by step. First, click the
+'Settings' button in the top right corner."
+```
+
+**Expert**:
+
+```
+"Navigate to Settings > Advanced > API Configuration."
+```
+
+**Choose based on**:
+
+- User expertise level
+- Content complexity
+- Context (onboarding vs. advanced docs)
+
+## Tone Guidelines by Context
+
+### 1. Marketing Copy
+
+**Characteristics**:
+
+- Enthusiastic and persuasive
+- Benefit-focused
+- Action-oriented
+- Emotionally engaging
+
+**Example**:
+
+```
+"Transform your workflow in minutes, not months. Join 10,000+
+teams who've already made the switch."
+```
+
+### 2. Product Documentation
+
+**Characteristics**:
+
+- Clear and instructional
+- Step-by-step
+- Neutral tone
+- Technically accurate
+
+**Example**:
+
+```
+"To configure authentication:
+1. Navigate to Settings > Security
+2. Click 'Add Authentication Method'
+3. Select your preferred provider"
+```
+
+### 3. Error Messages
+
+**Characteristics**:
+
+- Apologetic but not overly so
+- Explain what happened
+- Provide clear next steps
+- Never blame the user
+
+**Bad**:
+
+```
+"Error: Invalid input. Try again."
+```
+
+**Good**:
+
+```
+"We couldn't process your request because the email format
+isn't valid. Please check and try again."
+```
+
+### 4. Success Messages
+
+**Characteristics**:
+
+- Positive and encouraging
+- Confirm what happened
+- Suggest next steps
+- Celebrate wins
+
+**Example**:
+
+```
+"Great! Your changes have been saved. Ready to publish?"
+```
+
+### 5. Support Communication
+
+**Characteristics**:
+
+- Empathetic and understanding
+- Solution-focused
+- Patient and helpful
+- Personalized
+
+**Example**:
+
+```
+"I understand how frustrating this must be. Let's get this
+sorted out for you. Can you tell me what you see when you
+click the 'Export' button?"
+```
+
+### 6. Onboarding
+
+**Characteristics**:
+
+- Welcoming and encouraging
+- Educational without overwhelming
+- Progressive disclosure
+- Celebrate small wins
+
+**Example**:
+
+```
+"Welcome! Let's get you set up in 3 quick steps.
+First, let's create your workspace."
+```
+
+## Writing Principles
+
+### 1. Be Clear and Concise
+
+**Before**:
+
+```
+"In order to facilitate the process of account creation,
+it is necessary for you to provide your email address."
+```
+
+**After**:
+
+```
+"Enter your email to create your account."
+```
+
+### 2. Use Active Voice
+
+**Passive**:
+
+```
+"Your password has been reset by our system."
+```
+
+**Active**:
+
+```
+"We've reset your password."
+```
+
+### 3. Write for Humans
+
+**Robotic**:
+
+```
+"Operation completed successfully. Proceed to next step."
+```
+
+**Human**:
+
+```
+"All set! What would you like to do next?"
+```
+
+### 4. Be Inclusive
+
+**Exclusive**:
+
+```
+"Hey guys, check out our new feature!"
+```
+
+**Inclusive**:
+
+```
+"Check out our new feature!"
+```
+
+### 5. Avoid Jargon
+
+**Jargon-heavy**:
+
+```
+"Leverage our API to synergize your tech stack."
+```
+
+**Clear**:
+
+```
+"Connect our API to your existing tools."
+```
+
+## Emotional Tone Mapping
+
+### User Emotional State → Appropriate Tone
+
+**User is frustrated** → Empathetic, solution-focused
+
+```
+"I know this is frustrating. Let's fix this together."
+```
+
+**User achieved something** → Celebratory, encouraging
+
+```
+"Awesome work! You've completed your first project."
+```
+
+**User is confused** → Patient, educational
+
+```
+"No worries! Let me break this down for you."
+```
+
+**User made an error** → Helpful, non-judgmental
+
+```
+"Looks like there's a small issue. Here's how to fix it."
+```
+
+**User is new** → Welcoming, supportive
+
+```
+"Welcome! We're here to help you get started."
+```
+
+## Brand Voice Examples
+
+### Example 1: Tech Startup (Friendly, Modern)
+
+```
+Voice: Approachable, innovative, helpful
+Tone variations:
+- Marketing: "Build amazing things, faster"
+- Error: "Oops! Something went wrong. Let's try that again."
+- Success: "Nice! You're all set."
+```
+
+### Example 2: Enterprise SaaS (Professional, Trustworthy)
+
+```
+Voice: Professional, reliable, expert
+Tone variations:
+- Marketing: "Enterprise-grade security you can trust"
+- Error: "We encountered an issue. Please contact support."
+- Success: "Configuration saved successfully."
+```
+
+### Example 3: Creative Tool (Inspiring, Playful)
+
+```
+Voice: Creative, inspiring, fun
+Tone variations:
+- Marketing: "Unleash your creativity"
+- Error: "Hmm, that didn't work. Let's try something else!"
+- Success: "Beautiful! Your design is ready to share."
+```
+
+## Best Practices
+
+1. **Create a voice chart** - Document your brand's voice attributes
+2. **Use real examples** - Show, don't just tell
+3. **Consider context** - Adapt tone to situation
+4. **Be consistent** - Use the same voice across channels
+5. **Avoid clichés** - "Think outside the box," "game-changer"
+6. **Use contractions** - "We're" not "We are" (unless formal)
+7. **Address the user** - Use "you" and "your"
+8. **Be specific** - Concrete details over vague statements
+9. **Test with users** - Does it resonate?
+10. **Update regularly** - Voice evolves with your brand
+
+## Anti-Patterns
+
+- ❌ **Inconsistent voice** - Confuses users about your brand
+- ❌ **Overly formal** - Creates distance from users
+- ❌ **Too casual** - May seem unprofessional
+- ❌ **Jargon overload** - Excludes non-experts
+- ❌ **Passive voice** - Weakens your message
+- ❌ **Blaming users** - "You entered the wrong password"
+- ❌ **Fake enthusiasm** - "Amazing! Incredible! Awesome!" overuse
+- ❌ **Corporate speak** - "Leverage synergies to optimize"
+
+## Voice & Tone Checklist
+
+Before publishing, verify:
+
+- [ ] Does this sound like our brand?
+- [ ] Is the tone appropriate for the context?
+- [ ] Is it clear and easy to understand?
+- [ ] Does it use active voice?
+- [ ] Is it free of jargon?
+- [ ] Does it address the user directly?
+- [ ] Is it inclusive and respectful?
+- [ ] Does it match our voice chart?
+- [ ] Would I say this to someone in person?
+- [ ] Does it help the user accomplish their goal?
+
+## References
+
+- Nicely Said by Nicole Fenton & Kate Kiefer Lee
+- The Voice and Tone Guide by MailChimp
+- Conversational Design by Erika Hall