Monetization Design
Purpose
Design the monetization architecture for a product, including pricing tier structure, paywall placement strategy, subscription infrastructure, and upgrade flow design.
Scope Constraints
Analyzes product feature sets, competitive pricing, and billing architecture patterns. Does not implement payment integrations, modify production billing systems, or access financial data directly.
Inputs
- Product feature set (what exists, what's being built)
- Target user segments and willingness-to-pay estimates
- Competitive pricing landscape
- Existing billing infrastructure (Stripe, RevenueCat, etc.)
- App Store / Play Store requirements for in-app purchases
Input Sanitization
No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.
Procedure
Progress Checklist
Step 1: Define Value Metrics
Identify what users pay for:
- Usage-based: API calls, storage, messages, seats
- Feature-based: Advanced features, integrations, priority support
- Outcome-based: Projects, exports, reports generated
- Choose the metric that scales with the value the user receives
Step 2: Design Tier Structure
Create a pricing ladder:
- Free tier: Generous enough to create habit and demonstrate value
- Pro tier: For power users and small teams — the "sweet spot"
- Enterprise tier: For organizations — custom pricing, SSO, audit logs
- Apply anchoring: the Pro tier should look like a great deal compared to Enterprise
- Apply decoy effect if appropriate: a tier that makes the target tier look better
Step 3: Design Paywall Placement
Determine where paywalls appear:
- Feature gating: Advanced features locked behind upgrade
- Usage limits: Free tier gets N units/month, Pro gets unlimited
- Soft paywalls: Show the feature, let them try it, then gate on save/export
- Hard paywalls: Block access entirely until upgrade
- Rule: Paywalls should appear when users want more, not when they want basic
Step 4: Design Upgrade Flow
Create the conversion experience:
- Trigger moment: User hits a limit or discovers a locked feature
- Value presentation: Show what they'll get (not just what they're paying)
- Pricing page: Clear comparison table, recommended tier highlighted
- Checkout flow: Minimize steps — ideally 1-2 clicks from trigger to purchase
- Trial option: 7-14 day free trial with full access, credit card optional vs required
Step 5: Design Subscription Infrastructure
Technical architecture:
- Payment provider: Stripe, RevenueCat, Paddle, or platform-native (App Store, Play Store)
- Entitlement system: How the app checks what the user has access to
- Webhook handling: Subscription created, renewed, cancelled, payment failed
- Grace period: What happens when payment fails (dunning flow)
- Platform compliance: App Store requirements for subscription management
Step 6: Design Retention Mechanics
Reduce subscription churn:
- Cancellation flow: Ask why, offer alternatives (pause, downgrade, discount)
- Win-back offers: Discount email after cancellation
- Annual discount: Incentivize annual plans (typically 20% discount)
- Usage reinforcement: Show users the value they've received ("You saved 10 hours this month")
Compaction resilience: If context was lost during a long session, re-read the Inputs section to reconstruct what product is being analyzed, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.
Output Format
# Monetization Architecture
## Value Metric
**Primary metric:** [What users pay for]
**Scaling:** [How it grows with usage]
## Tier Structure
| | Free | Pro ($X/mo) | Enterprise |
|---|------|------------|------------|
| [Feature 1] | Limited | Unlimited | Unlimited |
| [Feature 2] | No | Yes | Yes |
| [Feature 3] | No | No | Yes |
| Support | Community | Email | Dedicated |
## Paywall Map
| Feature/Limit | Type | Trigger | User Experience |
|--------------|------|---------|-----------------|
| [Feature] | Soft | Usage limit hit | Show result, gate export |
| [Feature] | Hard | Feature tap | Upgrade modal with trial |
## Upgrade Flow
1. User hits [trigger]
2. [Inline upgrade prompt / modal / pricing page]
3. [Plan selection with trial option]
4. [Checkout — X steps]
5. [Success confirmation + unlock]
## Subscription Infrastructure
**Provider:** [Stripe / RevenueCat / etc.]
**Entitlement check:** [How the app verifies access]
**Dunning flow:** [What happens on payment failure]
## Retention Strategy
| Churn Signal | Intervention | Timing |
|-------------|-------------|--------|
| Cancellation initiated | Exit survey + discount offer | Immediate |
| Payment failed | Dunning email sequence | Day 1, 3, 7 |
Handoff
- Hand off to growth-engineering if onboarding funnel optimization or A/B test instrumentation needs arise during monetization analysis.
- Hand off to messaging-strategy if upgrade prompt copy, paywall messaging, or cancellation flow language needs refinement.
Quality Checks
Evolution Notes
Converted and distributed by TomeVault — claim your Tome and manage your conversions.
1---2name: monetization-design3description: Use when designing monetization architecture including pricing tiers, paywall placement, subscription infrastructure, and upgrade flows. Covers freemium models, billing integration, and retention mechanics. Do not use for product copy or naming conventions (use messaging-strategy) or onboarding funnels and A/B tests (use growth-engineering).4---56# Monetization Design78## Purpose910Design the monetization architecture for a product, including pricing tier structure, paywall placement strategy, subscription infrastructure, and upgrade flow design.1112## Scope Constraints1314Analyzes product feature sets, competitive pricing, and billing architecture patterns. Does not implement payment integrations, modify production billing systems, or access financial data directly.1516## Inputs1718- Product feature set (what exists, what's being built)19- Target user segments and willingness-to-pay estimates20- Competitive pricing landscape21- Existing billing infrastructure (Stripe, RevenueCat, etc.)22- App Store / Play Store requirements for in-app purchases2324## Input Sanitization2526No user-provided values are used in commands or file paths. All inputs are treated as read-only analysis targets.2728## Procedure2930### Progress Checklist31- [ ] Step 1: Value metrics defined32- [ ] Step 2: Tier structure designed33- [ ] Step 3: Paywall placement designed34- [ ] Step 4: Upgrade flow designed35- [ ] Step 5: Subscription infrastructure designed36- [ ] Step 6: Retention mechanics designed3738### Step 1: Define Value Metrics3940Identify what users pay for:41- **Usage-based:** API calls, storage, messages, seats42- **Feature-based:** Advanced features, integrations, priority support43- **Outcome-based:** Projects, exports, reports generated44- Choose the metric that scales with the value the user receives4546### Step 2: Design Tier Structure4748Create a pricing ladder:49- **Free tier:** Generous enough to create habit and demonstrate value50- **Pro tier:** For power users and small teams — the "sweet spot"51- **Enterprise tier:** For organizations — custom pricing, SSO, audit logs52- Apply anchoring: the Pro tier should look like a great deal compared to Enterprise53- Apply decoy effect if appropriate: a tier that makes the target tier look better5455### Step 3: Design Paywall Placement5657Determine where paywalls appear:58- **Feature gating:** Advanced features locked behind upgrade59- **Usage limits:** Free tier gets N units/month, Pro gets unlimited60- **Soft paywalls:** Show the feature, let them try it, then gate on save/export61- **Hard paywalls:** Block access entirely until upgrade62- **Rule:** Paywalls should appear when users want *more*, not when they want *basic*6364### Step 4: Design Upgrade Flow6566Create the conversion experience:67- **Trigger moment:** User hits a limit or discovers a locked feature68- **Value presentation:** Show what they'll get (not just what they're paying)69- **Pricing page:** Clear comparison table, recommended tier highlighted70- **Checkout flow:** Minimize steps — ideally 1-2 clicks from trigger to purchase71- **Trial option:** 7-14 day free trial with full access, credit card optional vs required7273### Step 5: Design Subscription Infrastructure7475Technical architecture:76- **Payment provider:** Stripe, RevenueCat, Paddle, or platform-native (App Store, Play Store)77- **Entitlement system:** How the app checks what the user has access to78- **Webhook handling:** Subscription created, renewed, cancelled, payment failed79- **Grace period:** What happens when payment fails (dunning flow)80- **Platform compliance:** App Store requirements for subscription management8182### Step 6: Design Retention Mechanics8384Reduce subscription churn:85- **Cancellation flow:** Ask why, offer alternatives (pause, downgrade, discount)86- **Win-back offers:** Discount email after cancellation87- **Annual discount:** Incentivize annual plans (typically 20% discount)88- **Usage reinforcement:** Show users the value they've received ("You saved 10 hours this month")8990> **Compaction resilience**: If context was lost during a long session, re-read the Inputs section to reconstruct what product is being analyzed, check the Progress Checklist for completed steps, then resume from the earliest incomplete step.9192## Output Format9394```markdown95# Monetization Architecture9697## Value Metric98**Primary metric:** [What users pay for]99**Scaling:** [How it grows with usage]100101## Tier Structure102| | Free | Pro ($X/mo) | Enterprise |103|---|------|------------|------------|104| [Feature 1] | Limited | Unlimited | Unlimited |105| [Feature 2] | No | Yes | Yes |106| [Feature 3] | No | No | Yes |107| Support | Community | Email | Dedicated |108109## Paywall Map110| Feature/Limit | Type | Trigger | User Experience |111|--------------|------|---------|-----------------|112| [Feature] | Soft | Usage limit hit | Show result, gate export |113| [Feature] | Hard | Feature tap | Upgrade modal with trial |114115## Upgrade Flow1161. User hits [trigger]1172. [Inline upgrade prompt / modal / pricing page]1183. [Plan selection with trial option]1194. [Checkout — X steps]1205. [Success confirmation + unlock]121122## Subscription Infrastructure123**Provider:** [Stripe / RevenueCat / etc.]124**Entitlement check:** [How the app verifies access]125**Dunning flow:** [What happens on payment failure]126127## Retention Strategy128| Churn Signal | Intervention | Timing |129|-------------|-------------|--------|130| Cancellation initiated | Exit survey + discount offer | Immediate |131| Payment failed | Dunning email sequence | Day 1, 3, 7 |132```133134## Handoff135136- Hand off to growth-engineering if onboarding funnel optimization or A/B test instrumentation needs arise during monetization analysis.137- Hand off to messaging-strategy if upgrade prompt copy, paywall messaging, or cancellation flow language needs refinement.138139## Quality Checks140141- [ ] Free tier is generous enough to demonstrate value and create habit142- [ ] Paywall placement occurs at "want more" moments, not "need basic" moments143- [ ] Upgrade flow is 2 clicks or fewer from trigger to checkout144- [ ] Subscription infrastructure handles renewal, cancellation, and payment failure145- [ ] App Store / Play Store subscription requirements are met (if applicable)146- [ ] Retention mechanics include cancellation flow and win-back strategy147148## Evolution Notes149<!-- Observations appended after each use -->150151---152> Converted and distributed by [TomeVault](https://tomevault.io/claim/dtsong) — claim your Tome and manage your conversions.153<!-- tomevault:4.0:skill_md:2026-04-13 -->