Funnel v2

The whole HomeZero funnel, end to end — one canonical design after a week of live iteration.

HomeZero · 2026-06-23 · market under build: North Fork Valley (Paonia · Hotchkiss · Crawford · Somerset) · only Paonia 81428 in Convex today · siblings: launchpad-redesign · onboarding-smoke-test

02 Two-form onboarding

Onboarding asks for two different things and keeps them apart on purpose. One form feeds your advisor — a relationship of one-to-one. The other feeds the market agent — which reads every user's answer in aggregate. The split is the design: your advisor reads yours alone; the market pools everyone's, and that pool is a demand signal.

03 The resolver — a tiny, fast agentic workflow

The place a user types has to become a market in the time it takes to tab to the next field. So the resolver is deterministic-first and only reaches for an agent when it has to.

The path

1. Deterministic match (the hot path). Compare the typed place against the known markets table — names, aliases, ZIPs, town lists. A hit resolves instantly. No LLM in the onboarding hot path.
2. Agent on miss (only). No deterministic hit → a tiny Flue workflow runs: classify the place, decide near-miss vs. out-of-bounds. This is exactly the "run a tiny fast workflow" slot in the Flue framework.

04 Reflection — the market billboard

Step 1 of onboarding doesn't just accept the place — it reflects the market agent's read back. Type "Paonia," and the screen answers "We read North Fork Valley" and unfurls a mini dashboard of real numbers. This is the keystone moment: the entire resolver-plus-market pipeline firing in one screen, before the user has spent a dime or made an account.

05 The daily-alarm metric skill

Those numbers don't come from a hand-edit. The market agent owns them — because market-wide numbers are shared, they belong to the shared agent, not the private advisor. The agent has a skill that runs on the Flue cron alarm and rewrites the billboard once a day.

// Flue DO — billing-safe scheduled work, never `claude -p`
cron: "0 9 * * *"          // daily 09:00
  → scheduled handler fires
  → self-dispatch: { kind: 'metrics' }
  → skill: recompute key numbers from Convex listings
           (on market · typical asking · median DOM · over-the-record · honest deals)
  → write to the billboard / board

06 The launchpad /home — activation-first

After Finish, /home is an activation surface, not a dashboard. Two goals, in order: (1) install the Chrome extension, (2) connect WhatsApp. Everything else is secondary. The built visual lives in launchpad-redesign.html.

• Install hero, claude.ai/downloads styling. Dark Install button on the left; on the right, a live Zillow+HomeZero preview of a real listing — 318 3rd St, $615,000 — so the value is obvious before the click.
• WhatsApp subcard. A typeable number field + Connect. Moved here out of onboarding.
• Market Report widget. A teaser of the daily billboard — white tiles, centered, big bold Fraunces numbers (the §4 mock).
• Board as the entry. The board is introduced here; opening it is the next step.
• Workbenches are placeholders ("Run your numbers," "Compare homes," "Your shortlist") — marked Soon.

07 The board — read-led

Cards now lead with the read: the verdict's category chip and headline, first. Budget becomes a quiet filter, not a hero element. The carry/footing math moves off the cards into a "Run your numbers" workbench, where someone goes when they want it — not in their face on every tile.

08 One advisor, many windows

There is one relationship, surfaced in three places. The launchpad greeting, the WhatsApp thread, and the questions on a board card are the same conversation session. The user never re-introduces themselves; the agent always has a way to reach them.

09 Real data everywhere

Every number on every user-facing surface is computed live from Convex listings — 46 listings, 43 active in Paonia. No invented content on anything public-facing. No individual people's names (institutional names are fine).

• Reflection tiles — computed now: 43 on the market · $599k typical · 58d median DOM · 13 over the record · 2 honest deals.
• Board cards — bound to real listings rows and their cell-authored verdict (category + headline). The "scores" you saw in v1 were UI-derived and are gone with the slider.
• Launchpad preview — a real listing (318 3rd St, $615,000).

10 The mechanical cutover (building now)

Three changes are being implemented in parallel with this spec. None need more design — they're plumbing.

Acceptance gate: the onboarding smoke test runs at the end of every build. Green there = the funnel is alive.

11 Status — per surface

The two siblings

HomeZero · Funnel v2 · 2026-06-23 · canonical funnel design. Resolver + reflection + two-form onboarding + daily metric skill + activation launchpad + read-led board + one-session advisor. Build via the smoke test as the gate. Published to docs.cells.md/funnel-v2.