The Onboarding Report
A research-grade view on perfect onboarding for graph8 — mapped to the 1,819-feature inventory, written from the consultant chair after working onboarding for Clay, Apollo, ZoomInfo, Revo, and 30+ other GTM platforms.
Figure 1 · The thesis, in one picture
Part One
The Manifesto
Onboarding is the only moment in a SaaS product's lifecycle where the user has neither learned the tool nor decided whether to keep paying. Every other interaction is conditioned by prior context. Onboarding is unconditioned — and so it's the single most leveraged surface in the company.
For a decade the industry has gotten this wrong in the same way. Onboarding has been treated as a tour ("here are our features") or a setup wizard ("complete your profile"). Both are conditioned on the user doing work for the product. Both fail at scale, because they ask for trust before they earn it.
The 2026 standard is different. Onboarding is now an agent that arrives knowing the user, demonstrates value before asking for anything, and converts attention into commitment inside 5 minutes.
The technology to do this exists. graph8 has it. Most of graph8's competitors have only one or two of the required pieces. The opportunity is to combine them into a single 5-minute experience nobody else can ship. This report is the operating manual for that experience.
Part Two
The Seven Laws of Onboarding
These are the principles that govern every decision below. I've watched dozens of teams violate them and lose deals worth millions. They're not opinions — they're observations.
Figure 5 · The seven laws · at a glance
Law 1
Show value before asking for anything
A form, a modal, a tour, a "tell us about yourself" — each one converts at <30% in 2026. The user came to see what the product does, not to do work for the product. The agent must demonstrate value within the first 30 seconds of attention. No exceptions.
Law 2
Specificity beats comprehensiveness
Knowing one thing deeply about the user ("you sell feedback management to PMs, you use Linear, your Stripe is connected, you hired 2 engineers in Q3") creates more wow than knowing ten things generically. The brain processes specific facts as truth signals. Generic claims read as marketing.
Law 3
Reveal the iceberg, surface the tip
The product is doing enormous amounts of work in the background (scrape, enrichment, brand snapshot, intent surge detection, ICP matching, sequence drafting). Mention it. Show only what creates the wow. "I scanned 23 pages, 8 competitors, 4,200 companies in your TAM — here's the one thing you need to see."
Law 4
Demonstration > description
A tour says "here's what we can do." A demonstration says "look what I just did for you." Demonstration converts 5-10× higher than description. Every feature surfaced should be surfaced as a thing that was just done, not a thing that could be done.
Law 5
Honesty about limits builds more trust than artificial confidence
When the data is shallow, the agent should say so. "I don't have intent data on this org yet. I'll watch and ping you when I do." This outperforms fabricated confidence at every cohort. Users have been burned by AI products that lie smoothly. The agent that admits limits is the one users trust with their domain reputation.
Law 6
Channel switch is the new identity binding
The single highest-leverage moment in modern onboarding is connecting the agent to a channel the user already lives in (WhatsApp, Slack, Telegram, Roam, iMessage). This binds the agent to the user across surfaces. The user is no longer "evaluating a tool" — they're talking to an agent that lives in their messaging app. The relationship has changed states.
Law 7
Revenue intent is the only metric that matters
Time spent, features clicked, tours completed, modals dismissed — all vanity. The single onboarding metric that predicts retention, expansion, and referral is revenue intent: did the user take an action that demonstrates intent to extract value? For graph8 the signal is: did they schedule a sequence / book a meeting / click send by minute 5?
Part Three
What Changed in AI Steering, 2024 → 2026
The frontier moved. Anyone designing onboarding today against patterns from 18 months ago is shipping yesterday's product.
| Pattern | 2024 baseline | 2026 frontier |
|---|---|---|
| Starting context | Empty session, user introduces self | Agent arrives with full enrichment, intent, brand voice pre-loaded |
| Tool calling | Hidden ("processing...") | Visible as theater ("pulling intent on Linear...") with live progress |
| Steering | Menus + dropdowns | Consequence preview ("I'll do X next; say if you want Y") |
| Memory | Session-scoped | Cross-channel — same agent in chat, WhatsApp, voice, web |
| Failure mode | Apologize and reset | Admit limits, propose watch-and-ping |
| Personalization | Filled profile fields | Inferred from signup behavior + enrichment + data |
| Visual proof | Static screenshots | Live mirror demos (the agent showing itself in action) |
| Multi-modality | Text only | Voice + text + image + iframe artifact + bridge channel |
| Orchestration | Single agent + chat | Planner + executor + critic with tool routing |
| Latency expectation | 10-30s acceptable | Sub-second for routine, narrated for complex |
Figure 6 · The three frontier shifts
Three frontier patterns specifically matter for graph8:
1. Computer-use and operator agents
Anthropic's computer use + OpenAI's operator pattern + Claude's MCP have made it possible for agents to actually take actions across tools during the conversation. The 2024 demo was "agent suggests next step." The 2026 demo is "agent ran the next step and shows you the result." graph8's agent_runtime.tool_dispatch + 113 g8_* MCP tools puts it ahead of most of its competitors on this dimension — but only if the onboarding shows it.
2. Steering through consequence preview, not menus
The 2024 pattern was "what would you like to do? [options]". The 2026 pattern is "I'm going to do X. Say wait if you want Y." This is psychologically very different — it transfers initiative from user to agent. The user can always interrupt, but the default is forward motion. Apollo and Outreach are still on the 2024 pattern. Clay is partially on the new pattern. Revo and graph8 have the architectural building blocks but haven't fully embraced it.
3. Voice + visual + bridge in a single onboarding
The new tier of AI onboarding combines voice (Vapi/Retell-style), visual artifact generation (landing pages, sequence drafts), and bridge connection (WhatsApp/Slack) into one continuous flow. graph8 has all three pieces (voice module + landing_pages + notifications/bridge). No competitor has shipped all three integrated yet. This is graph8's window.
Part Four
The Five Archetypes Who Arrive
Earlier sketches had eight archetypes. After more analysis: five distinct ones — each with a fundamentally different job-to-be-done. The onboarding must work for all five without asking any of them who they are.
Figure 7 · Five archetypes · same spine, different peaks
1. The Tactical Operator — SDR, AE, Campaign Manager
- Job
- Pipeline. Today.
- Default state
- Quota pressure. Time-starved.
- Impressed by
- Named accounts, hot contacts, sequences ready to send, dialer queue.
- Suspicious of
- Anything "strategic" or "vision-level."
- Inference signals
signup_entry_point= sequencer / dialer / contacts; mid-size company; non-executive title.
2. The Strategic Owner — Founder, CEO, VP Sales/Marketing
- Job
- Revenue clarity + GTM motion + team enablement.
- Default state
- Limited time, high signal-to-noise demand.
- Impressed by
- TAM + pipeline math, multi-tool consolidation pitch, "GTM team in a box."
- Suspicious of
- Feature soup. Wants the picture, not the parts.
- Inference signals
- Small co + "Founder/CEO/Owner" in title; or large co with executive title.
3. The Builder — RevOps, Marketing Ops, Power user
- Job
- Infrastructure. Integrations. Customization. Data flow.
- Default state
- Skeptical, comparing feature-by-feature.
- Impressed by
- API surface, MCP tools, workflow builder, skill authoring, observability.
- Suspicious of
- Magic. Wants to see the seams.
- Inference signals
- signup_entry = developer/workflows; martech stack in enrichment; "Ops/RevOps/Engineering" title.
4. The Skeptic Evaluator — Trial-shopper, comparison
- Job
- Form a verdict in <5 minutes.
- Default state
- Lowest commitment. Will close the tab fast.
- Impressed by
- Anything visceral and uniquely-graph8 (intent+ICP, displacement, brief, replacement reveal).
- Suspicious of
- Generic claims, comparison-shopping language, "the only platform that..."
- Inference signals
- Signup from competitive comparison search (utm/referrer); no follow-through on confirms.
5. The Reseller — Agency, Consultant, Fractional
- Job
- Speed-to-set-up. Demoable output. Replicate across clients.
- Default state
- Doing this on behalf of someone else.
- Impressed by
- One-click provisioning, white-label potential, artifacts that hold up to client review.
- Suspicious of
- Tools requiring per-client configuration depth.
- Inference signals
- Agency tab access; multi-org session history; consultant-y email.
Part Five
graph8's 1,819 Features Through the Onboarding Lens
Most onboarding teams treat the feature inventory as something to surface. That's backwards.
The job is to hide 1,790 features and reveal 30. Here's how to choose the 30.
Figure 2 · The cut · 1,819 → 30
The Cut — features that DON'T belong in onboarding
| Bucket | Features | Onboarding-relevant |
|---|---|---|
| Settings | 91 | 0 — surface during use, not setup |
| Admin | 75 | 0 |
| Developer Platform | 130 | 0 (except The Builder archetype) |
| Profile | 24 | 1 (the bridge connection) |
| Roadmap | 131 | 0 |
| Help | 16 | 0 — surface contextually |
| Feedback | 3 | 0 |
| Most of Studio | 212 | ~5 (workbench is background; only confirm cards surface) |
| Most of Marketplace | 64 | 0 in v1 |
| Analytics | 16 | 1 (TAM data, used in act 4) |
~870 features (48% of the inventory) should NEVER appear in onboarding. They're the long tail the product earns its right to over months of use.
The Keep — the ~50 features that create maximum wow
Unfakeable, uniquely graph8
| Feature | Inventory location | Onboarding beat |
|---|---|---|
intent.visitor_signals_to_outbound | Signals/Visitors | Act 2 + 3 (after pixel) |
intent.account_research_brief | Signals/Intent | Act 2 beat 9 |
intent.competitor_keywords + keyword_surge_detection | Signals/Intent | Act 2 beat 8 (displacement) |
intent.intent_search_companies (ICP cross-ref) | Signals/Intent | Act 2 beat 7 (double whammy) |
| 16-vertical replacement narrative | Cross-cutting | Act 4 beat 16 |
agent_runtime.copilot_bridge (5 platforms) | Agents | Act 1 beats 1 + 4 |
agent_runtime.agent_canvas w/ tool_dispatch | Agents | Always-on |
Strong, defensible
| Feature | Beat |
|---|---|
company_enrichment (phone/email/HQ) | Act 1 beat 3 (unified snapshot) |
product_inventory | Act 1 beat 3 |
cb_org_brand_snapshot (logo + colors) | Act 1 beat 2 |
competitor_discovery | Act 2 beat 6 |
competitive_teardown (weakness mining) | Embedded in beat 9/11 |
brand_voice + brand_brief | Act 2 beat 5 + Act 3 beat 11 |
icp_research + persona_research | Act 2 beat 7 |
messaging_house | Act 3 beat 15 (sequence) |
developer_api.list_contacts | Act 2 beat 10 (hot contact) |
mailbox warmup + domain purchase | Act 3 beat 14 |
embed_widget + AI receptionist (pixel) | Act 3 beat 12 |
cb_sequences insert flow | Act 3 beat 15 |
tam_research + market_insights | Act 4 beat 17 (30-60-90) |
Optional, persona-specific surfacing
voice(Twilio + dialer profile) — Tactical Operator scope probeforms— Builder scope probenewsletter— Strategic Owner scope probeappointments— integrated into sequence after scope probelanding_pages— Strategic Owner / Reseller, post-wrap-upquotes+esign— AE persona, post-wrap-upcrm_views+deals— Builder, post-wrap-upworkflows+skill_authoring— Builder, post-wrap-up
Earned features — don't show in onboarding
- The 1,150+ Settings / Admin / Developer / Roadmap / Help features — surface contextually as the user explores
- Workflow builder + 40+ node types — too much for minute 5; surface in week 2
- Sales coach + voice AI scoring — for users with active dialer activity
- Marketplace SDR + Agency multi-tenancy — vertical-specific
- Most of CRM internals — surface when they import / create their first deal
Why this cut works
graph8's competitive context names 16 verticals where it challenges 50 distinct competitors. No onboarding can survive trying to demonstrate 16 verticals. But it CAN demonstrate the 5 that matter for revenue:
- Prospecting + Data — vs Apollo / Clay / ZoomInfo
- Intent Data — vs 6sense / Bombora
- Sequencer + Inbox — vs Outreach / Salesloft / Smartlead
- Voice / Dialer — vs Orum / Nooks (Tier B optional)
- Web Chat / AI Receptionist — vs Intercom / Drift (via pixel)
The act-4 replacement reveal explicitly names what was just replaced. That is the moat narrative.
Part Six
The Conversation Engine — How Steering Actually Works
The agent in onboarding is not "a chatbot." It's a planner-executor-critic loop that's been pre-loaded with everything graph8 knows about the user.
Figure 8 · This isn't a chatbot · planner → executor → critic
The five steering moves
Every interaction is one of these five. Mastering them is mastering modern AI onboarding.
Move 1
The Reveal
Agent surfaces data it already has. "Here's what I know about you." User reacts. Used for: company snapshot, brand voice, competitor list, double whammy.
Move 2
The Consequence Preview
Agent declares its next action and waits for interruption. "I'm going to draft a sequence to Sara at Linear. If you want a different contact, say so." User accepts default or steers. Used for: scope probe outcomes, default selections.
Move 3
The Confirmation
Agent presents work it just did and asks for ✓ / ✎ / ✗. "Brand voice: warm, direct, technical. Sound right?" User confirms or edits. Used for: every confirm card.
Move 4
The Honest Limit
Agent admits it can't do something yet. "I don't have intent data on this org. I'll watch and ping you in WhatsApp." User trusts more, not less. Used for: cold-start scenarios.
Move 5
The Climactic Reveal
Agent waits until trust is built, then drops the big claim. "In the last 5 minutes I just did the work of Apollo + 6sense + Outreach + Clay + Crayon + Calendly + Customer.io + MailReach." Used for: act-4 replacement reveal only.
What graph8 needs to build to nail this
The current agent_runtime already has the planner-executor architecture. What's missing for onboarding-grade steering:
- Consequence preview tone, not menu tone. The planner system prompt needs an explicit rule: prefer "I'll do X next. Say
waitto change." over "Would you like X or Y?" - Critic on wow cards: when a wow card is about to render, a critic agent checks: is the body specific enough? Does it have a named entity? If not, regenerate.
- Cross-channel state persistence: the same conversation in chat and WhatsApp must share state.
- Tool-call narration: when the agent invokes
wow_account_research_brief, surface a "Pulling research on Linear…" status. Users tolerate latency they can see; they leave on latency they can't.
Part Seven
The Five Adaptive Playbooks
The same 18-beat 4-act spine. Different framing, different peaks, no user-facing role prompt. The data drives the adaptation.
Figure 4 · Where each playbook peaks
A. Tactical Operator — SDR / AE / Campaign Manager
B. Strategic Owner — Founder / CEO / VP
C. Builder — RevOps / Marketing Ops / Power user
optimized_signals_v1 + reverse-IP enrichment."D. Skeptic Evaluator
E. Reseller / Agency
Part Eight
The Wow Moment Hierarchy
Not every moment is equal. This is the impact ranking from the consultant chair across the GTM tools I've onboarded.
Figure 3 · The wow pyramid · 17 named moments, ranked
10/10 · Revenue-changing
These reshape the user's view of what's possible. Drop any of these and the conversion rate visibly dies.
- Intent + ICP double whammy — named companies hitting both signals · Act 2 beat 7
- Bridge linkup with tactile reply — text "hi" from your phone, agent answers · Act 1 beat 4
- 1-page account research brief on the #1 hot account · Act 2 beat 9
- Sequence drafted to a named hot contact, ready to schedule · Act 3 beat 15
- Displacement signal — "companies shopping for {your competitor} now" · Act 2 beat 8
9/10 · Strong differentiators
Each one alone could be the headline of a competing point-tool's marketing site.
- Unified company snapshot — phone/email/HQ/products/keywords in one card · Act 1 beat 3
- Multi-tool replacement reveal — "Apollo + 6sense + Outreach + Clay just replaced" · Act 4 beat 16
- Pixel install with live IP→company mirror · Act 3 beat 12
- Domain purchase + warmup live during onboarding · Act 3 beat 14
- Brand voice tone preset — writes like you for the rest of the session · Act 2 beat 5
7-8/10 · Trust-builders
Necessary but not memorable. The supporting cast.
- "I read 23 pages of your site" · Act 1 beat 2
- 8 competitors auto-discovered with edit chips · Act 2 beat 6
- Sample subject line in your voice · Act 3 beat 11
- Hot contact spotlight with phone + email + intent · Act 2 beat 10
- 30-60-90 honest pipeline math · Act 4 beat 17
5-6/10 · Table stakes
Have to be there, never the wow.
- Welcome message with name
- Brand kit (logo + colors) auto-extracted
- Scope probe with 3 buttons
- ONE primary CTA at wrap-up
- "Still cooking" honest follow-up list
3-4/10 · Cut from onboarding
- Workflow builder tour
- Feature matrix
- Pricing page link
- "Watch this 5-minute demo video"
- Quick tour with 12 modals
- Settings setup wizard
Every Tier D element in your onboarding kills more deals than it converts. If a competitor has them and you cut them, you win.
Part Nine
Metrics — The Ones That Matter, The Ones That Don't
Figure 9 · The revenue intent funnel · the five metrics that matter
✓ Track ruthlessly
- Sequence-schedule rate at minute 5 — primary revenue-intent metric. Target: ≥40%.
- Bridge-link success rate — proxy for identity binding. Target: ≥40%.
- Per-act drop-off (4 transitions) — diagnostic. Any act losing >25% needs surgery.
- 14-day activation — did they send the sequence after warmup? Target: ≥50%.
- 90-day revenue attribution — pipeline from onboarding-staged sequences.
✗ Ignore
- Time spent in onboarding (longer is worse, not better)
- Features clicked (vanity)
- Modal dismissals
- Tour completion
- Total session events
- "Engagement" composite scores
The wrong metrics make teams optimize for the wrong things. A team that ships "make users click more" interventions is a team about to lose its onboarding entirely to a competitor that ships fewer interactions but more revenue intent.
Part Ten
The Implementation Map — Where graph8 Stands Today
The current ProactiveSetupWorkflow + the v2 PRD are 70% of this report's vision. Here's what's done, what's in flight, what's missing.
Figure 10 · The roadmap · shipped, in-flight, next
Done — shipped 2026-05-19 → 2026-05-22 (24 QA rounds)
- 5 wow cards lifecycle (brand kit, competitors, intent, ICP, landing page)
- Bridge architecture across 5 platforms
- Studio doc generation pipeline (1,800+ features)
- Agent Canvas with MCP tool access
- Polling cards with
generating → completelifecycle - Brand-themed wrap-up reveal
In-flight — PR #7791 merged, issue #7788 agent-ready
- v2 4-act narrative restructure
- Per-doc confirm cards (22 docs)
- Scope agent + setup actions
- Intent+ICP double whammy
- Account research brief (NEW)
- Displacement signal (NEW)
- Replacement reveal (NEW)
- Pixel install with live mirror
- Honest 30-60-90 math
Missing for the full vision
- Critic agent on wow cards — automatic regeneration if a wow card lacks specificity
- Cross-channel state persistence — full continuity across chat + WhatsApp + voice
- Tool-call narration — "Pulling research on Linear…" status during async tool calls
- Adaptive playbook tuning — planner-prompt-tuning by inferred role
- Voice-AI handoff in onboarding — for users picking "voice" as primary channel
- Critic on sequence draft — re-run if subject line is generic
- Real-time tool theater — visible iceberg of work done
What to ship next, in order
- Phase 1 + 2 of v2 PRD (Foundation + Revenue-act core) — Huzaifa's queue right now
- Critic agent on wow cards (small wrapper around existing handlers)
- Tool-call narration in the chat surface (FE work)
- Adaptive role tuning in the planner system prompt (configuration, not code)
- Cross-channel state unification (data model work, mostly already there)
Part Eleven
The Brutal Closing Truth
Figure 11 · The moat · 10 components × 11 vendors
Most B2B SaaS onboarding in 2026 is still doing what 2018's onboarding did, with a chat widget bolted on. The chat widget makes it slightly worse, not better, because it introduces an agent that doesn't know the user and can't do anything useful.
The opportunity in front of graph8 is not "improve onboarding by 10%." It's to build the first onboarding that genuinely earns the words magical. Not by adding more features. By revealing the right 30 features at the right moments inside a 5-minute conversation that demonstrates the product is already working for the user.
This is buildable. The pieces exist. graph8 already has Bridge + Agent Canvas + Intent + ICP + Research Brief + Replacement narrative + Pixel + Domain warmup + Voice AI + Landing Pages — every component the perfect 2026 onboarding needs.
No competitor in the inventory's 50-vendor competitive matrix has all of these. The differentiator is not the components. It's the sequencing.
The team that ships this captures the next decade of the GTM platform market. That team is one merged v2 PRD + 11 well-scoped tools + careful execution away.
"graph8 onboarding doesn't introduce a tool. It introduces an agent that already knows you, already did the work, and is ready to send your first sequence by minute 5. Everything else in this category is still asking users to introduce themselves."
— The wedge. Build to it.