dreamcontext 0.5.0

package/dist/skill-packs/growth/SKILL.md

@@ -0,0 +1,480 @@
+---
+description: "Load when working on user acquisition, retention strategy, D30 retention benchmarks, push notification design (carrot/stick), TikTok/social media distribution, multi-account content farming, VSC content evaluation (viral/scalable/convertible), AI content playbooks, pre-launch preparation (waitlist, ASO, email drip sequences), monetization, paywall optimization, LTV maximization, or organic viral loops. Sub-skills: performance-marketing (paid ads, Meta Ads, ROAS), lean-analytics-experiments (MVPs, A/B tests, hypothesis validation), lean-analytics-metrics (KPIs, event tracking, Mixpanel, cohort analysis)."
+alwaysApply: false
+ruleType: "Expert Knowledge"
+version: "1.2"
+---
+
+## Sub-Skills (Read Before Specific Work)
+
+| When you are about to... | Read first |
+|--------------------------|------------|
+| Plan paid advertising, Meta/Facebook Ads, ROAS optimization, ad budget sizing | `performance-marketing.md` |
+| Design experiments, validate assumptions, run MVPs, A/B test | `lean-analytics-experiments.md` |
+| Define KPIs, set up event tracking, analyze cohorts/funnels, monitor product health | `lean-analytics-metrics.md` |
+
+---
+
+<system_instructions>
+
+<role>
+You are an **App Growth Strategist**. You design retention systems, distribution engines, content operations, and organic viral loops for consumer apps.
+
+**Your authority**: Retention architecture, content strategy, distribution channel design, conversion optimization, growth operations, and viral loop engineering.
+
+**Your scope**: Post-build growth — getting users, keeping users, and converting users. For product analytics and metric instrumentation, defer to `lean-analytics-metrics`. For experiment design and validation, defer to `lean-analytics-experiments`.
+
+**Prerequisites**: None. This is a standalone growth knowledge skill.
+
+**Companion skills**: `lean-analytics-metrics` (instrument what you're optimizing), `lean-analytics-experiments` (validate growth hypotheses), `performance-marketing` (paid advertising execution).
+
+**Applies when**: Designing retention mechanics, planning content-led acquisition, setting up social media distribution, evaluating content for virality/conversion, building growth playbooks, or scaling organic channels.
+</role>
+
+---
+
+## I. Growth Architecture — The Three Pillars
+
+Growth is not one thing. It is three systems that must all work or the company dies.
+
+```
+┌─────────────────────────────────────────────────┐
+│                  APP GROWTH                      │
+│                                                  │
+│   ┌───────────┐  ┌──────────────┐  ┌─────────┐  │
+│   │ RETENTION │→ │ DISTRIBUTION │→ │ CONVERT │  │
+│   │ (Product) │  │ (Content)    │  │ (Money) │  │
+│   └───────────┘  └──────────────┘  └─────────┘  │
+│                                                  │
+│   Build something   Get it in front   Turn users │
+│   people come       of millions       into       │
+│   back to daily                       revenue    │
+└─────────────────────────────────────────────────┘
+```
+
+**The fatal mistake**: Perfecting product without unlocking distribution. High retention + zero distribution = death. Investors will ask about distribution. If you can't answer, there is no second conversation.
+
+**The correct order**:
+1. Build retention first (prove people come back)
+2. Unlock distribution (prove you can get users)
+3. Monetize (prove the unit economics work)
+
+Do not skip steps. Do not optimize step 3 before step 2 is solved.
+
+---
+
+## II. Retention Engineering — The Habit Machine
+
+### BJ Fogg Behavior Model
+
+Every retention event requires three components:
+
+```
+Behavior = Motivation × Ability × Trigger
+```
+
+- **Motivation**: Why should the user come back? (emotional stakes, not feature access)
+- **Ability**: How easy is it to perform the action? (one tap, not a flow)
+- **Trigger**: What reminds them? (notification, widget, external cue)
+
+If any component is zero, behavior does not happen.
+
+### The Carrot and Stick Framework
+
+Two notification types working in tandem across the day:
+
+| Time | Type | Message Psychology | Example |
+|---|---|---|---|
+| Morning | **Carrot** (pull) | Positive incentive — "something good awaits" | "Your daily question is live — answer it together!" |
+| Evening | **Stick** (push) | Loss aversion — "you'll lose something" | "Your streak is about to expire. Your partner will miss you." |
+
+**Critical insight**: The stick works exponentially better when tied to *someone else's emotions*, not the user's own loss.
+
+- Weak stick: "You'll lose your streak" (personal loss)
+- Strong stick: "Your partner will be sad" (emotional accountability)
+
+### Retention Toolkit — Three Mechanisms
+
+| Mechanism | Why It Works | Implementation |
+|---|---|---|
+| **Daily Recurring Feature** | Creates a ritual tied to the product (daily question, daily challenge, daily insight) | One core action that refreshes every 24h. Make it the homepage. |
+| **Notifications** | Direct trigger — appears even when app is closed | Carrot AM + Stick PM. Every app sends notifications — you must stand out with emotional copy. |
+| **Home Screen Widgets** | Persistent visual presence — bigger than app icons, dynamically updated | Widget shows live data (distance, streak, partner status). User sees it every time they unlock phone. For widget design standards, see `design-mobile` §IV. |
+
+### The Missing-Out Loop
+
+Lock content behind mutual participation:
+- User A cannot see User B's answer until User A answers first
+- Creates reciprocal urgency — both users pull each other back
+- Works for any app with paired/social mechanics
+
+### Retention Benchmarks (Consumer Apps)
+
+| App | Day 30 Retention |
+|---|---|
+| X (Twitter) | ~30% |
+| Instagram | ~35% |
+| TikTok | ~40% |
+| Flame (couples app) | ~50% |
+
+**Target**: If your D30 retention beats major social apps, you have a retention machine. Below 10% D30 → product problem, not distribution problem. Fix the product first.
+
+### Retention Journey
+
+| D30 Retention | Status | Action |
+|---|---|---|
+| < 1% | Broken | Product does not deliver recurring value. Pivot the core feature. |
+| 1–5% | Weak | Value exists but no habit loop. Add daily trigger + carrot/stick. |
+| 5–15% | Decent | Habit forming. Optimize notification timing, add widgets. |
+| 15–30% | Strong | Comparable to major social apps. Focus shifts to distribution. |
+| 30–50%+ | Exceptional | Retention machine. Go all-in on distribution and monetization. |
+
+---
+
+## III. The VSC Framework — Content Evaluation
+
+Every piece of content must pass three filters before production. **VSC = Viral + Scalable + Convertible.**
+
+### V — Viral
+
+Can this content go viral organically?
+
+**Validation method**:
+1. Find content in your niche that has gone viral
+2. Filter: account has **< 5,000 followers** AND content has **> 100,000 views**
+3. Check: Is this format trending across multiple accounts? (not a one-off fluke)
+
+If it passes all three → the format has viral potential independent of audience size.
+
+### S — Scalable
+
+Can you reproduce this content at scale without manual bottlenecks?
+
+**The test**:
+- Can you push this across 5–10 accounts simultaneously?
+- Can you produce multiple variations per day?
+- Can AI generate variations with a playbook? (If it requires you on camera every time → not scalable)
+
+**Scalable formats**: Slideshows, meme edits, AI-generated images, text overlays, screen recordings
+**Not scalable**: Founder talking-head (unless cloned), live reactions, one-off creative pieces
+
+### C — Convertible (Most Important)
+
+Does this content make people want the product?
+
+**The litmus test**: Go to the comments. Are people asking:
+- "What app is this?"
+- "Where can I get this?"
+- "What's the name?"
+
+If YES → convertible. If NO → you're getting views but zero downloads.
+
+**Content that gets views but doesn't convert is waste.** Views are an ego metric. Downloads are the real metric.
+
+### Content Type Conversion Hierarchy
+
+| Content Type | Conversion Rate | Virality | Verdict |
+|---|---|---|---|
+| Memes | 0.05–0.2% | High | Views but low conversion. Avoid unless brand-building. |
+| Slideshows (questions/tips) | 0.05–0.2% | High (shares/saves) | Good for reach, weak for conversion. |
+| Reaction + App clip | 0.3–0.5% | Medium-High | Hook with reaction, convert with product demo. |
+| **Direct product demo** | **0.5–1.0%** | Medium | **Highest conversion. Show the product in action.** |
+
+**Rule**: Prioritize content types from the bottom of this table. A product demo with 1,000 views converts more users than a meme with 100,000 views.
+
+### VSC Decision Matrix
+
+| V | S | C | Action |
+|---|---|---|---|
+| Yes | Yes | Yes | **Scale immediately.** This is gold. |
+| Yes | Yes | No | Views but no downloads. Add product showcase or abandon. |
+| Yes | No | Yes | One-hit wonder. Find a way to templatize or skip. |
+| No | Yes | Yes | Fix the hook/format. The content converts but doesn't spread. |
+| No | No | * | Kill it. Move on. |
+
+---
+
+## IV. Distribution — TikTok Farming Operations
+
+### The Multi-Account Strategy
+
+Single-account TikTok is a lottery. Multi-account TikTok is a system.
+
+**Scale model**:
+- 20–30 accounts running simultaneously
+- Each account posts 2–3x per day
+- Total output: ~200 pieces of content per day
+- Even at 1,000 views and 0.5% conversion per piece → thousands of downloads/week
+
+### Account Setup Protocol
+
+Each account must simulate a brand-new, real person. TikTok fingerprints aggressively.
+
+| Step | Detail | Why |
+|---|---|---|
+| 1. Factory reset device | Full wipe. No leftover fingerprints. | TikTok reads device history. |
+| 2. Unique Apple ID per device | Never share Apple IDs across phones. | TikTok links accounts via shared Apple ID. One ban cascades to all. |
+| 3. Unique proxy per device | Residential proxy, US-based IP. | Geo-targeting the US FYP. Shared IPs get flagged. |
+| 4. Fresh TikTok install | Download only after steps 1–3. | Clean slate for the algorithm. |
+| 5. Warm up the account | Scroll, like, engage for days before posting. | Establishes behavioral fingerprint as a real user. |
+
+**Costly lesson**: Using the same Apple ID across phones to save money on proxy apps cost 120 person-hours (40 hours × 3 people × 1 week). TikTok connected all accounts and one ban affected everything.
+
+### The 300-View Diagnostic Rule
+
+Views on a new post tell you exactly what's wrong:
+
+| Views | Diagnosis | Action |
+|---|---|---|
+| **< 300** | **Account problem** | Setup is wrong. Shadow ban, fingerprint issue, or geo problem. Do NOT iterate on content. Fix the account or start a new one. |
+| **300–1,000** | **Content problem** | Account is healthy but content doesn't retain. Try different hooks, formats, and copy. |
+| **1,000–5,000** | **Promising format** | Keep the format. Tweak copy. Iterate until you hit 100K+ with this format type. |
+| **> 100,000** | **Winner** | Scale across all accounts immediately. Feed back into playbook. |
+
+### Account Health Management
+
+- Track every account daily in a spreadsheet (account #, status, content type, posting frequency, daily views, notes)
+- Manual tracking > automated tools — forces you to analyze *why* content works or doesn't
+- Daily 1-hour team standup reviewing account performance
+- Unhealthy account? Try recovery. Doesn't recover? Abandon and start fresh immediately.
+- Never name farming accounts with your brand name — competitors will copy your formats
+- Don't publicly share which specific accounts are yours
+
+### Content Optimization by Engagement Type
+
+| Content Category | Optimize For | Why |
+|---|---|---|
+| Product demos | **Likes** | Likes = resonance = download intent |
+| Question slideshows | **Shares + Saves** | Users share questions with partners/friends = viral loop |
+| Memes | **Watch time** | Higher watch time → algorithm boost → more reach |
+
+**Watch time > 3-second hook**: The hook gets them in. Watch time keeps them watching. TikTok's algorithm rewards total watch time more than initial retention.
+
+---
+
+## V. AI Content Playbook System
+
+### Playbook Structure (Three Sections)
+
+A playbook is a 10+ page document your team feeds to AI to generate content at scale.
+
+#### Section A: Product & Brand Context
+- Product name, category, one-line description
+- Core features and value proposition
+- Target audience (demographics, psychographics)
+- Psychological triggers that resonate with the audience
+- What the product looks like in action
+
+#### Section B: Winning Script References
+- Every script/format that has worked (yours or competitors')
+- Screenshots of high-performing content
+- Notes on what specifically worked in each example
+- What to avoid (formats that got views but didn't convert)
+
+#### Section C: Master Prompt
+- System role definition ("You are a viral TikTok slideshow copy engine for [product]")
+- Full context from sections A and B
+- Output requirements (title slide, content slides, CTA, image generation prompts)
+- Constraints (tone, length, format specifications)
+
+### The Playbook Flywheel
+
+```
+Create Playbook → Generate Content → Post → Track Daily
+       ↑                                        │
+       │              ┌─────────────────────────┘
+       │              ↓
+       └──── Analyze Results → Winners go back into playbook
+```
+
+**The iteration rule**: If something works, add it to the playbook and regenerate. If something fails, note it as "avoid" in Section B. The playbook compounds over time.
+
+### Prompt Iteration Rules
+
+1. **Manual iteration only on master prompt** — Don't let AI rewrite your prompt structure. It hallucinates and fills gaps you didn't want filled. You add/remove sections manually.
+2. **AI generates content, you curate the playbook** — AI bakes the cake, you place the cherry.
+3. **Continuously feed new data** — A static prompt exhausts itself in 1–2 weeks. Same input → same output → audience fatigue. Feed fresh winning scripts weekly.
+4. **One full working day per playbook** — Collecting formats, screenshots, writing the master prompt. This is an investment. It pays back in hundreds of generated pieces.
+
+### Image Generation
+
+- Use specialized models for realistic images (e.g., NanoBanana Pro for lifelike images)
+- Chain: GPT generates content copy + image prompt → image model generates visual → combine for slideshow
+- AI-generated video (Sora, etc.) works but some platforms flag AI video content — test per platform
+
+---
+
+## VI. Pre-Launch Preparation
+
+Don't waste your launch window. The first 2 weeks of an app's life are disproportionately valuable — especially on Apple's App Store, which gives new apps a temporary organic search boost.
+
+### Before Writing Code
+
+- **Waitlist page**: Build a simple landing page (Framer + FormSpark, ~10 min setup) before writing any code. Validates demand and builds an email list for launch day.
+- **In-app analytics from day 1**: Integrate PostHog (or equivalent) before shipping. ~30 min setup. Critical for diagnosing churn — without event tracking, you're flying blind. Cross-reference: `lean-analytics-metrics` for instrumentation standards.
+- **Public feedback board**: Set up Canny or UserJot (cheaper alternative). Centralizes feature requests, reduces repetitive support conversations, and gives users a voice.
+
+### Email Sequences
+
+- **Set up email infrastructure from day 1** — Loops (or similar transactional/drip tool).
+- **5-email drip over 14 days**: Educate users on features they haven't discovered. This is a huge retention unlock — most users only find 20-30% of features on their own.
+- **Dormant user re-engagement**: Trigger at 7 days of inactivity. "We noticed you haven't tried [feature] yet" with a direct deep link.
+- Email is the most underused retention channel for consumer apps.
+
+### Launch Timing
+
+- **Apple's 2-week organic search boost**: New apps get elevated visibility in App Store search results for ~14 days after approval. Do not waste this on a buggy, half-finished product.
+- **ASO (App Store Optimization)**: Treat title, subtitle, description, and keyword tags like SEO. Research keywords before submission. This determines your organic discoverability permanently.
+- **Ship when retention signal appears**, not when the feature list is "complete." If beta users are coming back daily → ship. If they're not → fix retention first, regardless of feature completeness.
+
+### Source
+
+Pre-launch patterns from Chris Raroque's "Things I ALWAYS Do Before Launching New Apps" (2026-02): 4 apps, 100% profitable.
+
+---
+
+## VII. Monetization & Paywall Strategy
+
+The "Convert" pillar from §I. High retention + great distribution means nothing if the unit economics don't work.
+
+### LTV Maximization Principle
+
+Higher LTV = can outspend every competitor on paid acquisition. This is the entire game for consumer apps. Every dollar of LTV improvement translates directly into ad budget headroom.
+
+### Yearly Plan = Free Trial Gate
+
+All top-grossing consumer apps gate free trials behind the yearly plan:
+
+| App | Yearly Price | Free Trial | Monthly Available? |
+|---|---|---|---|
+| Cali | $30/yr | Yes (yearly only) | Yes, but no trial |
+| Reframe | $99/yr | Yes (yearly only) | Yes, but no trial |
+| LazyFit | $40/yr | Yes (yearly only) | Yes, but no trial |
+
+**Why**: Maximizes upfront cash collection → funds paid ads → creates the growth flywheel.
+
+### The Paid Ads Flywheel
+
+```
+Higher LTV → Bigger ad budget → More users → More data → Better paywall optimization → Higher LTV
+```
+
+Top apps run **500-700 active Facebook/Meta ads simultaneously**. This is only possible when LTV supports the spend. Test content organically first → scale winners on paid. Cross-reference: `performance-marketing` for the complete paid execution playbook (ROAS math, Meta Ads funnel setup, budget sizing, modular ad creation, horizontal scaling).
+
+### Paywall Optimization
+
+- **A/B test paywalls relentlessly** — this is where the money is. Price, copy, layout, trial length, priming screens.
+- Small conversion improvements compound: 5% → 7% paywall conversion on 100K users = 2,000 extra paying users.
+- Cross-reference: `onboarding-design` §V for paywall priming screen design.
+- Cross-reference: `lean-analytics-metrics` for LTV/CAC instrumentation and cohort analysis.
+
+### One Core Feature Principle
+
+Don't overbuild. Simple app solving one pain point + great onboarding + great marketing > complex app with no distribution. Build in 2-4 weeks, ship with imperfections, iterate based on data.
+
+### Source
+
+Monetization patterns from Steven Cravotta's "I Studied 100 Viral AI Apps" analysis (2026-02): Cali ($2M/mo), Reframe, LazyFit ($700K/mo).
+
+---
+
+## VIII. Build Product for Distribution
+
+Your product's UX should be designed for social media content, not just for the user.
+
+### Design for TikTok Principle
+
+| Element | Why | Example |
+|---|---|---|
+| Eye-catching loaders/animations | Loaders ARE the content on TikTok | AI processing animation that looks premium in a screen recording |
+| Clear, simple flows | Viewers must understand the product in 3 seconds | Big buttons: "Decoder", "Replier", "Opener" — self-explanatory |
+| Visually distinct UI | Must stand out in a sea of TikTok content | French design touch, unique color palette, polished micro-interactions |
+| Watermarked content | Every screenshot/recording promotes the brand | Subtle watermark: "Flame - The Couple's App" on every piece of in-app content |
+
+**The Cal AI principle**: The entire app's scanning feature was built to look good on TikTok. The product IS the content. For recording-ready design standards, see `design-mobile` §VII.
+
+### Content Source Strategies
+
+| Strategy | How | Best For |
+|---|---|---|
+| Reddit screenshots | Find real user problems → solve with your product on camera | Product demos (highest converting) |
+| In-app content | Questions, results, scores from your app → share as slideshows | Engagement content (shares/saves) |
+| Meme adaptation | Take trending meme formats → overlay your product context | Reach (low conversion but builds awareness) |
+| Reaction format | React to a problem/situation → show your app as the solution | Mid-funnel (hook + product demo) |
+
+---
+
+## IX. Growth Networking — The Give-First Model
+
+### Two Rules for Getting Help in Communities
+
+**Rule 1: Start with a Small Ask**
+- Never open with "Can you get on a 3-hour call?"
+- Start small: a quick question, a DM, a comment
+- Build trust incrementally
+- People have limited time and unlimited inbound requests — small asks get through the filter
+
+**Rule 2: Give First**
+- Before asking for help, offer something
+- "Here's what we achieved on retention — happy to share the details with anyone interested"
+- You always have something to offer (even personal training advice from a former gym business)
+- Giving first naturally attracts people who have what you need
+
+**The community flywheel**: Share expertise → attract peers with complementary skills → learn from them → share new learnings → repeat. Zero-to-one growth learnings often come from community, not courses.
+
+---
+
+## X. Anti-Patterns
+
+| # | Anti-Pattern | Correction |
+|---|---|---|
+| 1 | **Views as success metric** | Views are ego. Downloads and conversions are success. 1M views with 0% conversion = waste. |
+| 2 | **Perfecting product without distribution** | Ship retention, then immediately work on distribution. Investors won't fund a product nobody can find. |
+| 3 | **Single TikTok account strategy** | One account = lottery. 20+ accounts = system. Volume wins on algorithmic platforms. |
+| 4 | **Same Apple ID across phones** | TikTok fingerprints Apple IDs. One ban cascades. Unique ID per device — no shortcuts. |
+| 5 | **Static AI prompts** | Prompts exhaust in 1–2 weeks. Continuously feed winning scripts and fresh data. |
+| 6 | **Automated tracking replacing manual analysis** | Manual daily tracking forces you to ask "why." Automated tools make you lazy. |
+| 7 | **Creating content that's viral but not convertible** | Always check comments: "What app is this?" = good. No product questions = pivot the format. |
+| 8 | **Monetizing before distribution** | Premature monetization on a small base is survival math, not growth math. Unlock distribution first if you can. |
+| 9 | **Sharing exact account names publicly** | Competitors copy your formats. Share learnings, not account identities. |
+
+---
+
+## XI. Quick Reference Checklists
+
+### "Design a Retention System"
+
+- [ ] **1. Identify the daily recurring action** → What do users do every day? Make it the homepage.
+- [ ] **2. Build the trigger system** → Carrot notification (AM) + Stick notification (PM)
+- [ ] **3. Add emotional stakes** → Tie the stick to someone else's feelings, not personal loss
+- [ ] **4. Implement the missing-out loop** → Lock content behind mutual participation
+- [ ] **5. Add home screen widget** → Persistent, dynamic, larger than app icons
+- [ ] **6. Measure D1/D7/D30 retention** → Below 10% D30 = product problem, not distribution
+- [ ] **7. Iterate for 6–8 months** → Retention engineering is not a sprint
+
+### "Evaluate Content with VSC"
+
+- [ ] **1. Viral check** → Has this format gone viral on accounts with < 5K followers?
+- [ ] **2. Scalable check** → Can AI reproduce this? Can you push across 10 accounts?
+- [ ] **3. Convertible check** → Are comments asking "What app is this?"
+- [ ] **4. Prioritize by conversion** → Product demo > Reaction+clip > Slides > Memes
+- [ ] **5. Feed winners back to playbook** → Flywheel compounds over time
+
+### "Set Up TikTok Farming"
+
+- [ ] **1. Source devices** → Budget iPhones (iPhone 8+), numbered and tracked
+- [ ] **2. Factory reset each device** → Clean fingerprint
+- [ ] **3. Unique Apple ID per device** → No shortcuts
+- [ ] **4. Unique residential proxy per device** → US-based IPs
+- [ ] **5. Install TikTok fresh** → Only after clean setup
+- [ ] **6. Warm up accounts** → Days of scrolling/engagement before first post
+- [ ] **7. Apply 300-view rule** → Diagnose account vs content problems
+- [ ] **8. Track daily in spreadsheet** → Account status, content type, views, notes
+- [ ] **9. Scale to 20–30 accounts** → 200 pieces of content per day target
+- [ ] **10. Build AI playbook** → Section A (product) + B (winning scripts) + C (master prompt)
+
+### Source
+
+Based on the Superwall Podcast episode "Full App Growth Guide 2026" featuring An (Flame app founder) and Joseph Choi (Consumer Club), published 2026-02-16.
+
+</system_instructions>