claude-flow-novice 2.14.22 → 2.14.23

package/claude-assets/cfn-agents-ignore/cfn-seo-team/HUMANIZER_PROMPTS.md

@@ -0,0 +1,536 @@
+# Humanizer Agent - Natural Writing Prompt Library
+
+**Version:** 1.0
+**Last Updated:** 2025-11-01
+**Purpose:** Prompt engineering techniques for humanizing AI-generated SEO content
+
+---
+
+## Overview
+
+This document provides evidence-based prompt engineering techniques for the humanizer-validator agent and content writers to produce natural, human-sounding content that avoids AI detection patterns.
+
+**Research Basis:**
+- Stanford 2025 Language Perception Study (redundancies & self-corrections)
+- 56% of readers prefer human-generated content (2025 survey)
+- Readers rate text as more authentic with occasional imperfections
+
+---
+
+## Core Humanization Principles
+
+### 1. Conversational Tone
+**Instruction Pattern:**
+```
+Write as if explaining to a close friend over coffee. Use:
+- Contractions (don't, won't, it's)
+- Casual connectors (so, anyway, honestly)
+- Rhetorical questions
+- Direct address (you, your)
+```
+
+**Example Prompt:**
+```
+Rewrite this section using conversational language. Imagine you're
+telling a story to someone who knows nothing about this topic.
+Use "you" frequently and add questions like "Have you ever...?"
+```
+
+### 2. Natural Sentence Variety
+**Instruction Pattern:**
+```
+Mix sentence lengths and structures:
+- Short punchy sentences (3-5 words)
+- Medium explanatory sentences (10-15 words)
+- Longer complex sentences (20-30 words)
+- Occasional fragments for emphasis
+```
+
+**Example Prompt:**
+```
+Vary your sentence structure. Start some with action verbs.
+Others with questions. Mix short sentences (5 words) with
+longer ones (25 words). Break rules occasionally. Like this.
+```
+
+### 3. Personal Touch
+**Instruction Pattern:**
+```
+Add personal elements:
+- Relatable anecdotes ("I remember when...")
+- Personal experiences
+- Honest mistakes/lessons learned
+- Emotional reactions (excitement, frustration)
+```
+
+**Example Prompt:**
+```
+Include a brief personal story that illustrates this point.
+Use phrases like "I remember when" or "In my experience".
+Show vulnerability by mentioning a mistake you learned from.
+```
+
+### 4. Emotional Language
+**Instruction Pattern:**
+```
+Convey genuine feelings:
+- Excitement: "This changed everything for me"
+- Empathy: "I understand how overwhelming this feels"
+- Curiosity: "What if we could..."
+- Frustration: "I struggled with this for months"
+```
+
+**Example Prompt:**
+```
+Add emotional depth. When describing benefits, express genuine
+excitement. When discussing pain points, show empathy. Use
+phrases like "I get it" or "You're not alone in this."
+```
+
+### 5. Active Voice Dominance
+**Instruction Pattern:**
+```
+Prefer active constructions:
+- ✅ "Your family will treasure these stories"
+- ❌ "These stories will be treasured by your family"
+- ✅ "Grandma told me this technique"
+- ❌ "This technique was told to me by Grandma"
+```
+
+**Example Prompt:**
+```
+Rewrite all passive voice sentences to active voice. Make the
+subject perform the action. Example: Change "The story was
+shared by my mother" to "My mother shared the story."
+```
+
+---
+
+## Anti-AI Detection Prompts
+
+### Eliminate Generic Openings
+**Prompt:**
+```
+Remove any opening that sounds like:
+- "In today's digital age..."
+- "In the modern world..."
+- "Have you ever wondered..."
+- "It's no secret that..."
+
+Instead, start with:
+- A surprising fact
+- A personal story
+- A provocative question specific to the topic
+- An unexpected statement
+```
+
+### Remove AI Tell-Tale Phrases
+**Prompt:**
+```
+Find and replace these AI-generated phrases:
+- "Delve into" → "explore" or "look at"
+- "It's worth noting" → (remove or be specific)
+- "Unlock the potential" → "discover" or "achieve"
+- "Navigate the landscape" → "understand" or "work through"
+- "Embark on a journey" → "start" or "begin"
+- "Leverage" → "use"
+- "Utilize" → "use"
+- "Game-changer" → (be specific about the change)
+```
+
+### Add Imperfections (Natural Writing)
+**Prompt:**
+```
+Make this sound more human by:
+- Adding occasional redundancy for emphasis
+- Including a self-correction ("Actually, let me rephrase...")
+- Using parenthetical asides (like this)
+- Adding em dashes for emphasis — they work great
+- Including a brief tangent that circles back
+```
+
+---
+
+## Content Type-Specific Prompts
+
+### Blog Posts (Informational)
+```
+Write this blog post as if you're teaching a friend who just
+asked you about this over lunch. Start with why you care about
+this topic. Use "you" and "your" throughout. Include at least
+2 personal examples. Add a question every 3-4 paragraphs to
+keep readers engaged. End with an encouraging call-to-action.
+```
+
+### Landing Pages (Conversion)
+```
+Write persuasive copy that sounds like a trusted advisor, not
+a salesperson. Use short sentences in the intro. Address the
+reader's pain point with empathy. Share a brief success story.
+Use bullet points for benefits. End with a clear, friendly CTA.
+```
+
+### How-To Guides (Educational)
+```
+Explain each step as if you're walking someone through it in
+person. Use "we'll" instead of "you will". Anticipate mistakes
+("Don't worry if..."). Add encouragement ("You're doing great").
+Include specific examples at each step. Use conversational
+transitions between steps.
+```
+
+### Product Descriptions (E-commerce)
+```
+Describe this product like you're recommending it to a friend.
+Focus on how it feels to use, not just features. Include a
+personal anecdote about when this type of product helped you.
+Use sensory language (looks, feels, sounds). Be honest about
+who it's NOT for.
+```
+
+---
+
+## 15-Point Humanization Checklist
+
+Use this checklist when reviewing content:
+
+**Conversational Elements:**
+- [ ] Uses contractions naturally (don't, won't, it's)
+- [ ] Includes casual connectors (so, anyway, honestly)
+- [ ] Asks rhetorical questions
+- [ ] Uses direct address (you, your) frequently
+
+**Structure Variety:**
+- [ ] Mixes short and long sentences
+- [ ] Varies paragraph openings
+- [ ] Includes occasional sentence fragments
+- [ ] Uses em dashes or parentheses for asides
+
+**Personal Touch:**
+- [ ] Includes specific personal examples
+- [ ] Shows vulnerability or mistakes
+- [ ] Expresses genuine emotions
+- [ ] Uses relatable scenarios
+
+**Natural Language:**
+- [ ] Active voice dominates (>80%)
+- [ ] No AI tell-tale phrases
+- [ ] No generic openings
+- [ ] Sounds like conversation, not lecture
+
+**Engagement:**
+- [ ] Creates dialogue with reader
+- [ ] Shows empathy for reader's situation
+- [ ] Offers specific, actionable advice
+
+---
+
+## Example Transformations
+
+### Before (AI-Generated)
+```
+In today's digital landscape, preserving family stories has
+become increasingly important. It's worth noting that many
+families struggle to capture these narratives. Moreover, the
+process can seem daunting. Additionally, resources are often
+limited. To effectively preserve your family's legacy, you
+should leverage modern tools and strategies.
+```
+
+**Issues:**
+- Generic opening ("In today's digital landscape")
+- AI phrases ("It's worth noting", "leverage")
+- Formulaic transitions ("Moreover", "Additionally")
+- Passive/formal tone
+- No personality
+
+### After (Humanized)
+```
+My grandmother's photo albums sat in her attic for 30 years.
+The stories behind those photos? Almost lost forever.
+
+You might be facing the same thing. Your parents' memories are
+slipping away, and you're not sure where to start. I get it —
+I put this off for years before I finally figured out a system
+that actually works.
+
+Let me show you how three families (including mine) turned
+forgotten stories into cherished keepsakes. No fancy equipment
+needed. Just 10 minutes a week.
+```
+
+**Improvements:**
+- Personal opening (grandmother's albums)
+- Direct address (you, your)
+- Empathy ("I get it")
+- Specific examples (3 families, 10 minutes)
+- Natural transitions
+- Conversational fragments ("No fancy equipment needed.")
+
+---
+
+## Prompt Engineering Templates
+
+### Template 1: Rewrite for Humanity
+```
+Rewrite this content to sound naturally human. Specifically:
+
+1. Replace the opening with a personal story or surprising fact
+2. Use "you" and "your" throughout
+3. Add 2-3 specific examples from real situations
+4. Include at least one brief personal anecdote
+5. Vary sentence length (mix 5-word and 25-word sentences)
+6. Remove any phrases that sound like AI (delve, leverage, navigate, unlock)
+7. Add emotion words that convey genuine feelings
+8. Use contractions naturally
+9. End with an encouraging, specific call-to-action
+
+Tone: Friendly advisor talking to someone they care about
+```
+
+### Template 2: Add Personal Touch
+```
+Take this informational content and add human elements:
+
+1. Start each section with "Here's what I learned..." or similar
+2. Include a mistake you made related to this topic
+3. Add a relatable scenario ("Imagine you're...")
+4. Use parenthetical asides to show your thought process
+5. Include self-correction ("Actually, let me clarify...")
+6. Add sensory details (how something looks, feels, sounds)
+7. Express genuine emotion about key points
+
+Goal: Reader should feel like you're having coffee together
+```
+
+### Template 3: Eliminate AI Patterns
+```
+Review this content and fix AI-generated patterns:
+
+Red flags to remove:
+- "In today's [adjective] [world/landscape/age]"
+- "It's worth noting that"
+- "Moreover", "Furthermore", "Additionally" (formulaic transitions)
+- "Delve into", "unlock", "leverage", "navigate the landscape"
+- Passive voice sentences
+- Generic statements without specifics
+
+Replace with:
+- Specific facts or personal observations
+- Natural transitions (questions, examples, direct statements)
+- Active voice
+- Concrete examples with numbers/details
+- Conversational flow
+
+Make it sound like a knowledgeable friend, not a report.
+```
+
+---
+
+## Integration with Validators
+
+### For Humanizer Validator Agent
+
+Add this to validation scoring:
+
+```javascript
+// Conversational Score (0.0-1.0)
+const conversationalScore = calculateScore({
+  contractionUsage: countContractions(text),
+  directAddress: countOccurrences(text, ['you', 'your']),
+  rhetoricalQuestions: countQuestions(text),
+  casualConnectors: countOccurrences(text, ['so', 'anyway', 'honestly'])
+});
+
+// Personal Touch Score (0.0-1.0)
+const personalScore = calculateScore({
+  personalPronouns: countOccurrences(text, ['I', 'me', 'my']),
+  anecdotes: detectAnecdoteMarkers(text),
+  emotions: countEmotionalWords(text),
+  vulnerability: detectVulnerability(text)
+});
+
+// Anti-AI Score (0.0-1.0)
+const antiAIScore = 1.0 - calculateScore({
+  aiPhrases: countAIPhrases(text),
+  genericOpenings: detectGenericOpenings(text),
+  formulaicTransitions: countFormulaic(text),
+  passiveVoice: calculatePassiveVoiceRatio(text)
+});
+```
+
+### Feedback Template for Iterations
+
+When validator scores < 0.75, provide this feedback structure:
+
+```
+HUMANIZATION FEEDBACK (Iteration ${N})
+
+Score: ${score}/1.0 (Threshold: 0.75)
+
+RED FLAGS FOUND:
+${redFlags.map(flag => `- Line ${flag.line}: "${flag.text}" (${flag.type})`).join('\n')}
+
+SPECIFIC IMPROVEMENTS:
+
+1. Opening (Lines 1-5):
+   CURRENT: "${currentOpening}"
+   SUGGESTION: "Start with personal story: 'When my grandmother...'"
+
+2. Transitions (Lines 12, 18, 24):
+   CURRENT: "Moreover...", "Additionally..."
+   SUGGESTION: "Use questions or examples: 'But here's what surprised me...'"
+
+3. Personal Touch (Missing):
+   SUGGESTION: "Add anecdote in section 2: 'I learned this the hard way when...'"
+
+4. Emotional Connection (Weak):
+   SUGGESTION: "Express genuine feeling: 'This changed how I think about...'"
+
+REWRITE PRIORITY:
+1. ${priority1}
+2. ${priority2}
+3. ${priority3}
+```
+
+---
+
+## Testing & Measurement
+
+### Human vs AI Detection Benchmarks
+
+Test humanized content against:
+
+1. **GPTZero** (AI detection tool)
+   - Target: <40% AI probability
+   - Measure: Sentence-level perplexity variation
+
+2. **Reader Survey** (A/B test)
+   - Question: "Does this sound like a real person wrote it?"
+   - Target: >70% "Yes" responses
+
+3. **Engagement Metrics**
+   - Time on page: >2 minutes
+   - Scroll depth: >75%
+   - Social shares: >5 per 1000 views
+
+### Quality Metrics (Humanizer Validator)
+
+- **Conversational Score:** ≥0.80
+- **Personal Touch Score:** ≥0.75
+- **Anti-AI Score:** ≥0.90
+- **Overall Humanization Score:** ≥0.85
+
+---
+
+## Advanced Techniques
+
+### Stanford Study: Intentional Imperfection
+
+Research shows readers rate text as more authentic with:
+
+1. **Occasional Redundancy**
+   ```
+   "This is crucial. Really, it's one of the most important things."
+   ```
+
+2. **Self-Correction**
+   ```
+   "You'll need about 30 minutes. Actually, make it 45 to be safe."
+   ```
+
+3. **Parenthetical Asides**
+   ```
+   "The next step (and this is where most people struggle) is..."
+   ```
+
+### Humor Without Overshadowing
+
+Add light humor sparingly:
+
+```
+"Your family tree probably has a few nuts. Mine definitely does.
+Let's preserve those stories anyway."
+```
+
+**Rules:**
+- Max 1 joke per 500 words
+- Self-deprecating > mocking
+- Relevant to topic
+- Skip if serious topic (grief, illness)
+
+### Sensory Details for Authenticity
+
+Instead of:
+```
+"The interview process was meaningful."
+```
+
+Use sensory language:
+```
+"Hearing my grandfather's voice crack when he described meeting
+my grandmother — that moment still gives me chills."
+```
+
+---
+
+## Maintenance & Updates
+
+### Quarterly Review Process
+
+1. **Analyze Failed Validations**
+   - Collect content that scored <0.75
+   - Identify common patterns
+   - Update red flag list
+
+2. **Test New AI Models**
+   - GPT-5, Claude 4, Gemini 2
+   - Identify new AI tell-tale phrases
+   - Update detection patterns
+
+3. **Reader Feedback**
+   - Survey 100 readers quarterly
+   - Ask: "What made this feel authentic/robotic?"
+   - Incorporate findings
+
+4. **Competitor Analysis**
+   - Review human-written competitor content
+   - Identify successful natural writing patterns
+   - Adapt prompts accordingly
+
+---
+
+## Quick Reference Card
+
+**Top 5 Humanization Prompts:**
+
+1. **Conversational:** "Write like explaining to a friend over coffee. Use 'you', contractions, and questions."
+
+2. **Personal:** "Include a brief story starting with 'I remember when...' Show a mistake you learned from."
+
+3. **Emotional:** "Express genuine feelings. Use empathy phrases like 'I understand how challenging this is.'"
+
+4. **Varied Structure:** "Mix 5-word sentences with 25-word ones. Use fragments for emphasis. Like this."
+
+5. **Anti-AI:** "Remove: 'delve into', 'leverage', 'in today's digital age'. Start with surprising fact or personal story."
+
+---
+
+## Resources
+
+### Tools
+- **Hemingway Editor** - Simplify complex sentences
+- **Grammarly Tone Detector** - Verify conversational tone
+- **GPTZero** - Test AI detection probability
+
+### Further Reading
+- Stanford 2025 Language Perception Study
+- "Writing for Humans, Not Robots" (2025)
+- "Conversational Copywriting" by Nick Usborne
+
+---
+
+**Document Version:** 1.0
+**Last Updated:** 2025-11-01
+**Owner:** CFN SEO Team
+**Next Review:** 2025-02-01 (Quarterly)