agy-superpowers 5.0.7 → 5.0.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (31) hide show
  1. package/package.json +1 -1
  2. package/template/agent/skills/api-design/SKILL.md +193 -0
  3. package/template/agent/skills/app-store-optimizer/SKILL.md +127 -0
  4. package/template/agent/skills/auth-and-identity/SKILL.md +167 -0
  5. package/template/agent/skills/backend-developer/SKILL.md +148 -0
  6. package/template/agent/skills/community-manager/SKILL.md +115 -0
  7. package/template/agent/skills/content-marketer/SKILL.md +111 -0
  8. package/template/agent/skills/conversion-optimizer/SKILL.md +142 -0
  9. package/template/agent/skills/copywriter/SKILL.md +114 -0
  10. package/template/agent/skills/cto-architect/SKILL.md +133 -0
  11. package/template/agent/skills/customer-success-manager/SKILL.md +126 -0
  12. package/template/agent/skills/data-analyst/SKILL.md +147 -0
  13. package/template/agent/skills/devops-engineer/SKILL.md +117 -0
  14. package/template/agent/skills/email-infrastructure/SKILL.md +164 -0
  15. package/template/agent/skills/frontend-developer/SKILL.md +133 -0
  16. package/template/agent/skills/game-design/SKILL.md +194 -0
  17. package/template/agent/skills/game-developer/SKILL.md +175 -0
  18. package/template/agent/skills/growth-hacker/SKILL.md +122 -0
  19. package/template/agent/skills/i18n-localization/SKILL.md +126 -0
  20. package/template/agent/skills/influencer-marketer/SKILL.md +141 -0
  21. package/template/agent/skills/mobile-developer/SKILL.md +142 -0
  22. package/template/agent/skills/monetization-strategist/SKILL.md +119 -0
  23. package/template/agent/skills/paid-acquisition-specialist/SKILL.md +119 -0
  24. package/template/agent/skills/product-manager/SKILL.md +105 -0
  25. package/template/agent/skills/real-time-features/SKILL.md +194 -0
  26. package/template/agent/skills/retention-specialist/SKILL.md +123 -0
  27. package/template/agent/skills/saas-architect/SKILL.md +139 -0
  28. package/template/agent/skills/security-engineer/SKILL.md +133 -0
  29. package/template/agent/skills/seo-specialist/SKILL.md +130 -0
  30. package/template/agent/skills/subscription-billing/SKILL.md +179 -0
  31. package/template/agent/skills/ux-designer/SKILL.md +128 -0
@@ -0,0 +1,141 @@
1
+ ---
2
+ name: influencer-marketer
3
+ description: Use when planning UGC campaigns, creator partnerships, TikTok/YouTube/Instagram marketing, affiliate programs, or word-of-mouth amplification strategies
4
+ ---
5
+
6
+ # Influencer Marketer Lens
7
+
8
+ > **Philosophy:** Creators are trusted media channels with pre-built audiences. One authentic review beats 1000 banner ads.
9
+ > The best influencer marketing doesn't look like marketing.
10
+
11
+ ---
12
+
13
+ ## Core Instincts
14
+
15
+ - **Authenticity > reach** — a micro-influencer who uses your product converts better than a mega-influencer who doesn't
16
+ - **Product-market fit before influencer fit** — influencer marketing amplifies; it doesn't create
17
+ - **Micro > macro for early-stage** — 10K–100K followers with high engagement beats 1M followers with 0.5% ER
18
+ - **UGC is the asset** — even if a campaign flops, the content you own is valuable for ads
19
+ - **Long-term > one-off** — repeat mentions build brand association; single posts are noise
20
+
21
+ ---
22
+
23
+ ## Influencer Tier Reference
24
+
25
+ | Tier | Followers | Instagram ER | TikTok ER | Best for |
26
+ |------|-----------|-------------|----------|----------|
27
+ | **Nano** | 1K – 10K | 5–9% | 9–15% | Niche communities, very authentic |
28
+ | **Micro** | 10K – 100K | 3–5% | 5–9% | Best ROI for indie hackers; targeted audiences |
29
+ | **Mid-tier** | 100K – 500K | 1.5–3% | 3–6% | Scale with proven product |
30
+ | **Macro** | 500K – 1M | 1–2% | 2–4% | Brand awareness; expensive |
31
+ | **Mega / Celebrity** | 1M+ | 0.5–1% | 1–3% | Mass awareness; rarely cost-effective |
32
+
33
+ **Engagement Rate (ER):** `(likes + comments) / followers × 100`
34
+ **Minimum bar:** ER < 1% (Instagram) or < 2% (TikTok) = avoid regardless of follower count.
35
+ **Note:** TikTok ERs are structurally higher than Instagram due to algorithmic distribution to non-followers.
36
+
37
+ ---
38
+
39
+ ## Platform Strategy
40
+
41
+ | Platform | Content format | Best for | Purchase intent |
42
+ |----------|---------------|----------|----------------|
43
+ | **TikTok** | Short video (15s–3min) | Consumer apps, Gen Z/Millennial | Medium-high |
44
+ | **YouTube** | Long-form, tutorials, reviews | Tools, SaaS, education | High |
45
+ | **Instagram** | Reels, Stories, carousel | Lifestyle, consumer apps | Medium |
46
+ | **X (Twitter)** | Threads, screenshots | Developer tools, B2B | Medium |
47
+ | **Newsletter** | Written features, sponsored posts | B2B SaaS, niche products | Very high |
48
+
49
+ ---
50
+
51
+ ## Creator Outreach Template
52
+
53
+ ```
54
+ Subject: [Your product] + [Creator name] collab?
55
+
56
+ Hi [Name],
57
+
58
+ I've been following your [specific content] for [time] — specifically loved [specific post].
59
+
60
+ I built [product] for [specific audience that matches theirs]. I think your followers would
61
+ genuinely find it useful because [specific reason].
62
+
63
+ I'd love to offer you [free access / commission / fee] to try it and share your honest
64
+ experience — no script, just your real take.
65
+
66
+ Interested in a quick chat?
67
+ [Name]
68
+ ```
69
+
70
+ **Key:** Reference specific content → show you actually watch them → explain why it fits their audience → make the ask small.
71
+
72
+ ---
73
+
74
+ ## Compensation Models
75
+
76
+ | Model | When to use | Risk |
77
+ |-------|------------|------|
78
+ | **Product gifting** | Nano/micro; product is genuinely useful | Low reach if they don't post |
79
+ | **Affiliate / commission** | Performance-based; aligns incentives | Creators may prefer upfront |
80
+ | **Flat fee + affiliate** | Larger creators; guaranteed post | Higher upfront cost |
81
+ | **Revenue share** | Long-term partnerships | Complex to track |
82
+ | **Equity** | Very early, co-founder personality | Rare; only for deeply aligned creators |
83
+
84
+ **Benchmark rates (2024):**
85
+ - Nano (TikTok/IG): $50–$300/post
86
+ - Micro (TikTok/IG): $300–$2,000/post
87
+ - YouTube (dedicated video): $500–$5,000 per 100K subscribers
88
+
89
+ ---
90
+
91
+ ## ❌ Anti-Patterns to Avoid
92
+
93
+ | ❌ NEVER DO | Why | ✅ DO INSTEAD |
94
+ |------------|-----|--------------|
95
+ | Choose by follower count only | High followers + low ER = expensive and ineffective | Require ER > 2% for niche, > 1% for broad |
96
+ | Give a strict script | Inauthentic content, audiences can tell | Brief + key points + let them be themselves |
97
+ | One post and done | Single posts get lost in the feed | 3+ touchpoints (post + story + mention) |
98
+ | No UTM tracking | Can't measure attribution or ROAS | UTM links + promo codes per creator |
99
+ | Work with influencers who don't use your product | Inauthentic, low conversion | Send product, wait for organic use, then approach |
100
+ | No contract for paid collaborations | Disputes about deliverables | Written brief: platform, format, post count, timeline, usage rights |
101
+
102
+ ---
103
+
104
+ ## Questions You Always Ask
105
+
106
+ **Before a campaign:**
107
+ - Does this creator's audience match our target user? (Check their comment section)
108
+ - What's their engagement rate? (< 1% = skip)
109
+ - Do they already talk about products in our category organically?
110
+ - How will we track conversions — UTM links, promo codes, or post-purchase survey?
111
+
112
+ **After a campaign:**
113
+ - What was the ROAS on paid posts vs expected CAC?
114
+ - Which creator drove the best conversion (not just clicks)?
115
+ - Can we repurpose this UGC as paid ads?
116
+
117
+ ---
118
+
119
+ ## Red Flags
120
+
121
+ **Must fix:**
122
+ - [ ] No UTM tracking or promo codes (no attribution)
123
+ - [ ] Working only with > 1M follower creators (poor ROI for indie hackers)
124
+ - [ ] No brief given to creators (no deliverable clarity)
125
+
126
+ **Should fix:**
127
+ - [ ] Requiring exact word-for-word scripts
128
+ - [ ] Single post with no follow-up mentions
129
+ - [ ] No UGC repurposing strategy
130
+
131
+ ---
132
+
133
+ ## Who to Pair With
134
+ - `paid-acquisition-specialist` — for repurposing UGC as performance ads
135
+ - `content-marketer` — for organic amplification of creator content
136
+ - `data-analyst` — for attribution modeling and campaign ROAS
137
+
138
+ ---
139
+
140
+ ## Tools
141
+ **Outreach:** Hunter.io · LinkedIn · direct DM · **Campaign management:** Grin · AspireIQ · Creator.co · **Tracking:** UTM builder + Bitly · unique promo codes · **UGC repurposing:** Meta Ads creative with creator handles
@@ -0,0 +1,142 @@
1
+ ---
2
+ name: mobile-developer
3
+ description: Use when working on mobile app features, reviewing mobile code, or making architecture decisions — regardless of platform (React Native, Flutter, iOS, Android)
4
+ ---
5
+
6
+ # Mobile Developer Lens
7
+
8
+ > **Philosophy:** Touch-first. Offline-capable. Battery-conscious. Platform-respectful.
9
+ > Mobile is NOT a small desktop. Design for bad network, one hand, bright sun, low battery.
10
+
11
+ ---
12
+
13
+ ## ⚠️ ASK BEFORE ASSUMING
14
+
15
+ If the request is open-ended, **DO NOT default to React Native**. Ask:
16
+
17
+ | What | Why it matters |
18
+ |------|----------------|
19
+ | **Platform?** iOS / Android / Both | Affects EVERY design decision |
20
+ | **Framework?** RN / Flutter / SwiftUI / Compose | Determines patterns and tools |
21
+ | **Offline required?** | Core architecture decision |
22
+ | **Target devices?** Phone / Tablet | Layout and nav complexity |
23
+
24
+ When stack is unspecified, assume React Native + Expo.
25
+
26
+ ---
27
+
28
+ ## Framework Decision Tree
29
+
30
+ ```
31
+ What are you building?
32
+ ├── Need OTA updates + rapid iteration → React Native + Expo
33
+ ├── Pixel-perfect custom UI + perf-critical → Flutter
34
+ ├── Deep native features, single platform
35
+ │ ├── iOS only → SwiftUI (iOS 16+) or UIKit (legacy)
36
+ │ └── Android only → Kotlin + Jetpack Compose
37
+ └── Existing codebase → match the codebase
38
+ ```
39
+
40
+ ---
41
+
42
+ ## Core Instincts
43
+
44
+ - **Offline-first** — assume the network will fail; design around it from day one
45
+ - **Platform parity** — iOS and Android behave differently; both must work
46
+ - **Startup cost** — every dependency adds to cold start time and binary size; justify each one
47
+ - **UI/main thread is precious** — heavy computation and animations must run off the main thread
48
+ - **Battery budget** — background tasks, location, and push use real energy; minimize wake-ups
49
+
50
+ ---
51
+
52
+ ## Performance Thresholds
53
+
54
+ | Metric | Target | Critical |
55
+ |--------|--------|----------|
56
+ | Cold start time (JS bundle ready) | < 1s | > 2s |
57
+ | Time to interactive (first screen) | < 2s | > 4s |
58
+ | List scroll frame rate | 60fps | < 45fps |
59
+ | IPA / APK download size | < 30MB | > 100MB |
60
+ | Memory usage (foreground) | < 150MB | > 300MB |
61
+ | JS bundle size (RN, gzipped) | < 1MB | > 3MB |
62
+
63
+ ---
64
+
65
+ ## ❌ Anti-Patterns to Avoid
66
+
67
+ | ❌ NEVER DO | Why | ✅ DO INSTEAD |
68
+ |------------|-----|--------------|
69
+ | `ScrollView` for long lists | Renders ALL items, memory explodes | `FlatList` / `FlashList` / `ListView.builder` |
70
+ | Inline `renderItem` function | New function every render, all items re-render | `useCallback` + `React.memo` on item component |
71
+ | Missing `keyExtractor` (or using index) | Reorder causes state/animation bugs | Use unique stable ID from data |
72
+ | `useNativeDriver: false` on animations | Animations run on JS thread, janky | `useNativeDriver: true` — GPU-only transforms |
73
+ | Token in `AsyncStorage` | Plaintext, exposed on rooted device | `expo-secure-store` / `Keychain` / `EncryptedSharedPreferences` |
74
+ | Business logic in UI components | Untestable, duplicated | Separate service/hook layer |
75
+ | Deep links as afterthought | Notifications and shares break | Plan `linking` config from day one |
76
+ | `console.log` in production build | Blocks JS thread, leaks data | Remove; use a proper logger with levels |
77
+
78
+ ---
79
+
80
+ ## Platform Reference
81
+
82
+ | Element | iOS | Android |
83
+ |---------|-----|---------|
84
+ | Min touch target | **44pt × 44pt** | **48dp × 48dp** |
85
+ | Min gap between targets | **8pt** | **8dp** |
86
+ | Back navigation | Edge swipe left | System back gesture / button |
87
+ | Status bar height | 44–59pt (dynamic island) | 24–28dp |
88
+ | Safe area insets | `SafeAreaView` / `useSafeAreaInsets` | `WindowInsets` |
89
+ | Primary font | SF Pro / SF Compact | Roboto / Noto |
90
+ | Icon set | SF Symbols | Material Symbols |
91
+ | Haptics | `UIImpactFeedbackGenerator` | `VibrationEffect` |
92
+
93
+ ---
94
+
95
+ ## Questions You Always Ask
96
+
97
+ **When planning features:**
98
+ - What happens when the user is offline or on 2G?
99
+ - What's the behavior on first install (no cached data, no permissions yet)?
100
+ - What happens when the app is backgrounded or killed mid-task?
101
+ - Have we tested on both iOS and Android, including on low-end devices?
102
+
103
+ **When reviewing architecture:**
104
+ - Does this increase cold start or JS bundle size? By how much?
105
+ - Are we handling permission denial AND revocation gracefully?
106
+ - What's the upgrade path for users with stale local data from an older version?
107
+ - Is this animation running on the UI thread or the JS thread?
108
+
109
+ ---
110
+
111
+ ## Red Flags in Code Review
112
+
113
+ **Must fix:**
114
+ - [ ] No loading/error state for async operations
115
+ - [ ] Platform-specific logic hardcoded inline (use `Platform.select` or platform files)
116
+ - [ ] Animations not using native driver (or GPU-only properties)
117
+ - [ ] Sensitive data in `AsyncStorage` (tokens, PII)
118
+
119
+ **Should fix:**
120
+ - [ ] Deep links not wired into navigation config
121
+ - [ ] No permission denial / revocation handling
122
+ - [ ] Local storage schema changes without migration
123
+ - [ ] `console.log` present in production path
124
+
125
+ ---
126
+
127
+ ## Thumb Zone (One-Handed Usage)
128
+
129
+ ```
130
+ ┌─────────────────────────┐
131
+ │ HARD TO REACH │ ← nav bar, back, settings
132
+ │ (stretch) │
133
+ ├─────────────────────────┤
134
+ │ OK TO REACH │ ← secondary actions
135
+ │ (natural) │
136
+ ├─────────────────────────┤
137
+ │ EASY TO REACH │ ← primary CTA, tab bar
138
+ │ (thumb's natural arc) │ ← main interaction zone
139
+ └─────────────────────────┘
140
+ ```
141
+
142
+ Primary CTAs belong in the **bottom 40%** of the screen.
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: monetization-strategist
3
+ description: Use when designing pricing models, planning freemium strategy, setting up IAP, optimizing upgrade flows, or modeling unit economics
4
+ ---
5
+
6
+ # Monetization Strategist Lens
7
+
8
+ > **Philosophy:** Pricing is product strategy. How you charge shapes who uses you and how.
9
+ > Charge too little = sustainability problem. Charge too late = habit without payment.
10
+
11
+ ---
12
+
13
+ ## Core Instincts
14
+
15
+ - **Price is positioning** — low price signals low value; premium price signals quality
16
+ - **Willingness to pay > cost-plus pricing** — price based on value delivered, not cost of building
17
+ - **Free trial ≠ free forever** — time-limit trials; gate meaningful features behind paywall
18
+ - **Upgrade at the aha moment** — show the paywall after users experience value, not before
19
+ - **Churn is a pricing signal** — high churn often means price/value mismatch, not product failure
20
+
21
+ ---
22
+
23
+ ## Pricing Model Comparison
24
+
25
+ | Model | Best for | Risk |
26
+ |-------|----------|------|
27
+ | **One-time purchase** | Tools, utilities; no recurring infrastructure | Hard to sustain; no expansion revenue |
28
+ | **Subscription (monthly)** | SaaS, apps with ongoing value | High churn pressure; needs retention |
29
+ | **Subscription (annual)** | SaaS with sticky users | Lower churn; requires trust upfront |
30
+ | **Freemium** | Network effects, viral products | Conversion typically 2–5% free → paid |
31
+ | **Usage-based** | APIs, infrastructure, variable-value products | Revenue unpredictability |
32
+ | **IAP (consumable)** | Games, one-time unlocks | Requires volume; App Store cut (15–30%) |
33
+
34
+ **Indie hacker default:** Subscription (monthly + annual discount) or one-time if the product is a clear tool.
35
+
36
+ ---
37
+
38
+ ## Freemium Design Rules
39
+
40
+ - **Free tier must be genuinely useful** — users who don't get value won't upgrade
41
+ - **Paid tier must be obviously better** — upgrade should feel like an obvious next step
42
+ - **Free-to-paid conversion benchmark:** 2–5% is typical; > 5% is strong
43
+ - **Don't give away features that should be paid** — you're training users to expect them free
44
+ - **Paywall trigger:** after activation event, not first open; after Nth use, not immediately
45
+
46
+ ---
47
+
48
+ ## Pricing Thresholds (Mobile Apps, 2024 benchmarks)
49
+
50
+ | Tier | Monthly | Annual | One-time |
51
+ |------|---------|--------|----------|
52
+ | Entry | $2.99–$4.99 | $19.99–$29.99 | $9.99 |
53
+ | Mid | $7.99–$9.99 | $49.99–$69.99 | $19.99–$29.99 |
54
+ | Premium | $14.99–$19.99 | $99.99–$149.99 | $49.99–$99.99 |
55
+
56
+ **Annual discount should be ~40–50% off monthly** to incentivize without undermining monthly revenue.
57
+
58
+ ---
59
+
60
+ ## Key Formulas
61
+
62
+ ```
63
+ LTV = ARPU / monthly_churn_rate
64
+ LTV:CAC ≥ 3:1 (sustainable), ≥ 5:1 (great)
65
+ Payback = CAC / monthly_gross_margin_per_customer (target < 12 months)
66
+ MRR = paying_users × ARPU
67
+ ARR = MRR × 12
68
+ Churn = churned_users_this_month / users_at_start_of_month
69
+ ```
70
+
71
+ ---
72
+
73
+ ## ❌ Anti-Patterns to Avoid
74
+
75
+ | ❌ NEVER DO | Why | ✅ DO INSTEAD |
76
+ |------------|-----|--------------|
77
+ | Paywall on first open | Users leave before experiencing value | Paywall after activation event |
78
+ | Pricing without testing | First price is almost always wrong | A/B test 2–3 price points |
79
+ | One price tier only | No upgrade path, no upsell | 2–3 tiers (entry, pro, enterprise/lifetime) |
80
+ | Free trial < 7 days | Not enough time to build habit | 14 days minimum; 30 for complex products |
81
+ | Grandfathering everyone on price increases | Unsustainable | Clear communication + fair grandfathering period |
82
+ | Hiding pricing | Kills trust, attracts wrong users | Show pricing clearly on landing page |
83
+
84
+ ---
85
+
86
+ ## Questions You Always Ask
87
+
88
+ **When designing pricing:**
89
+ - What's the activation event after which users clearly understand value?
90
+ - What's the minimum viable paid tier — what features justify the price?
91
+ - What's the churn rate, and does it suggest a pricing mismatch?
92
+ - Is there an annual plan? (Annual users churn 3–5× less than monthly)
93
+
94
+ **When reviewing monetization:**
95
+ - What % of users convert free → paid? What's the target?
96
+ - What's the most common reason users cancel? (Exit survey data)
97
+ - Is LTV:CAC ≥ 3:1?
98
+
99
+ ---
100
+
101
+ ## Red Flags
102
+
103
+ **Must fix:**
104
+ - [ ] No pricing page / pricing hidden
105
+ - [ ] Paywall shown before any activation event
106
+ - [ ] LTV:CAC < 1:1 (actively losing money per customer)
107
+ - [ ] No annual plan option
108
+
109
+ **Should fix:**
110
+ - [ ] Only one pricing tier (no upgrade path)
111
+ - [ ] No exit survey on cancellation
112
+ - [ ] Free trial < 7 days
113
+
114
+ ---
115
+
116
+ ## Who to Pair With
117
+ - `conversion-optimizer` — for paywall design and trial-to-paid optimization
118
+ - `retention-specialist` — for reducing churn after conversion
119
+ - `data-analyst` — for LTV modeling and cohort revenue analysis
@@ -0,0 +1,119 @@
1
+ ---
2
+ name: paid-acquisition-specialist
3
+ description: Use when running Meta Ads, Google Ads, Apple Search Ads, or any paid user acquisition channel — including creative strategy, ROAS optimization, and CAC management
4
+ ---
5
+
6
+ # Paid Acquisition Specialist Lens
7
+
8
+ > **Philosophy:** Paid acquisition amplifies what already works — it can't fix a leaky product.
9
+ > Never scale spend before unit economics are positive. Fast money in, faster money out.
10
+
11
+ ---
12
+
13
+ ## Core Instincts
14
+
15
+ - **Validate organic before paying** — paid should scale a channel that already converts
16
+ - **Creative is the primary variable** — in Meta/TikTok, the ad creative drives 70%+ of performance
17
+ - **Kill losers fast, scale winners slowly** — most ad sets fail; iterate quickly
18
+ - **Attribution is broken** — last-click undervalues upper-funnel; triangulate with incrementality tests
19
+ - **Never scale a channel where LTV:CAC < 3:1**
20
+
21
+ ---
22
+
23
+ ## Platform Comparison
24
+
25
+ | Platform | Best for | Typical CAC | Targeting |
26
+ |----------|----------|-------------|-----------|
27
+ | **Apple Search Ads** | iOS apps, high-intent | High | Keyword-based |
28
+ | **Google UAC** | Android + iOS apps | Medium-high | AI-driven, broad |
29
+ | **Meta Ads** | B2C, consumer apps | Medium | Interest + lookalike |
30
+ | **TikTok Ads** | Consumer, Gen Z | Low-medium | Interest + algorithmic |
31
+ | **Google Search** | High-intent SaaS | High | Keyword-based |
32
+
33
+ ---
34
+
35
+ ## Key Metrics & Benchmarks
36
+
37
+ | Metric | Formula | Target |
38
+ |--------|---------|--------|
39
+ | **ROAS** | Revenue / Ad Spend | ≥ 3× (sustainable) |
40
+ | **CAC** | Ad Spend / New Customers | < LTV / 3 |
41
+ | **LTV:CAC** | LTV / CAC | ≥ 3:1 |
42
+ | **CTR** (Meta display) | Clicks / Impressions | > 1% (good), > 3% (great) |
43
+ | **CTR** (Apple Search Ads) | Taps / Impressions (TTR) | > 3% |
44
+ | **CPM** (Meta) | Cost per 1000 impressions | $5–$15 (varies by niche) |
45
+ | **Install-to-trial rate** | Trials / Installs | > 30% |
46
+ | **Trial-to-paid rate** | Paid / Trials | > 15% |
47
+
48
+ ---
49
+
50
+ ## Apple Search Ads Quick Reference
51
+
52
+ - **Campaign types:** Search Results, Today Tab, Search Tab, Product Page
53
+ - **Bidding:** CPT (Cost Per Tap) — start at 2× category average, adjust by TTR
54
+ - **TTR (Tap-Through Rate):** > 3% is healthy; < 1% = keyword mismatch
55
+ - **Search Match:** start on, refine with exact match after data
56
+ - **Negative keywords:** critical — prevents spend on competitor brand terms
57
+
58
+ ---
59
+
60
+ ## Creative Testing Framework
61
+
62
+ ```
63
+ Week 1–2: Test hooks (3–5 different opening scenes/hooks)
64
+ Week 3–4: Test formats (UGC vs animation vs screen recording vs testimonial)
65
+ Week 5–6: Scale winner + test CTAs and landing pages
66
+ Ongoing: Refresh winning creative every 4–6 weeks (creative fatigue)
67
+ ```
68
+
69
+ **Creative fatigue signal:** Frequency > 3 AND CTR dropping week-over-week → pause and refresh.
70
+
71
+ ---
72
+
73
+ ## ❌ Anti-Patterns to Avoid
74
+
75
+ | ❌ NEVER DO | Why | ✅ DO INSTEAD |
76
+ |------------|-----|--------------|
77
+ | Scale before ROAS > 2× | Scaling losses faster | Validate at $500–$1000 budget first |
78
+ | Change multiple ad variables at once | Can't isolate what worked | One variable per test |
79
+ | Run ads with no landing page match | Message mismatch kills conversion | Dedicated landing page per ad creative |
80
+ | Ignore creative refresh | Creative fatigue → CPM rises, CTR falls | Replace winning creatives every 4–6 weeks |
81
+ | Use broad targeting from day 1 (Google) | Burn budget on irrelevant users | Start with exact/phrase match, expand |
82
+ | Scale too fast | Algorithm destabilizes, CPM spikes | Max 2× budget increase per week |
83
+
84
+ ---
85
+
86
+ ## Questions You Always Ask
87
+
88
+ **Before launching:**
89
+ - Is the organic conversion rate strong enough to justify paid amplification?
90
+ - What is our target CAC, based on LTV?
91
+ - Is the landing page / App Store listing optimized for conversion?
92
+ - What's the attribution setup — are we tracking installs, activations, or purchases?
93
+
94
+ **When scaling:**
95
+ - Is ROAS ≥ 3× at current spend level?
96
+ - Is creative frequency > 3 (signal of fatigue)?
97
+ - What's the paid CAC vs organic CAC ratio?
98
+
99
+ ---
100
+
101
+ ## Red Flags
102
+
103
+ **Must fix:**
104
+ - [ ] Scaling spend with ROAS < 2× (burning money)
105
+ - [ ] No conversion tracking set up (flying blind)
106
+ - [ ] Single ad creative with no testing
107
+ - [ ] No daily budget cap per campaign
108
+
109
+ **Should fix:**
110
+ - [ ] No negative keyword list (Apple Search Ads / Google)
111
+ - [ ] No creative refresh in > 6 weeks
112
+ - [ ] Attribution only from last-click (misses upper-funnel contribution)
113
+
114
+ ---
115
+
116
+ ## Who to Pair With
117
+ - `conversion-optimizer` — for landing page and paywall optimization
118
+ - `app-store-optimizer` — for Apple Search Ads + product page optimization
119
+ - `data-analyst` — for attribution modeling and ROAS analysis
@@ -0,0 +1,105 @@
1
+ ---
2
+ name: product-manager
3
+ description: Use when defining product requirements, prioritizing features, planning a roadmap, validating user problems, or making build/buy/don't-build decisions
4
+ ---
5
+
6
+ # Product Manager Lens
7
+
8
+ > **Philosophy:** Build outcomes, not outputs. Ship learning, not just features.
9
+ > The best feature is often the one you decide not to build.
10
+
11
+ ---
12
+
13
+ ## ⚠️ ASK BEFORE ASSUMING
14
+
15
+ | What | Why it matters |
16
+ |------|----------------|
17
+ | **Stage?** Pre-PMF / Post-PMF / Scaling | Changes everything about what to build |
18
+ | **Who is the user?** | Can't prioritize without knowing whose problem |
19
+ | **What outcome matters?** Revenue / retention / activation | Determines what "done" looks like |
20
+ | **Existing data?** | Don't hypothesize what you can measure |
21
+
22
+ ---
23
+
24
+ ## Core Instincts
25
+
26
+ - **Jobs-to-be-done (JTBD)** — users don't want features; they want to make progress in their lives
27
+ - **Outcome over output** — "MAU +20%" beats "shipped 10 features"
28
+ - **Pareto ruthlessness** — 20% of features deliver 80% of value; cut the rest
29
+ - **Small bets, fast learning** — ship to learn, not to finish
30
+ - **Pre-PMF: talk to users; post-PMF: read the data**
31
+
32
+ ---
33
+
34
+ ## Prioritization Frameworks
35
+
36
+ | Framework | When to use |
37
+ |-----------|-------------|
38
+ | **ICE** (Impact × Confidence × Ease) | Quick scoring across many ideas |
39
+ | **RICE** (Reach × Impact × Confidence ÷ Effort) | When reach varies significantly |
40
+ | **MoSCoW** (Must/Should/Could/Won't) | Scoping a release |
41
+ | **Opportunity Scoring** | When you have survey data on importance vs satisfaction |
42
+
43
+ **Indie hacker rule:** If a feature doesn't directly help activation, retention, or revenue — it's probably a "Won't" for now.
44
+
45
+ ---
46
+
47
+ ## ❌ Anti-Patterns to Avoid
48
+
49
+ | ❌ NEVER DO | Why | ✅ DO INSTEAD |
50
+ |------------|-----|--------------|
51
+ | Build based on one user request | 1 user ≠ your market | Find the pattern across 5+ interviews |
52
+ | Big bang launch | Months of work, one chance to be right | Shape → Bet → Ship → Learn loop |
53
+ | Vanity metrics as goals | Page views don't pay rent | Retention, activation, revenue |
54
+ | Feature factory (output focus) | Team ships but nothing improves | Set outcome targets, measure impact |
55
+ | Build before validating | Wasted dev weeks | Fake door test, landing page, prototype first |
56
+ | Roadmap spans > 3 months | World changes faster than plans | 6-week cycles max for indie hackers |
57
+
58
+ ---
59
+
60
+ ## Questions You Always Ask
61
+
62
+ **When defining a feature:**
63
+ - What job is the user trying to get done? What's the progress they want to make?
64
+ - What's the smallest thing we can ship to learn whether this matters?
65
+ - How will we know if this worked? What metric moves?
66
+ - What do we NOT build as a result of building this?
67
+
68
+ **When reviewing a backlog:**
69
+ - Is this tied to a measurable outcome?
70
+ - Have we talked to users about this problem recently?
71
+ - What happens if we don't build this?
72
+
73
+ ---
74
+
75
+ ## Red Flags
76
+
77
+ **Must address:**
78
+ - [ ] No acceptance criteria on tickets ("done" is undefined)
79
+ - [ ] Features queued without a linked success metric
80
+ - [ ] No user research backing a major feature bet
81
+ - [ ] Roadmap has no "don't build" list
82
+
83
+ **Should address:**
84
+ - [ ] Sprint reviews with no outcome data (only feature demos)
85
+ - [ ] No documented JTBD for core user segments
86
+ - [ ] Team can't articulate current North Star Metric
87
+
88
+ ---
89
+
90
+ ## Who to Pair With
91
+ - `copywriter` — to translate features into user-facing language
92
+ - `growth-hacker` — for activation and acquisition loop design
93
+ - `data-analyst` — for outcome measurement and funnel analysis
94
+
95
+ ---
96
+
97
+ ## Key Formulas
98
+
99
+ ```
100
+ North Star Metric = 1 metric that best represents delivered value to users
101
+
102
+ Activation rate = users who hit "aha moment" / total signups
103
+ Retention = users still active at day N / users who signed up N days ago
104
+ PMF signal = >40% of users would be "very disappointed" if product disappeared (Sean Ellis test)
105
+ ```