HomeZero The whole shelf, in one place —
and what's left before launch.
The Wiki · v2026.06.24

Every doc, where it stands, and what's left to build.

One index over ~50 specs, designs, and plans — sorted by whether they still govern the work or just record how we got here. It opens with where we actually are today (which the roadmap, written two days before the Flue pivot, no longer shows), lays out the launch path, and links every doc in the tree.

~50 docs indexed Anchors roadmap.html · the launch path below Era Flue · post-1C Links relative — click through
You are here · 2026-06-24

The advisor is alive. The market is the long pole.

We are on Flue — the whole agent fleet runs as Cloudflare Durable Objects, cells retired. The advisor agent is live and self-driving (born from a real intake, a private Turso brain, hourly tend + nightly scout + dream). The market agent runs a thin slice for one market (sweep → Turso → cards → briefing-on-zero). Everything else is funnel polish, market depth, and — the new long pole — nineteen more market agents.

Reframe, 2026-06-24: we launch in 20 hand-selected markets, each market agent built bespoke. "Born-anywhere" market birth — the biggest item on the old roadmap — is off the launch path. A general "stand one up anywhere" process may fall out of doing 20 by hand; it isn't a gate.

Live & running
  • Advisor on Flue — self-config birth, Turso brain (1A·1B), self-driving beats (1C)
  • Market thin slice — sweep → Turso → cheap cards → briefing-on-zero (1 market)
  • www.homezero.md — landing → onboarding → launchpad → board, funnel-v2 cutover live
  • Resolver + reflection, value-first onboarding, board v2, learning panel
  • Read-led cutover — money chrome gone, advisor speaks in prose, §06 launchpad + 5-tile billboard live
Building / next up
  • Agent-driven first-run — awakening square + live roster
  • Daily metric skill — market authors the billboard tiles nightly
  • Two-form onboarding split — advisor vs. market questions
  • 19 bespoke market agents — the launch long pole
Planned, not built
  • Market depth — county records, vectors, comps wiki, metric skill (the "deep scan")
  • Daily metric skill — market authors the billboard numbers nightly
  • $25/mo billing + landing re-cut to the subscription story
  • morningBrief — blocked on a WhatsApp push channel
Dropped from launch
  • Born-anywhere market — the on-the-fly "Mesa moment" (emergent, not a gate)
  • Home agent / walkthrough — the in-person tour capture (post-launch)
  • Linear-as-board dogfood — we kept our own board surface
  • Cells substrate — retired; only delta-market migrates to Flue
01 — The launch path

Six workstreams between here and launch.

This is the old 12-day-build spine, re-cut for the 20-market reframe. M1 (advisor) is done; "market anywhere" is replaced by "build 20 markets by hand"; the home-agent rungs move past launch. Progress bars are rough, honest first passes.

WS1

The advisor agent

live · polishing
Shipped
  • Self-config birth on Flue (Slice 1)
  • Per-buyer Turso brain + yearnings (1B)
  • Self-driving tend / scout / dream beats (1C)
  • Board write-hand + learning-panel render
Open
  • Read-led cutover (prose voice, no chart)
  • Agent-driven first-run (awakening + roster)
  • morningBrief — needs WhatsApp push
  • Two-author card split polish
WS2

The 20 market agents — the long pole

1 of 20
Shipped
  • Slice-2 pattern: sweep → Turso → cards → drain-briefing
  • Bright Data scrape → Turso store → Convex publish
  • Market #1 (North Fork Valley / Delta) thin slice
Open
  • 19 more bespoke market agents
  • Per-market provisioning (Turso, Bright Data, deploy)
  • A repeatable bespoke-build runbook
  • Recreate the v6-bricked NFV market DO
WS3

Funnel & launchpad UX

partial
Shipped
  • funnel-v2 resolver + reflection, live on www
  • Label / WhatsApp-out / star→ringMarket cutover
  • Value-first onboarding, board v2
Open
  • Read-led board + launchpad §06 rebuild
  • Two-form onboarding split (advisor / market)
  • Daily metric skill → the 5-tile billboard
  • Onboarding smoke as Playwright CI
WS4

Market depth — the "deep scan"

planned
Have
  • Egress spike: county data fetchable direct (no residential IP)
  • Sequencing decided: spine → loops → depth
Open
  • County records ingest (assessor / deeds / water / permits)
  • Turso-native vectors + embeddings
  • Wiki-weave + comps engine
  • Metric skill (billboard + demand reweighting)
WS5

Billing & the landing re-cut

planned
Have
  • Pricing model decided: free quota → $25/mo
  • Marketing narrative + ladder economics written
Open
  • Clerk $25/mo billing wiring + the paywall
  • Free-tier quota meter (zeros / deep-dives)
  • Landing re-cut: one-time "$25 Deep Scan" → subscription
WS6

The home agent — walkthrough & deep scan

post-launch
Have
  • /visit capture surface + 5 hand-authored surveys live
Open (deferred)
  • Per-house agent born on scan (Flue)
  • Visit ingest loop → deepen the brief → fold back to market
  • Photo / audio capture + transcription
02 — What's not built yet

The punch list, roughly in order.

Near-term build queue first, then the launch-scale work, then the deferred. Each links to the doc that specs it. This is the honest "not done" list — not the vision.

1

Read-led cutover — board + launchpad

Killed the money slider, per-card meters, the HomeZero score, and the confidence-bar chart; advisor now speaks in prose (read{summary,points}), market numbers in one 5-tile billboard. Shipped + live on www (PR #55 → e79f48c). → cutover plan

shippednear-term
2

Agent-driven first-run

Awakening square + live roster on /home; strip the deterministic seed voice so everything perceived as the advisor is agent-authored. → first-run plan

readynear-term
3

Daily metric / billboard skill

The market agent authors the 5 billboard tiles nightly (on-market, typical asking, median DOM, over-record, honest deals). funnel-v2 + read-led both depend on it. → funnel-v2

plannednear-term
4

Two-form onboarding split

Separate the advisor-context questions from the market-context questions in the wizard. → onboarding

plannednear-term
5

19 bespoke market agents

Build each on the Slice-2 pattern; provision Turso + Bright Data + deploy per market. The launch long pole. → slice-2 plan

long polelaunch-scale
6

Market depth per agent

County records ingest, native vectors, comps wiki, metric skill — the substance behind the "$25 deep scan." → market-agent-spec

plannedlaunch-scale
7

$25/mo billing + landing re-cut

Clerk subscription + paywall + free-tier meter; landing moves off the one-time Deep Scan framing. → marketing-brief

plannedlaunch
8

morningBrief beat

The advisor's daily push — blocked on a real WhatsApp outbound channel (number, opt-in, Meta template). Armed-but-empty stub in place. → whatsapp-bridge

blockedlaunch
9

Onboarding smoke as CI

Codify the happy-path acceptance click-through (land → onboard → reflect → finish → board → zero) in Playwright. → onboarding-smoke-test

plannedlaunch
10

Home agent / walkthrough

Per-house agent born on scan, the visit ingest loop. Explicitly post-launch. → home-twin

laterpost-launch
03 — The doc map

Every doc, sorted by whether it still governs the work.

Six shelves. Canonical docs drive current and forward work. Active plans are ready to execute. Invariant docs hold the thesis that survived every pivot. Historical docs are kept for lineage — don't build from them. Links are relative; .md files open as raw text.

Canonical · the Flue era

drives current & forward work
partly stale
The narrative spine — three pivots, current state, the 12-day build. Written 06-20, two days before Flue; its "where we are" is what this wiki updates.
specs/roadmap.html
06-20
canonical
THE current architecture: retire cells, move the whole fleet onto Flue / Cloudflare DOs. The substrate everything now runs on.
specs/flue-architecture.html
06-22
build spec
Making agents active on Flue — the beat rhythm, yearnings, and the market-depth rebuild (records, vectors, wiki). The 9-step build order.
specs/agent-model-on-flue.html
06-23
mostly done
The "nail the beginning" sprint — one advisor born from a live intake, zeroing, punches landing on the board, end to end.
specs/the-beginning.html
06-22
1A–1C done
The advisor's operational spec — four layers (hands / know-how / brain / memory) and five beats. 1A–1C shipped; 1D (WhatsApp) later.
specs/advisor-agent-spec.html
06-23
1A–1C done
The 16-task advisor build (1A–1D), test-first, exact file paths. The plan that 1A/1B/1C executed against.
specs/advisor-implementation-plan.html
06-23
done
Slice 1 — the self-configuring advisor Worker that writes its own IDENTITY.md and walks the waking→ready ladder. Shipped & live.
specs/flue-slice1-plan.html
06-23
thin slice live
The market agent's full capability spec — daily sweep, the storage stack, six skill pairs, five beats, the 2A–2D depth sequencing.
specs/market-agent-spec.html
06-23
thin slice live
Slice 2 — the market sweep + zero-drain briefing. The pattern each of the 20 bespoke market agents follows.
specs/flue-slice2-market-spec.html
06-23
T1–T6 done
Slice-2's 7-task plan; T1–T6 build the agent, T7 provisions per market. The build recipe for markets 2–20.
specs/flue-slice2-market-plan.html
06-23
partial
The canonical product funnel — landing → two-form onboarding → reflection → launchpad → read-led board. The UX north star.
specs/funnel-v2.html
06-23
planned
Activation-first /home — install hero, WhatsApp card, the 5-tile market billboard, read-led board preview. Folded into the read-led cutover.
specs/launchpad-redesign.html
06-23
Acts 1–2 live
The end-of-build acceptance click-through. Acts 1–2 run live; Act 3 (zero blooms a briefing) still manual. To codify in Playwright.
specs/onboarding-smoke-test.html
06-23
reference
As-built reference for the Flue ⇄ Convex seam and the @flue tool-API version landmine. Verified against code.
specs/phase1-interface-reference.md
06-23

Active plans · ready to execute

written, not yet built
ready
Kill the money dashboard; cards lead with the verdict read; advisor speaks prose; the market billboard speaks numbers. The current spec.
homezero/specs/designs/
06-24
ready
The 6-task plan across 3 slices (board strip · prose-read pipeline · launchpad §06). Subagent-driven, Opus per task.
homezero/specs/plans/
06-24
ready
Make the ~3-min birth window the best moment — seed homes only, roster comes alive live, advisor transforms the seed in place.
homezero/specs/designs/
06-20
ready
8 bite-sized tasks: mostly subtraction (strip seed voice) + small wires (markBorn, prune, awakening square, birth pass).
homezero/specs/plans/
06-20

Invariant · the thesis

survives every pivot — read for the why
foundational
What a "zero" is, where buyers live (Zillow stays discovery), the three agents. The thesis under everything.
specs/concepts.md
—
foundational
Why each agent binds to a noun (advisor↔person, market↔place, home↔house), skills-not-agents, and the market readiness gate.
specs/agent-model.md
—
canonical narrative
The end-to-end through-line — two onboarding questions ARE the two agents; birth → board → extension → zero → the compounding loop.
specs/the-flow.md
06-16
design philosophy
The "dream test" (skills vs agents), market boundaries earned not guessed. Note: its born-anywhere section is now demoted off launch.
specs/how-it-works.html
06-17
engineering frame
The four-store data boundary + three-layer market brain. Its phased born-anywhere arc is superseded by the Flue slices.
specs/build-plan.html
06-17
marketing
The non-technical explainer — the three agents, the ladder economics (free advisor → $25/mo). The narrative WS5 re-cuts the landing to.
specs/marketing-brief.html
06-20

Historical · superseded

lineage only — don't build from these
cells-era
The cells/wells substrate diagram. Replaced by flue-architecture; the D8/D11 data principles carry forward.
specs/architecture.md
—
pre-Flue
The pre-Flue advisor (pi harness, per-user cells, mother-birth). Concepts carry to advisor-agent-spec; the substrate doesn't.
specs/agents/
—
2-agent brainstorm
The 06-16 two-agent briefing brainstorm — yearnings, briefing-card skill, the dream. Folded into advisor-agent-spec.
specs/agents/
06-16
cells-era
The demand-loop market on cells (delta-market, ~50 scripts, Stoolap). Replaced by the Flue market agent.
specs/agents/
06-12
cells-era
The short-lived per-home cell. Renamed "home agent"; the walkthrough loop is WS6, post-launch.
specs/agents/
—
born-anywhere
The NFV-first, seed-from-Delta born-anywhere market plan. Superseded by the 20-bespoke-markets reframe.
specs/onboarding-plan.md
06-16
north-star, absorbed
The intent-gated ladder north star. The ladder concept lives on; Linear-dogfood and the 6-phase journey were dropped.
homezero/specs/designs/
06-18
north-star, absorbed
One-page punch sheet of the ladder design.
homezero/specs/designs/
06-18
board evolving
The six-stage kanban board. The board kept evolving; read-led is the current treatment.
homezero/specs/designs/
06-18
engine shipped on Flue
The ~30-min advisor heartbeat that tends the board. The concept shipped as the Flue tend beat (1C).
homezero/specs/designs/
06-18
engine shipped on Flue
The 5-task Convex backend for the tend surface. Superseded by the Flue tend beat.
homezero/specs/plans/
06-18
launch plan, reshaped
The five-milestone launch plan (advisor → market-anywhere → scan → walkthrough → deep scan). The spine WS1–WS6 re-cut; M2 demoted.
homezero/specs/plans/
06-18
inventory snapshot
An 06-18 inventory of shipped pieces the 12-day build assembles. A point-in-time snapshot — this wiki is the current one.
homezero/specs/plans/
06-18
board v1
The boardCards table — board as a co-curated thread. Evolved into kanban then read-led.
homezero/specs/designs/
06-17
shipped
Value-first onboarding (anon wizard, account at Finish). Shipped — funnel-v2 carries it forward.
homezero/specs/designs/
06-17
shipped
The 5-task value-first build. Shipped.
homezero/specs/plans/
06-17
board v1
The 4-task board v1 (surface the advisor's takes). Superseded by v2 then read-led.
homezero/specs/plans/
06-17
shipped
The 6-task where→market resolver + Screen-1 reflection. Shipped; lives on in funnel-v2.
specs/plans/
06-16
cells-era
The cells reliability note (serialize the queue-drain so the VM doesn't thrash). Cells-era; Flue DOs serialize natively.
specs/cell-inbox.html
06-17
superseded sketch
An earlier, coarser advisor-loop sketch. Superseded by advisor-implementation-plan.
specs/phase1-advisor-loop-plan.html
06-23

Surface specs · mixed

pre-Flue surface concepts — some shipped, some aspirational
partial
The 4-screen wizard that births both agents. Resolver/reflection shipped; two-form split is WS3.
specs/surfaces/
06-16
concept → read-led
The board as one running market-authored briefing that moves on zeroing energy. The read-led board is its instance.
specs/surfaces/
06-16
v0.1 live
The Zillow zero-capture extension. v0.1 ships zero/unzero + Clerk sync auth; the in-Zillow panel is pending.
specs/surfaces/
06-11
Swain port concept
The typed-item feed grammar ported from archived Swain. The blueprint briefing.md applies.
specs/surfaces/
06-16
/visit live
Agent-scripted, TTS-narrated visit surveys. /visit + 5 surveys live; the ingest loop is WS6 (home agent).
specs/surfaces/
05-25
pre-pivot
The early site-pivot framing (tabs → workspace). Superseded by the briefing/board surface.
specs/surfaces/
—
transport
The WhatsApp transport adapter (Baileys daemon). The outbound side gates morningBrief (punch #8).
specs/surfaces/
—

Operational · the product layer

stable infra & runbooks (homezero/)
stable
The site stack — Next.js + Convex + Clerk + Cloudflare; agent-authored data, reactive reads, the one write path.
homezero/specs/
—
stable
The buyer-side product north star — shaped listing, verdict, value-image, the Explainer design direction.
homezero/specs/
—
stable
Cloudflare Workers / OpenNext deploy. Worker homezero, dev Convex nautical-rabbit-780; the pre-launch prod checklist.
homezero/specs/
—
stable
How an agent shapes listings into Convex + runs deep-dives. The authorship contract (verdict shape, deep-dive sections).
homezero/specs/
—
stable
First-time setup, running the site, tests, the deep-dive dev workflow.
homezero/specs/
—
operational
The multi-repo PR sweep — agents open PRs, an integrator merges the clean ones. How the 7 Zero repos stay in motion.
specs/integration-pipeline.md
—
04 — Lineage

Four turns in one month.

Why the historical shelf is so deep: the design moved fast. Each pivot left docs behind. The full narrative lives in roadmap.html — this is the short version, now with the fourth turn the roadmap predates.

06-12 · Turn 1

Demand-driven

Coverage born from buyers, not geography. The county canvass dies; three births (advisor / market / home).

06-16 · Turn 2

Two agents

Specialists killed. The standing team collapses to advisor (person) + market (place) — skills, not sub-agents.

06-18 · Turn 3

The ladder

An intent-gated advisor → market → home ladder; cost-to-zero as the spine. (Linear-dogfood since dropped.)

06-22 · Turn 4

Flue

The whole fleet → Cloudflare Durable Objects. Cells retired. The substrate everything now runs on — and where the roadmap stops.

05 — How to use this

Reading the shelf.

live partial planned later / blocked invariant historical

Start at Where we are for the snapshot, The launch path for the plan, and What's left for the queue. Use The doc map to find any spec by what it governs — build only from Canonical and Active plans; read Invariant for the why; treat Historical as lineage. This wiki is the live index — update it when a doc's status changes, not the (frozen) roadmap.