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.
- package/package.json +1 -1
- package/template/agent/skills/api-design/SKILL.md +193 -0
- package/template/agent/skills/app-store-optimizer/SKILL.md +127 -0
- package/template/agent/skills/auth-and-identity/SKILL.md +167 -0
- package/template/agent/skills/backend-developer/SKILL.md +148 -0
- package/template/agent/skills/community-manager/SKILL.md +115 -0
- package/template/agent/skills/content-marketer/SKILL.md +111 -0
- package/template/agent/skills/conversion-optimizer/SKILL.md +142 -0
- package/template/agent/skills/copywriter/SKILL.md +114 -0
- package/template/agent/skills/cto-architect/SKILL.md +133 -0
- package/template/agent/skills/customer-success-manager/SKILL.md +126 -0
- package/template/agent/skills/data-analyst/SKILL.md +147 -0
- package/template/agent/skills/devops-engineer/SKILL.md +117 -0
- package/template/agent/skills/email-infrastructure/SKILL.md +164 -0
- package/template/agent/skills/frontend-developer/SKILL.md +133 -0
- package/template/agent/skills/game-design/SKILL.md +194 -0
- package/template/agent/skills/game-developer/SKILL.md +175 -0
- package/template/agent/skills/growth-hacker/SKILL.md +122 -0
- package/template/agent/skills/i18n-localization/SKILL.md +126 -0
- package/template/agent/skills/influencer-marketer/SKILL.md +141 -0
- package/template/agent/skills/mobile-developer/SKILL.md +142 -0
- package/template/agent/skills/monetization-strategist/SKILL.md +119 -0
- package/template/agent/skills/paid-acquisition-specialist/SKILL.md +119 -0
- package/template/agent/skills/product-manager/SKILL.md +105 -0
- package/template/agent/skills/real-time-features/SKILL.md +194 -0
- package/template/agent/skills/retention-specialist/SKILL.md +123 -0
- package/template/agent/skills/saas-architect/SKILL.md +139 -0
- package/template/agent/skills/security-engineer/SKILL.md +133 -0
- package/template/agent/skills/seo-specialist/SKILL.md +130 -0
- package/template/agent/skills/subscription-billing/SKILL.md +179 -0
- 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
|
+
```
|