@jairodri/huckleberry-cli 1.0.1 → 1.1.0

package/skills/marketing-psychology/SKILL.md

@@ -0,0 +1,374 @@
+---
+name: marketing-psychology
+description: "Knowledge skill that applies behavioral psychology and persuasion principles to any marketing asset."
+category: knowledge
+layer: knowledge
+tier: must-have
+reads:
+  - brand/positioning.md
+  - brand/audience.md
+  - brand/voice-profile.md
+writes: []
+depends-on: []
+triggers:
+  - marketing psychology
+  - persuasion
+  - Cialdini
+  - scarcity
+  - social proof
+  - cognitive bias
+  - psychological triggers
+  - influence tactics
+  - make this more convincing
+  - add urgency
+allowed-tools: []
+---
+
+# Marketing Psychology
+
+## Purpose
+
+This is a KNOWLEDGE skill. It does not produce standalone deliverables. Instead, it enhances any marketing asset — landing pages, emails, ads, CTAs, pricing pages, onboarding flows — by applying behavioral psychology principles that increase persuasion and conversion.
+
+When another skill produces copy or UX, this skill provides the psychological layer: why certain framings work, which biases to apply, and specific before/after rewrites grounded in research.
+
+## No Reads/Writes
+
+This skill is pure reference. It reads no brand files and writes no outputs. It is applied ON TOP of other skills' work.
+
+## Brand Context Enhancement
+
+While this skill reads no files itself, the calling skill should provide brand context when available:
+
+- **audience.md** -> Knowing the audience helps select the right social proof type (peer testimonials for B2B, user statistics for consumer), the right authority signals (industry certifications for enterprise, founder story for indie), and the right scarcity framing (launch pricing for startups, seat limits for teams).
+- **voice-profile.md** -> Brand voice affects HOW principles are applied. A playful brand uses conversational loss aversion ("Don't miss out on..."). A professional brand uses data-driven framing ("Companies without X lose an average of...").
+- **positioning.md** -> Premium positioning supports authority and anchoring. Challenger positioning supports liking and social proof from peers.
+
+When calling this skill, pass relevant brand context so principles are applied in voice, not generically.
+
+## Workflow
+
+### Step 1: Identify the Asset Type
+
+Determine what marketing asset is being optimized:
+
+- Landing page (hero, body, CTA)
+- Email (subject, body, CTA)
+- Ad copy (headline, description, creative)
+- Pricing page (tiers, anchoring, CTA)
+- Onboarding flow (screens, copy, nudges)
+- Social post (hook, body, CTA)
+- Cancel flow (retention, objection handling)
+- Sales page (long-form persuasion)
+
+### Step 2: Select Applicable Principles
+
+Not every principle applies to every asset. Match principles to context. Use the Application Matrix below for quick selection.
+
+### Step 3: Consider B2B vs B2C Differences
+
+| Principle | B2B Emphasis | B2C Emphasis |
+|-----------|-------------|-------------|
+| Social proof | Case studies, logos, ROI metrics | User counts, ratings, peer testimonials |
+| Authority | Industry certifications, compliance | Celebrity endorsements, media features |
+| Scarcity | Limited pilot spots, implementation slots | Limited stock, countdown timers |
+| Loss aversion | Revenue at risk, competitive disadvantage | Missing out on experiences, wasted time |
+| Anchoring | ROI comparison, cost of inaction | Was/now pricing, competitor comparison |
+
+**For real-world case studies of each principle in action:** See [references/case-studies.md](references/case-studies.md) — 11 examples from companies like HubSpot, Netflix, Stripe, Duolingo, and Superhuman showing how principles translate to specific implementations.
+
+## How to Use This Skill
+
+This is a knowledge skill — it enhances other skills' output rather than producing standalone deliverables.
+
+**Invocation pattern:** When another skill produces copy or UX, ask: "Apply marketing psychology principles to this asset." This skill audits the output and suggests principle-specific rewrites.
+
+**Example:** After /direct-response-copy produces a landing page, apply this skill to audit the hero for anchoring, the CTA for scarcity, and the testimonials for social proof.
+
+## Cialdini's 6 Principles of Persuasion
+
+### 1. Reciprocity
+
+People feel obligated to return favors. Give value first, ask second.
+
+**Application:**
+- Free tools, templates, guides before asking for signup
+- Free trial with no credit card (gift, not trap)
+- Personalized recommendations or audit before pitching
+
+**Before:** "Sign up for our product"
+**After:** "Here's a free audit of your [X]. Want to fix these issues automatically? [Start free trial]"
+
+**Why this works:** Giving value before asking creates an obligation loop — the free checklist makes the paid product feel like a natural next step, not a cold ask.
+
+**Where it works best:** Lead magnets, free tools, onboarding emails, content marketing
+
+### 2. Commitment and Consistency
+
+People who take small steps continue in the same direction. Micro-commitments build toward conversion.
+
+**Application:**
+- "Yes ladder" — series of small agreements before the big ask
+- Interactive tools that invest the user's time (endowment effect crossover)
+- Public commitments: sharing goals, publishing results
+- Progressive profiling: ask for email first, details later
+
+**Before:** "Buy our annual plan for $299/year"
+**After:** "Start your free project -> See your first results -> Upgrade when you're ready"
+
+**Why this works:** Each small yes builds psychological momentum — once someone has invested time and seen results, saying yes to payment feels consistent with their prior actions.
+
+**Where it works best:** Signup flows, onboarding, pricing pages, email sequences
+
+### 3. Social Proof
+
+People follow the actions of others, especially similar others.
+
+**Types of social proof (ordered by persuasion strength):**
+
+| Type | Example | Strength |
+|------|---------|----------|
+| Expert endorsement | "[Industry expert] recommends [Product]" | Highest |
+| Celebrity/Influencer | "[Known figure] uses [Product]" | High |
+| User statistics | "12,847 teams use [Product]" | High |
+| Peer testimonial | "[Same role/industry] saw [specific result]" | High |
+| Certification/Award | "G2 Leader, 4.8/5 stars" | Medium |
+| Wisdom of crowds | "Most popular plan" badge | Medium |
+| Friend referral | "[Name] invited you" | Highest (context-dependent) |
+
+**Before:** "Our product is great"
+**After:** "12,847 marketing teams use [Product] to save 10+ hours/week. Here's what [Similar Company] achieved in 30 days."
+
+**Why this works:** Humans use others' behavior as a decision shortcut — specific numbers and named peers eliminate the need to evaluate the product independently.
+
+**Where it works best:** Every asset. No exceptions. Always include social proof.
+
+### 4. Authority
+
+People defer to experts and credible sources.
+
+**Authority signals:**
+- Founder credentials and expertise
+- Media logos ("As seen in TechCrunch, Forbes")
+- Data and research citations
+- Industry certifications and compliance badges
+- Published content demonstrating expertise
+- Years in business, customers served
+
+**Before:** "We help with email marketing"
+**After:** "Built by the team that scaled [Company]'s email list from 0 to 500K subscribers"
+
+**Why this works:** Concrete credentials transfer trust instantly — the reader borrows confidence from the known achievement rather than evaluating your claim from scratch.
+
+**Where it works best:** Landing pages, about pages, sales emails, B2B proposals
+
+### 5. Liking
+
+People buy from people (and brands) they like. Similarity, compliments, and cooperation build liking.
+
+**Application:**
+- Use customer's language, not corporate jargon
+- Show the team (real photos, real names)
+- Mirror the audience's values and frustrations
+- Conversational tone > formal tone
+- "We built this because we had this problem too"
+
+**Before:** "Our enterprise-grade solution leverages AI-powered analytics"
+**After:** "We were tired of staring at spreadsheets too. So we built [Product]."
+
+**Why this works:** Mirroring the audience's frustration signals "we're one of you" — people trust and buy from those who understand their lived experience.
+
+**Where it works best:** Brand voice, about pages, founder stories, email tone
+
+### 6. Scarcity
+
+People value what's limited. Real scarcity drives action; manufactured scarcity destroys trust.
+
+**Legitimate scarcity patterns:**
+- Limited beta access (real capacity constraint)
+- Expiring discounts tied to events (launch pricing, annual sale)
+- Feature limits on free tier (natural product boundary)
+- Seats or usage limits (infrastructure reality)
+
+**Illegitimate scarcity (never use):**
+- Fake countdown timers that reset
+- "Only 2 left!" when there's unlimited supply
+- Artificial waitlists for available products
+- Urgency language with no actual deadline
+
+**Before:** "Sign up anytime"
+**After:** "Launch pricing: $29/mo for the first 500 customers (347 claimed)" — only if real
+
+**Why this works:** Real scarcity activates fear of missing out on a genuine opportunity — the specific count (347/500) makes the constraint feel tangible and urgent without feeling manufactured.
+
+**Where it works best:** Pricing pages, launch campaigns, limited offers (when genuine)
+
+## Cognitive Biases for Marketing
+
+### Loss Aversion
+
+People feel losses 2x more intensely than equivalent gains. Frame around what they'll lose, not just what they'll gain.
+
+**Before:** "Save 10 hours per week with [Product]"
+**After:** "You're losing 10 hours every week to [manual task]. [Product] gives them back."
+
+**Why this works:** The pain of losing 10 hours hits harder than the pleasure of saving them — reframing a gain as a recovered loss doubles the emotional weight.
+
+**Application:** Cancel flows, upgrade prompts, trial expiration emails, feature comparison
+
+### Anchoring
+
+The first number people see becomes the reference point. Control the anchor.
+
+**Application:**
+- Show highest-priced plan first on pricing page
+- Compare your price to the cost of the problem: "Losing $5K/month to [problem]? Fix it for $49/month."
+- Show original price crossed out next to sale price
+- "Teams spend 20 hours/week on [task]. [Product] reduces it to 2."
+
+**Pricing page pattern:**
+```
+Enterprise: $299/mo  <-  Anchor
+Pro: $99/mo          <-  Looks reasonable now
+Starter: $29/mo      <-  Feels like a steal
+```
+
+### Endowment Effect
+
+People value things more once they feel ownership. Let them invest before asking to pay.
+
+**Application:**
+- Free trials that let users create real work (not sandboxed demos)
+- "Your dashboard", "Your projects" language from day one
+- Showing what they'll lose at trial end: "You have 3 active projects and 47 contacts"
+- Data import during onboarding (invested effort = harder to leave)
+
+### IKEA Effect
+
+People value things they helped build. Involvement increases attachment.
+
+**Application:**
+- Onboarding that involves customization (pick your theme, set your goals)
+- Interactive tools that require user input
+- Templates users modify rather than pre-built outputs
+- "Built by you" framing for created assets
+
+### Paradox of Choice
+
+Too many options -> decision paralysis -> no action. Reduce choices, add recommendations.
+
+**Application:**
+- 3 pricing tiers maximum, one highlighted as "Most Popular"
+- "Recommended for you" based on signup answers
+- Default selections for settings and preferences
+- "Start here" guidance instead of feature overwhelm
+
+**Before:** 5 plan tiers with 40 feature comparison rows
+**After:** 3 plans, "Most Popular" badge on middle tier, "Not sure? Start with Pro" CTA
+
+**Why this works:** Reducing options from 5 to 3 eliminates decision paralysis, and the "Most Popular" badge gives permission to stop comparing — the crowd already chose for you.
+
+### Zero-Risk Bias
+
+People strongly prefer eliminating a risk entirely over reducing it. Money-back guarantees outperform discount offers.
+
+**Application:**
+- "30-day money-back guarantee. No questions asked."
+- "Cancel anytime. No contracts, no penalties."
+- "Free tier available forever" (eliminates downgrade anxiety)
+- "We'll migrate your data for free" (eliminates switching risk)
+
+### Framing Effect
+
+The same information presented differently changes decisions. Frame to match your goal.
+
+**Application:**
+- "95% uptime" vs "Only 5% downtime" — same fact, different feeling
+- "Join 10,000 happy customers" vs "Don't be one of the few who miss out"
+- "Save $120/year" vs "Save $10/month" — annual framing feels bigger for savings
+- Positive frame for gains ("Get X"), negative frame for preventing losses ("Stop losing X")
+
+**Before:** "Our tool has 99.9% accuracy"
+**After:** "Our tool catches 999 out of every 1,000 errors — so nothing slips through"
+
+**Why this works:** Concrete framing (999/1000) is more vivid than abstract percentages. The reader can picture the result.
+
+### Status Quo Bias
+
+People prefer the current state of affairs. Reducing friction to switch is more effective than amplifying benefits.
+
+**Application:**
+- "Import your data in one click" (reduces switching cost)
+- "Works with tools you already use" (no workflow change)
+- "Keep your existing setup — we just plug in"
+- Free migration services eliminate the biggest barrier
+
+**Where it works best:** Competitor displacement, upgrade prompts, onboarding
+
+### Mere Exposure Effect
+
+Familiarity breeds preference. People like what they've seen before.
+
+**Application:**
+- Retargeting ads that keep your brand visible
+- Consistent visual branding across all touchpoints
+- Content marketing that puts your name in front of prospects repeatedly
+- Email nurture sequences that build familiarity before asking for the sale
+
+**Where it works best:** Top-of-funnel content, retargeting, email sequences, social media presence
+
+## Framework Application Matrix
+
+Quick reference — which principles apply to which assets:
+
+| Principle | Landing Page | Email | Pricing | Onboarding | Ads |
+|-----------|-------------|-------|---------|------------|-----|
+| Reciprocity | Medium | High | Low | High | Low |
+| Commitment | Low | High | Medium | High | Low |
+| Social Proof | High | Medium | High | Medium | High |
+| Authority | High | Medium | Medium | Low | High |
+| Liking | Medium | High | Low | High | Medium |
+| Scarcity | Medium | High | High | Low | High |
+| Loss Aversion | Medium | High | High | High | Medium |
+| Anchoring | Medium | Low | High | Low | Medium |
+| Endowment | Low | Medium | Low | High | Low |
+| Framing | High | High | Medium | Medium | High |
+| Status Quo | Medium | Low | Low | High | Medium |
+
+## How to Apply This Skill
+
+When reviewing any marketing asset:
+
+1. **Identify** the asset type and primary conversion goal
+2. **Select** 2-4 most relevant principles (don't force all of them)
+3. **Consider** B2B vs B2C context — application differs significantly
+4. **Audit** current copy/UX for existing psychology use (intentional or accidental)
+5. **Suggest** specific changes with before/after examples
+6. **Prioritize** by expected impact: social proof and loss aversion almost always win
+7. **Warn** about dark patterns: if a suggestion feels manipulative, flag it and offer an ethical alternative
+
+## Anti-Patterns
+
+| Mistake | Why it fails | Instead |
+|---------|-------------|---------|
+| Applying all principles to every asset | Stacking 10 principles on one page creates a manipulative wall of tricks that readers feel viscerally — less is more persuasive | Select 2-4 most relevant using the Application Matrix |
+| Forcing scarcity where none exists | Users share notes about fake urgency on social media — one "fake countdown timer" screenshot can destroy brand trust permanently | Only use scarcity with real constraints. Fake urgency destroys trust |
+| Generic "add social proof" without specifics | "Add social proof" gives the agent nothing to work with — peer testimonials work differently than user counts, and the wrong type falls flat | Specify the TYPE of social proof (peer testimonial, user count, expert endorsement) based on audience |
+| Applying principles without considering brand voice | A corporate brand writing "Don't miss out!!" and a playful brand writing "Enterprise-grade urgency metrics" both sound absurd | A playful brand and a corporate brand apply the same principle very differently |
+| Suggesting dark patterns as psychological techniques | Dark patterns generate short-term conversions but long-term refunds, chargebacks, and reputation damage | Always apply the transparency test: would you be comfortable if the user knew? |
+| Ignoring that the asset might already be effective | Over-optimizing working copy risks breaking what already converts — psychology should enhance, not overhaul | Audit first — if conversion is strong, don't add psychology for the sake of it |
+
+## Ethical Boundaries
+
+Use psychology to help people make better decisions, not to trick them:
+
+- **Use:** Helping users understand value they're already getting (loss aversion in cancel flow)
+- **Don't use:** Manufacturing fake urgency to pressure purchases
+- **Use:** Social proof showing real users with real results
+- **Don't use:** Fake testimonials or inflated numbers
+- **Use:** Anchoring to help frame fair pricing in context
+- **Don't use:** Hiding fees or making comparison deliberately confusing
+- **Use:** Commitment/consistency to help users follow through on goals they set
+- **Don't use:** Dark patterns that make cancellation impossible
+
+The test: Would you be comfortable if the user knew exactly what psychological principle you were applying? If yes, proceed. If no, find another approach.

package/skills/marketing-psychology/evals/evals.json

@@ -0,0 +1,88 @@
+{
+  "skill_name": "marketing-psychology",
+  "evals": [
+    {
+      "id": 1,
+      "prompt": "How can I use psychology to increase conversions on our pricing page? We sell a B2B SaaS tool with three tiers ($29, $79, $199/month).",
+      "expected_output": "Should check for product-marketing-context.md first. Should apply relevant pricing psychology models: anchoring (show the highest plan first or use a decoy), charm pricing (consider $29 vs $30), Rule of 100 (percentage vs dollar discounts), Good-Better-Best framing, loss aversion (show what they miss on lower tiers). Should also apply broader persuasion models: social proof near pricing, scarcity for limited-time offers, default effect (pre-select recommended plan). Should provide specific, actionable recommendations tied to their price points.",
+      "assertions": [
+        "Checks for product-marketing-context.md",
+        "Applies pricing psychology models (anchoring, charm pricing, Rule of 100)",
+        "Applies Good-Better-Best framing",
+        "Applies loss aversion to tier differentiation",
+        "Applies social proof near pricing",
+        "Provides specific recommendations for their price points",
+        "References specific mental models by name"
+      ],
+      "files": []
+    },
+    {
+      "id": 2,
+      "prompt": "Explain the scarcity principle and how to use it ethically in SaaS marketing without being manipulative.",
+      "expected_output": "Should explain scarcity as a mental model (limited availability increases perceived value). Should provide legitimate SaaS applications: limited beta spots, early-bird pricing with real deadlines, limited-time feature access, cohort-based launches. Should distinguish ethical scarcity (real constraints) from manufactured urgency (fake countdown timers, artificial limits). Should provide specific examples and implementation guidance. Should reference related models (urgency, FOMO, loss aversion).",
+      "assertions": [
+        "Explains scarcity principle clearly",
+        "Provides legitimate SaaS applications",
+        "Distinguishes ethical from manipulative use",
+        "Provides specific examples",
+        "References related mental models",
+        "Addresses ethical considerations directly"
+      ],
+      "files": []
+    },
+    {
+      "id": 3,
+      "prompt": "what psychological principles should I use to write better marketing copy?",
+      "expected_output": "Should trigger on casual phrasing. Should recommend copy-relevant mental models from the skill's taxonomy: social proof, reciprocity, loss aversion, anchoring, scarcity, IKEA Effect, Endowment Effect, Commitment & Consistency. For each principle, should explain what it is and provide a specific copywriting application. Should reference the quick reference table by challenge. Should organize by where in the copy each principle applies (headlines, body, CTAs, testimonials).",
+      "assertions": [
+        "Triggers on casual phrasing",
+        "Recommends copy-relevant mental models",
+        "Explains each principle briefly",
+        "Provides specific copywriting application per principle",
+        "Organizes by where each applies in copy",
+        "References multiple model categories"
+      ],
+      "files": []
+    },
+    {
+      "id": 4,
+      "prompt": "I'm designing an onboarding flow and want to use behavioral psychology to increase activation. What models should I apply?",
+      "expected_output": "Should apply design and behavioral models from the skill's taxonomy: Goal-Gradient Effect (motivation increases near goal), Hick's Law (reduce choices), IKEA Effect (let users build something), Endowment Effect (let them experience ownership), Zeigarnik Effect (incomplete tasks drive completion), Commitment & Consistency (small asks first). Should explain how each applies to onboarding specifically. Should provide actionable recommendations for each model.",
+      "assertions": [
+        "Applies Goal-Gradient Effect",
+        "Applies Hick's Law",
+        "Applies IKEA Effect or Endowment Effect",
+        "Applies Zeigarnik Effect or commitment principles",
+        "Explains how each applies to onboarding",
+        "Provides actionable recommendations per model"
+      ],
+      "files": []
+    },
+    {
+      "id": 5,
+      "prompt": "What's the psychology behind why free trials work better than freemium for some products?",
+      "expected_output": "Should apply relevant mental models: loss aversion (trial users fear losing access), endowment effect (they feel ownership after using), sunk cost (time invested during trial), Zero-Price Effect (free removes psychological barrier to start), status quo bias (inertia to keep what they have). Should explain how these models interact in trial vs freemium contexts. Should note when each model works best (trial for products with high activation effort, freemium for products with network effects).",
+      "assertions": [
+        "Applies loss aversion to trial context",
+        "Applies endowment effect",
+        "Applies Zero-Price Effect",
+        "Explains how models interact in trial vs freemium",
+        "Notes when each approach works best",
+        "Provides clear, educational explanation"
+      ],
+      "files": []
+    },
+    {
+      "id": 6,
+      "prompt": "Help me run an A/B test on which psychological principle works better for our CTA — scarcity vs social proof.",
+      "expected_output": "Should recognize this is an A/B test setup task, not a psychology task. Should defer to or cross-reference the ab-test-setup skill for the experiment design. May provide psychological context on both principles to inform the hypothesis, but should make clear that ab-test-setup is the right skill for designing and running the experiment.",
+      "assertions": [
+        "Recognizes this as an A/B test setup task",
+        "References or defers to ab-test-setup skill",
+        "May provide psychological context for hypothesis",
+        "Does not attempt full test design using psychology patterns"
+      ],
+      "files": []
+    }
+  ]
+}

package/skills/marketing-psychology/references/case-studies.md

@@ -0,0 +1,148 @@
+# Psychology Case Studies
+
+Real examples of behavioral psychology principles applied to marketing assets. Each case study shows the principle, the context, the implementation, and why it worked.
+
+## Contents
+- Reciprocity: Hubspot's Free Tools Funnel
+- Commitment/Consistency: Duolingo's Streak System
+- Social Proof: Basecamp's Landing Page
+- Authority: Stripe's Documentation-as-Marketing
+- Liking: Mailchimp's Brand Voice
+- Scarcity: Superhuman's Waitlist
+- Loss Aversion: Netflix's Cancel Flow
+- Anchoring: Salesforce's Pricing Page
+- Endowment Effect: Notion's Free Tier
+- Framing: Apple's Storage Pricing
+- Status Quo Bias: Slack's Migration Strategy
+
+---
+
+## Reciprocity: HubSpot's Free Tools Funnel
+
+**Context:** HubSpot needed to attract SMB marketers who couldn't afford enterprise marketing software.
+
+**Implementation:** Built an entire suite of free tools — Website Grader, Email Signature Generator, Blog Ideas Generator, Invoice Template Generator. Each tool solves a real problem with zero signup required. After delivering value, HubSpot shows: "Want to do more? Here's how HubSpot can help."
+
+**Why it worked:** Each free tool creates an obligation loop. The user received genuine value — a website audit, a professional email signature — and now feels psychologically inclined to reciprocate. The paid product feels like a natural next step, not a cold pitch. HubSpot's free tools generate millions of leads annually.
+
+**Takeaway for agents:** When building lead magnets or free tools, the free offering must deliver REAL standalone value. A gated PDF that says "buy our product" isn't reciprocity — it's a bait-and-switch.
+
+---
+
+## Commitment/Consistency: Duolingo's Streak System
+
+**Context:** Language learning apps have notoriously high churn. Users download, try for a day, and never return.
+
+**Implementation:** Duolingo's streak counter tracks consecutive days of practice. After 3 days, the user sees "3-day streak!" After 30, they get a badge. The app sends push notifications: "Your 47-day streak is about to end!" Users who've invested weeks feel compelled to keep going.
+
+**Why it worked:** Each completed lesson is a micro-commitment. The streak counter makes the commitment visible and public (shareable). Once a user has a 30-day streak, quitting feels like throwing away 30 days of effort — consistency bias makes continuing feel inevitable. Duolingo's DAU/MAU ratio is among the highest of any app.
+
+**Takeaway for agents:** Build visible progress indicators into onboarding flows. Make the user's investment visible to them. The more they've put in, the harder it is to walk away.
+
+---
+
+## Social Proof: Basecamp's Landing Page
+
+**Context:** Basecamp competes against free tools (Trello, Asana free tier) and enterprise suites (Monday, Jira). They needed to justify charging a flat $99/month.
+
+**Implementation:** Their landing page leads with: "Since 2004, over 75,000 companies have switched to Basecamp." Below the fold, specific testimonials from named companies with job titles and photos. Each testimonial addresses a specific objection: "We tried 6 other tools before Basecamp" (comparison anxiety), "Our team actually uses it" (adoption fear), "Support is incredible" (risk reduction).
+
+**Why it worked:** The specific number (75,000) provides statistical social proof. Named testimonials from similar companies (peer social proof) address specific objections. The "switched to" framing implies other tools failed — Basecamp is where you end up.
+
+**Takeaway for agents:** Social proof should be specific (numbers, names, results) and address the target audience's actual objections. "Trusted by thousands" is weak. "75,000 companies switched after trying other tools" is strong.
+
+---
+
+## Authority: Stripe's Documentation-as-Marketing
+
+**Context:** Stripe needed to convince developers — a notoriously skeptical audience — to trust them with payment processing.
+
+**Implementation:** Stripe published the best API documentation in the industry. Their docs became a reference standard. They published engineering blog posts about distributed systems, created open-source tools, and sponsored developer conferences. The message was never "trust us" — it was "here's how we think about these problems."
+
+**Why it worked:** Developers don't respond to logos or testimonials. They respond to technical competence. By demonstrating deep engineering expertise publicly, Stripe established authority through proof of capability, not claims. "If their docs are this good, their product probably is too."
+
+**Takeaway for agents:** Authority signals must match the audience. For developers: technical depth. For executives: ROI data and case studies. For consumers: media mentions and celebrity endorsements. The wrong authority signal for the wrong audience falls flat.
+
+---
+
+## Liking: Mailchimp's Brand Voice
+
+**Context:** Email marketing is a commoditized space. Most platforms look and sound identical. Mailchimp needed to stand out.
+
+**Implementation:** Mailchimp adopted a warm, playful, slightly weird brand voice. Their chimp mascot high-fives you after sending a campaign. Error messages are funny. Their voice guide explicitly says: "We're serious about what we do, not about how we say it."
+
+**Why it worked:** The liking principle says people buy from brands they enjoy interacting with. Mailchimp's voice made a boring task (email marketing) feel fun. Users genuinely liked using the product, which increased retention and word-of-mouth. The brand became recognizable instantly.
+
+**Takeaway for agents:** When applying the liking principle, match the brand's personality. A playful brand can use humor and personality. A professional brand builds liking through competence and reliability. The principle is universal; the execution must be brand-specific.
+
+---
+
+## Scarcity: Superhuman's Waitlist
+
+**Context:** Superhuman launched a premium email client at $30/month — 10x more expensive than alternatives (which are mostly free).
+
+**Implementation:** Superhuman created an invite-only waitlist. Every new user got a personal 30-minute onboarding call. The waitlist grew to 300,000+. When someone finally got access, they'd been waiting months — the product felt precious.
+
+**Why it worked:** The scarcity was REAL — they genuinely couldn't onboard everyone at once due to the personal call requirement. This created legitimate exclusivity that made the $30/month price feel justified. Users who got access felt special and became evangelists. The constraint (1:1 onboarding) also meant every user was properly activated, reducing churn.
+
+**Takeaway for agents:** Effective scarcity must be genuine. Superhuman's waitlist worked because the constraint was real (capacity for personal onboarding). A waitlist for a product that can serve unlimited users is immediately transparent and damages trust.
+
+---
+
+## Loss Aversion: Netflix's Cancel Flow
+
+**Context:** Netflix needs to reduce voluntary churn while remaining ethical about cancellation (no dark patterns).
+
+**Implementation:** When a user clicks "Cancel," Netflix shows: "Your 3 profiles, 847 shows in your list, and personalized recommendations will be lost." It doesn't hide the cancel button — it just makes the cost of leaving viscerally clear. After cancellation, they follow up: "We've kept your profile for 10 months. Come back anytime."
+
+**Why it worked:** Loss aversion hits 2x harder than equivalent gains. Seeing "847 shows in your list" makes the user feel the weight of what they've curated. The 10-month retention of profile data reduces the perceived permanence of canceling (endowment effect preservation), making win-back easier.
+
+**Takeaway for agents:** In cancel flows, show users what they've BUILT, not what they'll MISS. "You'll lose your data" is abstract. "You have 3 active projects, 47 contacts, and 12 saved reports" is concrete and painful.
+
+---
+
+## Anchoring: Salesforce's Pricing Page
+
+**Context:** Salesforce needs to sell $25/user/month licenses to SMBs while also capturing $300/user/month enterprise deals.
+
+**Implementation:** Their pricing page shows Enterprise ($300) first, then Professional ($100), then Essentials ($25). The Enterprise price anchors perception so Professional feels reasonable and Essentials feels like a steal. They also anchor against the cost of NOT using CRM: "Sales teams without CRM lose 27% of deals to poor follow-up."
+
+**Why it worked:** Double anchoring — the high price tier makes lower tiers feel affordable, and the cost-of-inaction stat makes ALL tiers feel cheap compared to lost revenue. A $25/month tool that prevents even one lost deal per quarter has 10x+ ROI.
+
+**Takeaway for agents:** Always control two anchors: (1) the highest price option makes lower ones look reasonable, and (2) the cost of the problem makes your solution look like a bargain. Both anchors should be visible above the fold.
+
+---
+
+## Endowment Effect: Notion's Free Tier
+
+**Context:** Notion competes against free incumbents (Google Docs, Apple Notes) and needs to convert free users to $10/month paid.
+
+**Implementation:** Notion's free tier lets users create unlimited pages, build wikis, and organize their entire digital life. There's no sandbox — users build REAL workspaces with REAL content. The upgrade trigger is the 1,000 block limit — by the time a user hits it, they've invested days of work into their Notion setup.
+
+**Why it worked:** By the time users hit the limit, they own something valuable — a personal knowledge base they built block by block. Switching to another tool means losing all that work. The $10/month feels trivial compared to the value of what they've already created. This is the endowment effect: people overvalue what they already possess.
+
+**Takeaway for agents:** Free tiers should let users create real, invested work — not sandboxed demos. The more a user puts in, the more they value what they've built, and the lower the perceived cost of upgrading.
+
+---
+
+## Framing: Apple's Storage Pricing
+
+**Context:** Apple sells iCloud storage upgrades — a commodity product (cloud storage) at premium prices.
+
+**Implementation:** Apple frames storage tiers as: 5GB (free), 50GB ($0.99), 200GB ($2.99), 2TB ($9.99). The free tier is deliberately too small — your iPhone fills it in weeks. The upgrade prompt frames the cost as monthly, not annually ($0.99/month feels trivial; $11.88/year feels more considered). They also frame it as "your photos, your memories" — not "cloud storage."
+
+**Why it worked:** Framing the upgrade as $0.99/month (less than a coffee) makes it feel insignificant. Framing the content as "memories" rather than "files" raises the emotional stakes of NOT upgrading. The tiny free tier creates the problem that the paid tier solves — a manufactured but genuine constraint.
+
+**Takeaway for agents:** Frame prices in the smallest unit that feels trivial (per month, per day, per use). Frame the value in the most emotional unit possible (memories, not files; time saved, not features gained).
+
+---
+
+## Status Quo Bias: Slack's Migration Strategy
+
+**Context:** Slack needed to displace email — an entrenched behavior everyone already used — for team communication.
+
+**Implementation:** Slack didn't ask teams to abandon email. Instead, they said: "Keep using email for external communication. Use Slack for your team." They built email-to-Slack forwarding so nothing was lost. They integrated with every tool teams already used (Google Drive, Trello, GitHub). The message was: "Nothing changes except your team chat gets better."
+
+**Why it worked:** Status quo bias means people resist change, even when change is beneficial. By reducing the perceived change ("keep email, just add Slack"), Slack lowered the adoption barrier. Integrations with existing tools meant no workflow disruption. Teams didn't feel like they were switching — they felt like they were adding.
+
+**Takeaway for agents:** When displacing competitors, minimize perceived change. Integrations, data import, and "works with what you already use" messaging all leverage status quo bias by making the new thing feel like an extension of current behavior, not a replacement.