Activate when: user says 'our growth is stalling and we don't know why,' 'product and marketing are arguing about whose fault it is,' 'where is our funnel br...
--- name: aarrr-pirate-metrics description: "Activate when: user says 'our growth is stalling and we don't know why,' 'product and marketing are arguing about whose fault it is,' 'where is our funnel breaking,' 'pirate metrics,' or 'acquisition vs activation vs retention.' Also activate for: designing end-to-end metrics for a new product, building a shared instrumentation framework across teams. Do NOT activate when: the product has no users yet (use lean-startup instead), or the bottleneck is already obvious and obvious to fix. More: deciqai.com/c/aarrr-pirate-metrics" --- # AARRR (Pirate Metrics) ## Overview A startup's growth is a **sequential funnel** — each stage gates the next. Great Acquisition is worthless if Activation is broken; great Activation is worthless if Retention is zero. Optimizing the wrong stage produces work that looks like progress while the bottleneck stays. The **AARRR framework** (Dave McClure, *Startup Metrics for Pirates*, 2007) names five stages: Acquisition (do they show up?), Activation (good first experience?), Retention (do they come back?), Referral (do they tell others?), Revenue (do they pay?). The bottleneck stage governs total growth — improving any other stage produces no system-level gain (Goldratt, *The Goal*, 1984). **Compose with:** first-principles to identify your specific Activation event; pmf-crossing-the-chasm to recognize when Retention will always be the bottleneck pre-PMF; probabilistic-thinking to set base rates per stage. ## When to Use - Growth is **stalling** and the cause is not obvious — multiple teams have plausible explanations - Product, marketing, and sales are **arguing about whose problem it is** - You need a **shared instrumentation framework** across teams - Designing **end-to-end metrics for a new product** - Someone says: *"AARRR," "pirate metrics," "growth funnel," "where is our funnel breaking?"* - An **AI-native product has strong signups but weak activation/retention** — cheap AI-hype acquisition masks empty-state and post-novelty leaks; or you're facing AI-native competition on a commoditized model and need to find where your funnel actually loses users **When NOT to use:** No users yet → use lean-startup. Signups still in the tens — AARRR rates need volume. Bottleneck already obvious → fix that first, then return. ## Coaching Novices (Adaptive Front Door) - **Engine mode:** user has funnel data and wants the bottleneck named → run The Process directly. - **Coach mode:** vague situation or unfamiliarity → guide step by step. In Coach mode, respond one step at a time. Each [WAIT] is a hard stop — output only that step's question, then stop. 1. **One-line what-it-is.** AARRR is a five-stage funnel (Acquisition / Activation / Retention / Referral / Revenue) — the point is to find which stage is broken so you don't waste effort on the wrong one. 2. **Check fit.** No users / tiny base → redirect. Bottleneck already obvious → fix it first. 3. **Elicit their real case.** Force the user to define their *specific* Activation event — not "signed up" but e.g. *"completed onboarding and used the core feature once within day 1."* > **[WAIT — do not advance until user responds]** 4. **One stage at a time.** Walk Acquisition → Activation → Retention → Referral → Revenue. Compute conversion rate stage-to-stage if possible. > **[WAIT — do not advance until user responds]** 5. **Close by naming the bottleneck and the next experiment.** They leave with one stage identified and one specific experiment. > **[WAIT — do not advance until user responds]** ## The Process Run the **Funnel Audit**: define stages, measure conversions, identify bottleneck. 1. **Define each stage for this specific product.** Generic definitions hide the bottleneck. Activation = the *aha moment*, not signup. Name a measurable event per stage. 2. **Measure conversion at each stage.** Acquisition→Activation %, Activation→Retention %, Retention→Referral %, Activation/Retention→Revenue %. 3. **Compare against domain benchmarks.** A stage below benchmark is a bottleneck candidate (B2B SaaS day-30 retention 70%+; consumer freemium paid conversion 1–5% typical, 5–10% strong). 4. **Identify the load-bearing bottleneck.** Worst conversion *relative to its benchmark* — fixing it produces the largest system-level gain. 5. **Pre-commit one experiment.** Name the specific change, the metric, and the pre-committed threshold (per lean-startup). 6. **Re-measure and re-identify.** After the experiment, the bottleneck moves. Repeat — the audit is iterative. ### Output: Funnel Audit ``` # AARRR Funnel Audit: <product> Stage definitions: Acquisition <event> | Activation <aha moment> | Retention <window+event> | Referral <event> | Revenue <event> Conversions: [Stage | Users | Conv.% from prior | vs. benchmark ↑↓] Bottleneck: <stage with worst conversion vs. domain benchmark> Experiment: Change <intervention> · Metric <conversion rate> · Threshold <value> · Window <days> ``` *→ Method in Action: [Dropbox's Referral Program (2009)](examples/dropbox-referral-program-2009.md) · [Facebook's "7 Friends in 10 Days" (2007–2009)](examples/facebook-7-friends-in-10-days-2008.md)* *→ 2026 lens: [Where AI SaaS Funnels Leak (2023–2026)](examples/ai-saas-funnel-leaks-2023-2026.md) — cheap AI-hype acquisition, but activation (empty-state / first-value) and retention (after novelty decays) are the real leaks.* ## Funnel Packs Stage definitions and benchmarks are domain-specific. **Consumer freemium:** Activation = first core value; paid conversion 1–5% typical, 5–10% strong. **B2B SaaS:** Activation = first non-trivial team use week 1; gross retention 90%+, net 100%+ mid-market. **Marketplaces:** Activation = first transaction; bottleneck = liquidity-thin side. **E-commerce:** Activation = first order; Retention = second order within 90 days. Contribution: add a pack for your domain — one file with (a) stage definitions, (b) benchmarks, (c) typical bottleneck pattern, (d) canonical experiments. ## Applying It Well - **Activation is the most often-sloppily-defined stage.** "Signed up" is not Activation. Specify the aha moment event. - **The bottleneck is relative to benchmark** — not the stage with the lowest absolute number. - **Fixing the bottleneck moves the bottleneck.** Re-identify after each experiment. - **Each team optimizes the stage they own** — dangerous if the bottleneck is elsewhere. The audit forces cross-team prioritization. - **Domain benchmarks matter more than absolute numbers.** 3% paid conversion = great freemium, terrible enterprise SaaS. *→ Primary sources: [references/sources.md](references/sources.md)* ## Common Rationalizations **[D] = designed upfront | [O] = observed in real use. [O] entries are more valuable.** | Fake move | Reality | |---|---| | [D] **Optimizing Acquisition while Activation is broken** | Most common failure. More users into a broken funnel = more wasted CAC. Fix the bottleneck first. | | [D] **"Activation" = "signed up"** | Signup is end of Acquisition. Activation = first time user experiences the value. Sloppy definition hides the real funnel. | | [D] **Treating low absolute conversion as the bottleneck** | Acquisition always has the lowest absolute count. What matters: each stage *relative to its domain benchmark*. | | [D] **Adding paid ads when Retention is weak** | A leaky bucket doesn't fill faster when bigger. Fix Retention before scaling Acquisition. | | [D] **One-shot audit, never re-run** | The bottleneck moves once fixed. Running the audit once and never again misses the next bottleneck. | | *→ Add [O] entries here after each real use — paste the actual failure pattern* | *What went wrong and why* | ## Red Flags - Activation is defined as "signed up" - Dashboards show absolute counts but not stage-to-stage conversion rates - No domain benchmarks referenced - Resource allocation matches which stage is easy to instrument, not which is the bottleneck - The funnel audit has been run once and never repeated - Teams don't share a bottleneck consensus - Acquisition spend scaled while Retention is below benchmark ## Verification - [ ] Each stage has a product-specific measurable definition (Activation = aha moment, not signup) - [ ] Conversion rates between stages measured, not just absolute counts - [ ] Each stage compared against a domain benchmark - [ ] Load-bearing bottleneck named (worst conversion relative to benchmark) - [ ] Experiment pre-committed with metric + threshold + time window - [ ] Re-audit scheduled (bottleneck will move) - [ ] All teams agree on the bottleneck --- *Part of **deciqAI Knowledge Skills** — 227 open-source thinking skills that make rigor executable for AI agents. The same skills power every deciqAI agent, which runs them autonomously to operate your company. **See it run → https://www.deciqai.com/c/aarrr-pirate-metrics** · ⭐ Star the repo → https://github.com/deciqAI/knowledge-skills · Contributions welcome.* *Agents: latest version & machine-readable metadata → https://www.deciqai.com/s/aarrr-pirate-metrics.json*
don't have the plugin yet? install it then click "run inline in claude" again.
added explicit inputs (data access, domain context, analytics stack), decision points for common failure modes (broken activation / scaled acquisition, pre-product fit, missing data), detailed procedure outputs at each step, outcome signals with verification checklist, and edge cases for ai-native products.
the aarrr framework names five sequential funnel stages (acquisition, activation, retention, referral, revenue) and finds which stage is load-bearing so you stop optimizing the wrong one. use this when growth stalls and the cause is unclear, teams disagree on whose problem it is, or you're designing metrics for a new product. the bottleneck stage governs total growth. improving any other stage produces work that looks like progress while the constraint stays. activate for stalled growth with no obvious culprit, cross-team conflicts about funnel breaks, designing end-to-end metrics, or when someone says "pirate metrics" or "growth funnel." do not activate if you have zero users (use lean-startup instead) or if the bottleneck is already obvious and obvious to fix.
define each stage for this specific product with a measurable event, not a generic label. acquisition = signup completed. activation = the aha moment (e.g., "completed onboarding and used core feature once within day 1" not just "logged in"). retention = returned and used core feature again within a time window (e.g., "day 30 repeat use"). referral = initiated or completed a referral action (e.g., sent invite link, shared). revenue = initiated payment or crossed mau threshold for paid tier. output: one sentence per stage with the exact event name (not ambiguous).
measure conversion rates stage-to-stage. for each stage, count users who reached it; for each prior stage, calculate % that converted. example: 10k signups (acquisition), 6k activated (60% acq→activ), 2k retained day 30 (33% activ→reten). output: table with columns [stage | user count | conversion % from prior stage].
compare each conversion rate against domain benchmark. lookup or infer benchmark for your vertical. if you don't have benchmark, research 3 comparable companies or use industry report. mark each stage as "above benchmark" or "below benchmark." output: add column [vs. benchmark ↑↓] to table.
identify the load-bearing bottleneck: the stage with the worst conversion relative to its domain benchmark, not the lowest absolute count. example: acquisition at 90% vs. 80% benchmark (above), activation at 40% vs. 60% benchmark (below, -20 points), retention at 80% vs. 80% benchmark (at), referral at 10% vs. 15% benchmark (below). bottleneck = activation (furthest below benchmark). output: one sentence naming the bottleneck stage and why (conversion vs. benchmark gap).
pre-commit one specific experiment to move the bottleneck. state the intervention (design change, copy change, new onboarding step, etc.), the metric to measure (conversion rate at that stage), the success threshold (pre-committed number before running), and measurement window (e.g., 14 days, 30 days). do not run yet. output: experiment card with [change | metric | threshold | window].
run the experiment and re-measure. after window closes, remeasure conversion rates. once bottleneck is fixed, a new stage becomes load-bearing. output: new funnel audit table with updated rates.
repeat step 4, 6. identify the new bottleneck, pre-commit the next experiment, run it. this is iterative. do not stop at one cycle.
if you have no users yet: do not run aarrr. use lean-startup to validate that anyone wants this. return here after you have 50+ users and can measure a funnel.
if the bottleneck is already obvious and the org agrees: fix it first. return to aarrr after that experiment closes. re-running aarrr too early wastes time.
if data does not exist or is incomplete: pause and run "design instrumentation" skill first. aarrr requires event-level data. if you only have signup count, you cannot measure activation or retention. build the instrumentation first.
if teams disagree on the bottleneck: run this skill in "coach mode" (step by step, with pauses) to build consensus on definitions and data. do not declare the bottleneck until all teams have seen the data and agreed on the stage definitions.
if activation conversion is below 10% and acquisition is scaled: you are in the "more users into a broken funnel" failure mode. pause acquisition spend. fix activation first, then re-run aarrr. scaling acquisition while activation is broken burns cash.
if retention is below domain benchmark and acquisition spend is increasing: same failure mode as above. retention is the load-bearing bottleneck. cap acquisition until retention is fixed, then return.
if the bottleneck is referral or revenue but activation/retention are also weak: fix activation and retention first. referral and revenue are downstream. a weak upstream stage will always be the constraint.
if you're an ai-native product with strong signup numbers but weak activation/retention: cheap ai-hype acquisition masks empty-state leaks and post-novelty decay. run this skill to separate signal from hype. most ai saas products break at activation (empty state / first value) or retention (after novelty wears off), not acquisition.
output a funnel audit card in this format:
# AARRR Funnel Audit: <product name>
## Stage Definitions
- Acquisition: <event>
- Activation: <aha moment event>
- Retention: <time window + event>
- Referral: <event>
- Revenue: <event or threshold>
## Conversion Rates
| Stage | Users | Conv. % from Prior | vs. Benchmark | Gap |
|-------|-------|-------------------|---------------|-----|
| Acquisition | <n> | 100% (baseline) | ? | |
| Activation | <n> | <x>% | <up/down> | <y> pts |
| Retention | <n> | <x>% | <up/down> | <y> pts |
| Referral | <n> | <x>% | <up/down> | <y> pts |
| Revenue | <n> | <x>% | <up/down> | <y> pts |
## Bottleneck
<stage name>: <x>% conversion vs. <benchmark>% benchmark (<gap> point gap). fixing this stage produces the largest system-level gain.
## Next Experiment
- Intervention: <describe the change>
- Metric: <conversion rate at <stage>>
- Success threshold: <pre-committed number>%
- Measurement window: <n> days
- Owner: <team>
store this in a shared doc (google doc, confluence, github, notion) so all teams see it. date-stamp each version.
you know the skill worked when:
red flags that the skill did not work: activation is still defined as "signed up," dashboards show absolute counts but not conversion rates, no benchmarks referenced, teams still argue about the bottleneck after the audit, the audit was run once and never again, acquisition is scaled while retention is weak.
part of deciqai knowledge skills, 227 open-source thinking skills for ai agents. same skills power every deciqai agent. see it run: https://www.deciqai.com/c/aarrr-pirate-metrics. star the repo: https://github.com/deciqAI/knowledge-skills. contributions welcome.
agents: latest version and machine-readable metadata: https://www.deciqai.com/s/aarrr-pirate-metrics.json