Files
skills/public/aarrr-framework.html
zeekay 747dafba10 Register WebMCP tools on every page, and name each page's twin from site.py
Every page now loads /webmcp.js, scripts/webmcp.ts with its types
stripped (npm run webmcp). Where the browser has document.modelContext
it registers two read-only tools: search_skills over the published
skills index, and get_skill, which returns a skill's markdown checked
against the index digest. The markdown alternate link moves from
build.py to site.py, so CI holds every page to it.

The API catalog gains the site itself (llms.txt and the skills index)
and hanzo.ai/agents; the live discovery check now fetches every
catalog link. tests/site.mjs drives the tools through a recording
modelContext, and checks a browser without one loads clean.
2026-10-26 20:57:05 -07:00

285 lines
24 KiB
HTML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!doctype html>
<html lang="en"><head>
<meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">
<title>aarrr-framework</title>
<meta name="color-scheme" content="dark">
<style>
/* Committed to one visual world: a dark instrument panel. No light variant —
the dot field and the hairline rules only read on black, and a naive
inversion would wash both out. Every colour is painted explicitly so the page
never borrows a host background. */
@font-face{font-family:'Zen';src:url('/fonts/Zen-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen';src:url('/fonts/Zen-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Variable.woff2') format('woff2');font-weight:100 900;font-style:normal;font-display:swap}
@font-face{font-family:'Zen Mono';src:url('/fonts/ZenMono-Italic-Variable.woff2') format('woff2');font-weight:100 900;font-style:italic;font-display:swap}
@font-face{font-family:'Zen Pixel Square';src:url('/fonts/ZenPixel-Square.woff2') format('woff2');font-style:normal;font-display:swap}
:root{
--ink:#f4f4f2; --soft:#9c9c98; --faint:#6a6a66; --ground:#000; --panel:#0a0a0a;
--line:#232323; --line-hi:#3a3a3a; --accent:#f4f4f2;
--font-zen-sans:'Zen',-apple-system,BlinkMacSystemFont,"Segoe UI",Helvetica,Arial,sans-serif;
--font-zen-mono:'Zen Mono',ui-monospace,"SF Mono",SFMono-Regular,Menlo,Consolas,monospace;
--font-zen-pixel-square:'Zen Pixel Square',monospace;
--mono:var(--font-zen-mono);
--sans:var(--font-zen-sans);
/* Controls are pills and surfaces are soft, as on hanzo.ai. */
--r:999px; --r-soft:14px;
}
*{box-sizing:border-box}
html{-webkit-text-size-adjust:100%}
body{margin:0;background:var(--ground);color:var(--ink);font-family:var(--sans);
font-size:16px;line-height:1.65;-webkit-font-smoothing:antialiased}
.wrap{max-width:60rem;margin:0 auto;padding:0 1.75rem}
/* The dot field. A halftone made of one repeating radial-gradient, faded out
along the diagonal by a mask so it reads as a wave rather than wallpaper. */
/* No overflow clip here: the dot field is inset to the box already, and a clip
would cut off the copy-prompt menu. */
.hero{position:relative;border-bottom:1px solid var(--line)}
.hero::before{content:"";position:absolute;inset:0;
background-image:radial-gradient(var(--line-hi) 1px, transparent 1px);
background-size:7px 7px;
-webkit-mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
mask-image:linear-gradient(115deg,#000 0%,rgba(0,0,0,.55) 38%,transparent 72%);
pointer-events:none}
.hero .wrap{position:relative;padding-top:5.5rem;padding-bottom:4rem}
nav{border-bottom:1px solid var(--line)}
nav .in{max-width:60rem;margin:0 auto;padding:1.1rem 1.75rem;display:flex;
justify-content:space-between;align-items:center;gap:1rem}
.brand{font-family:var(--mono);font-size:.85rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--ink);text-decoration:none;
display:inline-flex;align-items:center;gap:.6rem}
.brand i{font-style:normal;color:var(--faint)}
.mark{width:1.15em;height:1.15em;display:block;flex:0 0 auto}
nav a.up{font-family:var(--mono);font-size:.72rem;letter-spacing:.14em;
text-transform:uppercase;color:var(--soft);text-decoration:none}
nav a.up:hover{color:var(--ink)}
h1{font-family:var(--mono);font-size:clamp(2rem,5.4vw,3.4rem);line-height:1.12;
letter-spacing:-.02em;margin:0 0 1.1rem;font-weight:500;text-wrap:balance}
h1 em{font-style:normal;color:var(--faint)}
.lede{color:var(--soft);font-size:1.05rem;max-width:52ch;margin:0 0 2.25rem}
.btns{display:flex;flex-wrap:wrap;gap:.7rem;margin:0 0 .5rem;align-items:center}
.btn{display:inline-flex;align-items:center;gap:.5rem;font-family:var(--mono);
font-size:.72rem;letter-spacing:.14em;text-transform:uppercase;
padding:.8rem 1.4rem;border:1px solid var(--line-hi);border-radius:var(--r);
color:var(--ink);text-decoration:none;background:transparent;cursor:pointer;
line-height:1.2;font-weight:400}
.btn:hover{background:#141414;text-decoration:none;border-color:var(--soft)}
.btn.solid{background:var(--ink);color:#000;border-color:var(--ink)}
.btn.solid:hover{background:#d8d8d4}
.btn .chev{width:.7em;height:.7em;flex:0 0 auto;transition:transform .15s ease}
.btn[aria-expanded="true"] .chev{transform:rotate(180deg)}
/* Copy-prompt selector. Each row copies the prompt for its own target. */
.copy{position:relative;display:inline-flex}
.menu{position:absolute;top:calc(100% + .5rem);left:0;z-index:20;min-width:21rem;
background:var(--panel);border:1px solid var(--line-hi);border-radius:var(--r-soft);
padding:.4rem;display:flex;flex-direction:column;
box-shadow:0 12px 32px rgba(0,0,0,.75)}
.menu[hidden]{display:none}
.mi{display:flex;align-items:center;gap:.7rem;width:100%;text-align:left;
padding:.62rem .8rem;border:0;border-radius:calc(var(--r-soft) - .35rem);
background:transparent;color:var(--ink);font-family:var(--mono);font-size:.76rem;
letter-spacing:.04em;text-decoration:none;cursor:pointer;line-height:1.3;
white-space:nowrap}
.mi:hover,.mi:focus-visible{background:#181818;outline:none}
.mi .mark{width:1.05rem;height:1.05rem;color:var(--soft)}
.mi:hover .mark{color:var(--ink)}
.mi u{margin-left:auto;color:var(--faint);text-decoration:none;font-size:.68rem;
letter-spacing:.1em;text-transform:uppercase}
/* Works-with bar: one scrolling row, name and mark per agent. */
.strip{border-bottom:1px solid var(--line);background:var(--panel)}
.strip .in{max-width:60rem;margin:0 auto;padding:.9rem 1.75rem;display:flex;
align-items:center;gap:1.25rem;font-family:var(--mono);font-size:.72rem;
letter-spacing:.1em;text-transform:uppercase;color:var(--faint)}
.strip b{color:var(--soft);font-weight:400;flex:0 0 auto;
border-right:1px solid var(--line);padding-right:1.25rem;align-self:stretch;
display:flex;align-items:center}
.bar{display:flex;align-items:center;gap:.5rem;flex:1 1 auto;min-width:0;
overflow-x:auto;scrollbar-width:none;scroll-snap-type:x proximity;
-webkit-overflow-scrolling:touch;
-webkit-mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent);
mask-image:linear-gradient(90deg,#000 calc(100% - 3rem),transparent)}
.bar::-webkit-scrollbar{display:none}
.agent{display:inline-flex;align-items:center;gap:.45rem;flex:0 0 auto;
padding:.4rem .85rem;border:1px solid var(--line);border-radius:var(--r);
color:var(--soft);white-space:nowrap;scroll-snap-align:start;
text-decoration:none;background:var(--ground)}
.agent:hover{color:var(--ink);border-color:var(--line-hi);text-decoration:none}
.agent .mark{width:.95rem;height:.95rem}
h2{font-family:var(--mono);font-size:1.1rem;letter-spacing:-.01em;margin:2.75rem 0 .75rem;font-weight:500}
h3{font-size:1rem;margin:2rem 0 .5rem;font-weight:600}
h4,h5,h6{font-size:.94rem;margin:1.5rem 0 .5rem;font-weight:600}
p{margin:0 0 1rem;max-width:70ch}
ul,ol{margin:0 0 1rem;padding-left:1.35rem;max-width:70ch}
li{margin:.22rem 0}
a{color:var(--ink);text-decoration:underline;text-underline-offset:3px;
text-decoration-color:var(--line-hi)}
a:hover{text-decoration-color:var(--ink)}
a:focus-visible{outline:1px solid var(--ink);outline-offset:3px}
code{font-family:var(--mono);font-size:.85em;background:var(--panel);
border:1px solid var(--line);border-radius:5px;padding:.1em .36em}
pre{background:var(--panel);border:1px solid var(--line);padding:1rem 1.1rem;
border-radius:var(--r-soft);overflow-x:auto;margin:0 0 1.25rem}
pre code{background:none;border:0;padding:0;font-size:.82rem;line-height:1.7}
blockquote{margin:0 0 1rem;padding-left:1rem;border-left:1px solid var(--line-hi);color:var(--soft)}
hr{border:0;border-top:1px solid var(--line);margin:2.5rem 0}
table{border-collapse:collapse;width:100%;margin:0 0 1.25rem;font-size:.92rem;
display:block;overflow-x:auto}
th,td{border:1px solid var(--line);padding:.5rem .7rem;text-align:left}
.curl{display:block;background:var(--panel);border:1px solid var(--line);
border-radius:var(--r-soft);padding:.95rem 1.1rem;font-family:var(--mono);
font-size:.8rem;color:var(--soft);overflow-x:auto;margin:0 0 2.5rem;
white-space:pre;line-height:1.9}
.curl b{color:var(--ink);font-weight:400}
.curl i{font-style:normal;color:var(--faint)}
/* index */
#q{width:100%;padding:.85rem 1.2rem;font-family:var(--mono);font-size:.85rem;color:var(--ink);
background:var(--panel);border:1px solid var(--line);border-radius:var(--r);margin:0 0 .6rem}
#q::placeholder{color:var(--faint);text-transform:uppercase;letter-spacing:.1em;font-size:.72rem}
#q:focus{outline:none;border-color:var(--soft)}
#count{color:var(--faint);font-family:var(--mono);font-size:.72rem;letter-spacing:.1em;
text-transform:uppercase;margin:0 0 2rem}
.cat{margin:2.5rem 0 .5rem;font-family:var(--mono);font-size:.7rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);border-bottom:1px solid var(--line);
padding-bottom:.45rem}
.row{display:block;padding:.6rem .9rem;margin:0 -.9rem;border-bottom:1px solid var(--line);
border-radius:var(--r-soft);text-decoration:none}
.row:hover{background:#0a0a0a}
.nm{font-family:var(--mono);font-size:.84rem;color:var(--ink);display:block}
.ds{color:var(--soft);font-size:.9rem;display:block;margin-top:.12rem}
footer{margin-top:4rem;padding:2rem 0 4rem;border-top:1px solid var(--line);
color:var(--faint);font-size:.85rem}
footer a{color:var(--soft)}
.fmap{display:grid;gap:1.75rem;grid-template-columns:repeat(auto-fit,minmax(11rem,1fr));
margin:0 0 2rem;font-size:.85rem}
.fmap b{display:block;font-family:var(--mono);font-size:.68rem;letter-spacing:.16em;
text-transform:uppercase;color:var(--faint);font-weight:400;margin:0 0 .6rem;
border-bottom:1px solid var(--line);padding-bottom:.4rem}
.fmap a{display:inline-block;color:var(--ink);text-decoration:none;margin:.3rem .35rem 0 0}
.fmap a:hover{text-decoration:underline}
.fmap div{color:var(--faint);line-height:1.5}
.fend{border-top:1px solid var(--line);padding-top:1.25rem;font-size:.82rem}
@media (max-width:640px){
.hero .wrap{padding-top:3.25rem;padding-bottom:2.75rem}
.btns{gap:.5rem}
.btn{padding:.75rem 1.15rem;font-size:.68rem}
.copy,.copy .btn{width:100%;justify-content:center}
.menu{left:0;right:0;min-width:0}
.strip .in{flex-direction:column;align-items:flex-start;gap:.6rem;padding:.9rem 1.75rem}
.strip b{border-right:0;padding-right:0}
.bar{width:100%}
}
</style>
<link rel="icon" href="/favicon.svg">
<link rel="canonical" href="https://hanzoskills.com/aarrr-framework">
<link rel="alternate" type="text/markdown" href="/aarrr-framework.md">
<script type="module" src="/webmcp.js"></script>
</head>
<!-- Reading this with a machine? Every page here is also plain markdown.
This one: https://hanzoskills.com/aarrr-framework.md
Index: https://hanzoskills.com/llms.txt
Corpus: https://hanzoskills.com/all.md
Append .md to any path for the markdown twin. -->
<body>
<nav><div class="in">
<a class="brand" href="/"><svg class="mark" viewBox="0 0 67 67" fill="currentColor" aria-hidden="true"><path d="M22.21 67V44.6369H0V67H22.21Z"/><path d="M66.7038 22.3184H22.2534L0.0878906 44.6367H44.4634L66.7038 22.3184Z"/><path d="M22.21 0H0V22.3184H22.21V0Z"/><path d="M66.7198 0H44.5098V22.3184H66.7198V0Z"/><path d="M66.7198 67V44.6369H44.5098V67H66.7198Z"/></svg> HANZO<i>SKILLS</i></a>
<a class="up" href="/">All skills</a>
</div></nav>
<div class="wrap">
<h1>aarrr-framework</h1><p class="lede">AARRR (Dave McClure&#x27;s &quot;pirate metrics&quot;) is the spine of every plan produced by this skill.</p><h1>AARRR Framework — Primer for Plan Sequencing</h1>
<p>AARRR (Dave McClure&#x27;s &quot;pirate metrics&quot;) is the spine of every plan produced by this skill. This doc is the primer + the decision rules for when each stage gets prioritized.</p>
<h2>The five stages</h2>
<p>| Stage | Question | Common metrics | |---|---|---| | <strong>A</strong>cquisition | How do strangers become aware of us? | Visits, MQLs, signup-page sessions, app-store visits, CAC by channel | | <strong>A</strong>ctivation | Once they try us, do they have an experience that converts? | Signup completion rate, time-to-value, % completing first key action, trial → paid rate | | <strong>R</strong>etention | Do they stay and deepen? | DAU/WAU/MAU, week-1/4/12 retention, churn | | <strong>R</strong>eferral | Do retained users bring more users? | Viral coefficient, NPS, ambassador attribution | | <strong>R</strong>evenue | What do they pay, who pays, how does it compound? | ARPU, LTV, expansion revenue, ARR / MRR |</p>
<blockquote><p><strong>Signup boundary rule.</strong> Signup <em>intent</em> (a stranger landing on the signup page) is Acquisition. Signup <em>completion</em> and everything after (first key action, trial-to-paid) is Activation. Apply this rule consistently across all docs and the plan template.</p></blockquote>
<h2>Why AARRR for plan sequencing</h2>
<p>Three reasons.</p>
<p><strong>1. Funnel-stage tagging forces prioritization.</strong> Without AARRR, marketing plans become channel-organized (&quot;here&#x27;s the SEO plan, here&#x27;s the social plan, here&#x27;s the paid plan&quot;). Channels can address multiple stages; tagging by stage instead asks the more useful question: <em>what stage of the funnel is the binding constraint right now?</em></p>
<p><strong>2. Fix the leak before pouring water in.</strong> The Activation/Retention question (&quot;does the funnel convert at acceptable rates given exposure?&quot;) is usually higher leverage than the Acquisition question (&quot;how do we get more exposure?&quot;). AARRR sequencing surfaces this naturally.</p>
<p><strong>3. The Revenue / Referral conversation is honest.</strong> Most marketing plans bury monetization under &quot;growth&quot; and treat referral as wishful thinking. AARRR forces explicit treatment of both.</p>
<h2>Brand and content — not a stage, cross-cutting</h2>
<p>A common mistake: making &quot;Brand&quot; or &quot;Content&quot; the sixth bucket. They&#x27;re not — they serve every stage.</p>
<ul><li><strong>Brand voice</strong> governs every piece of copy across every stage</li><li><strong>Content</strong> feeds Acquisition (SEO, social), Activation (onboarding copy), Retention (email lifecycle), Referral (ambassador talking points), Revenue (pricing pages, sales material)</li></ul>
<p>In the plan, brand/content shows up as the strategic frame (Section 2) and cross-cutting in Section 11&#x27;s ops stack — never as its own AARRR section.</p>
<h2>Diagnosing the binding constraint — which AARRR stage is highest leverage?</h2>
<p>For every client, one or two AARRR stages will be the binding constraint. The plan sequences moves there first.</p>
<p><strong>Decision rules:</strong></p>
<h3>If you don&#x27;t have any users → start with Acquisition</h3>
<ul><li>Pre-launch / day-0 / waitlist stage</li><li>No funnel data exists</li><li>Leverage = building the first 100 users</li></ul>
<h3>If you have users but they bounce → start with Activation</h3>
<ul><li>Signups happen but activation rate is low</li><li>App Store conversion is poor</li><li>Onboarding completion is broken</li><li>Day 1 → paid rate is much lower than Day 30 → paid (means product converts given time but onboarding doesn&#x27;t bridge to it)</li><li>Leverage = bridging signup to first felt value</li></ul>
<h3>If activation works but users churn → start with Retention</h3>
<ul><li>Month 1 retention is below category norms</li><li>Activated users stop using within 7–14 days</li><li>LTV is short</li><li>Leverage = lifecycle, deepening engagement, churn prevention</li></ul>
<h3>If retention is strong but growth is slow → start with Referral / Revenue</h3>
<ul><li>Retained users love the product but don&#x27;t share</li><li>Inbound referrals come in unstructured</li><li>Pricing hasn&#x27;t been pressure-tested</li><li>ARPU is low for the value delivered</li><li>Leverage = WOM mechanics + pricing optimization (these often cluster)</li></ul>
<h3>If everything works at small scale → start with Acquisition (scaling)</h3>
<ul><li>Funnel is healthy</li><li>Question is just &quot;more&quot;</li><li>This is the &quot;post-fit&quot; scaling problem</li></ul>
<h2>Stage-by-stage strategic patterns</h2>
<h3>Acquisition</h3>
<p><strong>The diagnostic question:</strong> Where is the gap between TAM-level awareness and current funnel volume? What channels are saturated by competitors vs. open?</p>
<p><strong>Common Acquisition moves:</strong></p>
<ul><li>SEO content strategy (organic compounding)</li><li>Founder-led channels (LinkedIn, X, Substack for B2B; Instagram/TikTok for D2C)</li><li>Paid acquisition (when budget unlocks)</li><li>App Store / Play Store / marketplace listing optimization</li><li>PR and credibility-anchor amplification</li><li>Events (live, webinar, conference speaking)</li><li>Partnerships (newsletter swaps, integration co-marketing, reseller / agency partners)</li><li>Hardware / commerce surface (Shopify SEO + Amazon for hybrid businesses)</li><li>B2B sales support (case studies, partner pages, vertical content)</li></ul>
<p><strong>Sequencing principle:</strong> Build the organic compound first (SEO + founder-led + content + PR amplification + ambassadors). Only layer paid on top of a working organic baseline. Premature paid amplifies what&#x27;s broken.</p>
<h3>Activation</h3>
<p><strong>The diagnostic question:</strong> Where in the user&#x27;s first session do they decide &quot;this works for me&quot; or &quot;this doesn&#x27;t&quot;? What stops them from reaching that moment?</p>
<p><strong>Common Activation moves:</strong></p>
<ul><li>Bedrock fixes (broken gates, broken signup steps, broken paywall)</li><li>Onboarding tests / rebuild (often the most leveraged single move)</li><li>App Store listing rewrite (the threshold to the trial)</li><li>Lifecycle Flow ship order (when to ship onboarding emails)</li><li>Paywall structure + trial length</li><li>Free → paid bridge (in-app upsells, soft paywalls)</li></ul>
<p><strong>Sequencing principle:</strong> Get to first felt value as fast as possible. Everything that adds friction between &quot;user opens app&quot; and &quot;user has the experience that converts them&quot; is a candidate to cut.</p>
<h3>Retention</h3>
<p><strong>The diagnostic question:</strong> Why do users churn? What would have made them stay? What&#x27;s the &quot;second moment of value&quot; after the first one?</p>
<p><strong>Common Retention moves:</strong></p>
<ul><li>Lifecycle email flows: onboarding, lapsed user re-engagement, post-purchase, win-back</li><li>Subscription / preference centers</li><li>Churn reconciliation (often metric definitions don&#x27;t match across surfaces)</li><li>Hardware → software activation paths (for hybrid businesses)</li><li>Annual plan defaults / pricing structure (cross-cuts Revenue)</li><li>Support as marketing (high-touch moments that drive stories)</li><li>Community + practitioner networks</li></ul>
<p><strong>Sequencing principle:</strong> Ship lifecycle flows in the order their content is most stable. Hardware post-purchase flows ship first (they don&#x27;t reference in-app screens that might change). Onboarding emails ship last (they reference UI that might change). Win-back is a quarterly campaign, not a one-time flow.</p>
<h3>Referral</h3>
<p><strong>The diagnostic question:</strong> Is there inbound referral interest that isn&#x27;t being captured? What&#x27;s the share-after-value moment that&#x27;s natural to the product?</p>
<p><strong>Common Referral moves:</strong></p>
<ul><li>Ambassador / affiliate program (start with inbound interest, not cold recruitment)</li><li>Share-after-value moments built into the product (reflection prompts, milestone celebrations)</li><li>Founder amplification (founder as referrer-zero)</li><li>Long-game expert / Guides / certified-host networks (for category-creating businesses)</li><li>Gifting flows (consumer / hardware)</li><li>Two-sided referrals (reward both referrer and referred)</li></ul>
<p><strong>Sequencing principle:</strong> Lead with whoever is already raising their hand. If there are 5 inbound ambassadors, launch with those 5 — don&#x27;t wait for a &quot;complete program.&quot; Iterate based on what they tell you.</p>
<h3>Revenue</h3>
<p><strong>The diagnostic question:</strong> Is the company underpricing? Underpackaging? Missing an upsell? What&#x27;s the &quot;right&quot; price discipline given LTV and brand voice?</p>
<p><strong>Common Revenue moves:</strong></p>
<ul><li>Pricing audit (what&#x27;s actually charged today vs. listed?)</li><li>Annual plan defaults</li><li>Hardware → software bundling formalization</li><li>Storefront / commerce page optimization</li><li>B2B case studies + sales material</li><li>Long-term value pool flags (data, expansion, enterprise) — flagged not executed</li></ul>
<p><strong>Sequencing principle:</strong> Run the pricing audit before testing changes. Surprisingly often, the &quot;implied&quot; pricing on the dashboard doesn&#x27;t match the listed price — discounts, trials, or plan mix distorts the read. Surface the ground truth first.</p>
<h2>How to assign a move to a stage</h2>
<p>Some moves clearly belong to one stage. Others span. The rule:</p>
<p><strong>Assign to the stage where the move&#x27;s primary measurable impact lands.</strong></p>
<p>Examples:</p>
<ul><li>&quot;Rewrite App Store listing in voice&quot; — spans Acquisition (organic discovery) and Activation (threshold to trial). Primary impact = Activation (trial conversion rate). Assign to Activation, mention crossover.</li><li>&quot;Eye mask Shopify page rewrite&quot; — spans Acquisition (organic search for sleep mask) and Revenue (sale conversion). Primary impact = Revenue (transaction). Assign to Revenue, mention crossover.</li><li>&quot;Alex&#x27;s LinkedIn cadence&quot; — Acquisition (top of funnel for D2C subscribers).</li><li>&quot;Customer.io Flow 6 (eye mask post-purchase)&quot; — Retention (deepens hardware buyer engagement) with crossover to Activation (hardware → app premium activation path).</li></ul>
<p>When in doubt: where would removing this move hurt the most? Assign there.</p>
<h2>When the AARRR breakdown isn&#x27;t equal</h2>
<p>For most clients, the plan won&#x27;t have equal volume across stages. That&#x27;s fine — and worth surfacing as a diagnostic.</p>
<ul><li><strong>Heavy Acquisition section</strong> = client has product-market fit but top-of-funnel is the bottleneck. Common for early-stage with strong retention metrics.</li><li><strong>Heavy Activation section</strong> = client has traffic but conversion is broken. Often beta-stage products.</li><li><strong>Heavy Retention section</strong> = client has churn problem. Often mid-stage products that scaled past PMF without lifecycle infrastructure.</li><li><strong>Heavy Referral section</strong> = client has loyalty but no WOM mechanics. Often consumer products with passionate users.</li><li><strong>Heavy Revenue section</strong> = client is underpricing or missing monetization layers. Common for tools transitioning from free to paid.</li></ul>
<p>If a plan ends up evenly distributed across all five stages, the diagnostic was probably weak — re-examine the funnel state intake to find where the binding constraint is.</p>
<h2>A note on the order of presentation</h2>
<p>Always present AARRR in order (Acquisition → Activation → Retention → Referral → Revenue) regardless of priority order.</p>
<p>This is for the reader&#x27;s mental model. Founders expect the funnel to flow top-to-bottom. If Retention is the most-leveraged stage but you lead with Retention, the reader has to context-switch.</p>
<p>To signal priority, use the executive summary (Section 1) — name the biggest bets there. The AARRR breakdown then walks the funnel in order, with the most leverage-positive section being the longest and most-detailed.</p>
<footer>
<div class="fmap">
<div><b>Build</b>
<a href="https://hanzo.app">hanzo.app</a> app builder
<a href="https://hanzo.codes">hanzo.codes</a> code with an agent
<a href="https://hanzoskills.com">hanzoskills.com</a> what an agent reads</div>
<div><b>Run</b>
<a href="https://console.hanzo.ai">console.hanzo.ai</a> cloud console
<a href="https://api.hanzo.ai">api.hanzo.ai</a> the API</div>
<div><b>Account</b>
<a href="https://hanzo.id">hanzo.id</a> sign in
<a href="https://pay.hanzo.ai">pay.hanzo.ai</a> top up
<a href="https://billing.hanzo.ai">billing.hanzo.ai</a> invoices and usage</div>
<div><b>Company</b>
<a href="https://hanzo.ai">hanzo.ai</a> canonical
<a href="https://hanzo.ventures">hanzo.ventures</a> ventures</div>
</div>
<div class="fend"><a href="/aarrr-framework.md">This page as plain text</a> · <a href="/llms.txt">Index for agents</a></div>
</footer>
</div></body></html>