HomeZero · site spec · 2026-06-24

The Read-Led Cutover

The board and the launchpad still wear the old money dashboard — a price slider, per-card affordability meters, a UI-derived score, and (newest sin) a confidence-bar chart. Funnel-v2 killed all of that. This is the cutover that finally lands it: the read leads, the agents speak in their own voice, and the money math comes off the surface.

72% of homes here are caution-or-overpriced — 13 overpriced + 18 caution of 43. Only 2 are “good.” A budget slider tells you what you can afford. The read tells you that almost nothing on this market is honestly priced — which is the thing a buyer actually needs to know. Lead with the read. funnel-v2.html §07 — the sharp proof

Two surfaces change, plus one shared idea about who talks how:

• The board goes read-led: cards lead with the verdict, the money UI comes off, and the advisor’s “what I’m learning about you” stops being a chart and becomes a short prose note in its voice.
• The launchpad gets its §06 redesign: an install hero, a WhatsApp sub-card, and the market agent’s daily Market Report billboard.
• Two voices, kept distinct: the advisor speaks in prose (its read of you); the market agent speaks in numbers (the billboard). My confidence-bar panel blurred the two — it dressed the advisor up as a dashboard. It shouldn’t exist.

The principle

Verdict (category + headline) leads every card. The number is not the story; the read is. Budget = a quiet filter on the board, not a per-card hero. Carry/footing → a “Run your numbers” workbench, off the cards. funnel-v2.html §07 — locked decisions

Killed: the money slider. One data point was hijacking every card — a parlor trick. Affordability is one input, not the headline. It comes off the cards. funnel-v2.html §07 — the kill

The greeting at the top is the agent simply talking to you. No “advisor:” label, no quotes, no “written by” line. It just is your agent. funnel-v2.html §06 — the advisor voice

Surface 1 — the board, read-led

Everything money-as-hero comes off. Cards lead with the verdict read. The advisor’s message becomes prose.

What comes off remove

• The Footing slider — the whole .footing block (drag-a-ceiling + within/stretch/over tally).
• Per-card affordability meters — the within/stretch/over band label + the .meter widget on every home card.
• The HomeZero score — the per-card .kscore number; it was UI-derived from the verdict + slider, exactly the parlor trick the spec kills.
• The confidence-bar learning panel — the .lpanel chart I just shipped (replaced by prose below).
• The dead money code — affordBandNum, meterPct, homeZeroScore, BUDGET_CEIL, SCORE_BASE/LABEL, the ceiling/tally state, the budget derivation.

What the card becomes keep / lead with

[overpriced] A genuine cabin, an optimistic price — 41014 Beaver Trail — $509k
[caution] Walkable, chasing the market down — 57 Cedar Drive — $625k
[fair] An honest price, finally — 613 3rd Street — $306k
[good] Honest price, heart of town — 229 Colorado Ave — $425k funnel-v2.html §07 — the read-led card mock

The verdict chip + headline lead; the address and price are the footnote. No slider, no meter, no score. Price stays as a quiet fact, never the hero.

Surface 1b — the advisor’s message becomes prose

The “What I’m learning about you” panel renders as a chart of confidence bars today. It should be the advisor talking — a short paragraph, maybe a bullet or two, in its voice, no “advisor:” label. The bars were the same money-dashboard instinct in a new spot.

How it’s sourced

Reuse the learningPanels pipeline that 1B/1C already built (the table, the public-safe query field on cardsForUser, the no-private-data guard). Change its shape and author:

• Shape: from items: [{label, confidence}] → an advisor-authored read: { summary: string, points: string[] } (still public-safe — buyer-facing prose, never the private prompt/why).
• Author: the advisor composes the prose in its tend/dream loop. Swap the deterministic project_learning (bars from yearnings) for project_read — the model writes 1–2 sentences + up to ~3 short bullets, in its voice, from its yearnings.
• Render: the board shows the paragraph + bullets where the chart was, with the quiet ✦ mark — no “advisor:” label, no “written by” line.
• The brain is unchanged: the structured yearnings still live in Turso and still drive scout/dream. We stop charting them; the advisor narrates them instead.

Surface 2 — the launchpad (§06)

The activation-first /home. Order is fixed for now (the agent can make it fluid later). Each piece below is from funnel-v2 §06 + launchpad-redesign.html.

1 · Greeting prose, no label

Morning — the North Fork’s soft right now: 13 homes priced over the record, but 229 Colorado Ave ($425k) is the real thing. Want me to start there? launchpad-redesign.html — the greeting (advisor voice; same session as WhatsApp + board)

2 · Install hero build

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.

3 · WhatsApp sub-card build

A typeable number field + Connect (moved here out of onboarding). “Your advisor texts a short morning briefing and live alerts on the homes you’re watching — the same thread it greets you in up top.”

4 · Market Report billboard build market agent · numbers, not prose

The market agent’s daily billboard — white tiles, centered, big bold Fraunces numbers. Data-light. Five seed tiles:

5 · Board intro + mini-preview build

The board is introduced here; opening it is the next step. The mini-preview must be read-led too — kill the current foot-bar mock + within/over chips; show verdict headlines.

6 · Workbenches placeholders, “Soon”

“Run your numbers,” “Compare homes,” “Your shortlist” — marked Soon. “Run your numbers” is where the carry/footing math lands when it’s built — that’s the home the money slider moves to.

7 · Team roster keep

Your advisor · the North Fork Valley market agent — the roster already on /home.

Out of scope (this cutover)

• The “Run your numbers” workbench. Stays a “Soon” placeholder. Money fully leaves the board now; its eventual home is the workbench. (Pete: take it all off now — the verdict carries the value signal.)
• Market-agent-authored billboard. Start with a live Convex query; hand authorship to the market agent later.
• WhatsApp send path. The sub-card captures the number + opt-in; the actual outbound briefing (the deferred morningBrief) is its own slice.

Build slices (the plan will detail)

Decisions (locked 2026-06-24)