בס״ד

START — Build Spec (Sam's review of the redesign mock, 2026-06-01)

docs/START_BUILD_SPEC.md · last changed (pre-VM history) · rendered from GitHub master

START — Build Spec (Sam's review of the redesign mock, 2026-06-01)

Source: Sam's voice walkthrough of outputs/2026-06-01_start-redesign-mock.html. This is the intent for the REAL build. Mock = shape only; this doc = what to actually build. Foundation = Cloudflare HTML + ops-api Worker (the start.html engine reads live QUEUE_JSON — 165 real cards verified). NOT the Supabase app yet.

Decisions LOCKED from the review

CHANGES Sam asked for (vs the mock)

  1. Crest too tall. Make "Hook Street · Command" a narrow pill — less vertical space, maybe a different shape. Title can read "Hook Street Commander / Smart" and flex per-person (Sam / Mildred / wife). Keep the floating Hebrew (ואהבת לרעך כמוך) + maybe just the time — very narrow.
  2. The slot under the crest = customizable widget strip (≤5 small info bits). Per-person: wife → weather; Mildred → what she needs; a little settings gear to add/remove. Think iOS-17 floating-dock feel — some bits (Hebrew words, time, one important thing) could "float"/stay pinned on scroll.
  3. Cadence strip = the day's order of events (6:48 brief → 10:30 Mildred → 3pm MIS → 6pm → Sun review). Confirm what each does when tapped (right now unclear). It should reflect the REAL day, time-aware ("now").
  4. Sub-status / "grade" on cards (without being wordy): a color or tiny mark showing where a thing is up to — e.g. ready / fully-functional / others-know / backburner / "burnt-should-be-done." A maturity-or-state glance, beyond just priority. (Tie to the Designed→Built→Tested→Deployed→Validated axis already in the plan.)
    4b. Pipeline zones (STR / clients): not just tasks — show forward motion: pipeline building, clients moving forward, "the opposite of paying down debt — the BUILDER pipeline / snowball." Calendar-connected, upcoming bookings, next steps to get there.
  5. Card link style shouldn't look "classic Claude-Code-built." Sam wants a distinct site feel. (Design pass: move away from the default blue/bordered look — give it its own identity.)
  6. Stocks zone — only ~2 tickers now; clarify what it DOES (alerts? things-I-want-to-know? MIS signals?). Don't over-promise; make it useful-small.

CONTENT REQUIREMENT (the big one)

Reorient must use Sam's REAL content, not 180 random cards. The queue is full of stuff he threw into the command box back-and-forth. Rethink-everything should: read it all → understand what's actually going on → dedupe/combine → give him a REAL understanding ("here's what's real"), not a dump of 180. The build's job: make the queue trustworthy + current, then the AI rethink curates it. This is the difference between a card pile and a command center.

SERVICES / BOOKING — new branch Sam raised (capture, don't build yet)

Sam wants to eventually connect his own direct booking for the STR homes — circumventing Airbnb (he does the work manually anyway): live inquiry → he closes → his own booking agreement + his own liability terms. Needs: connect to hospitable.com (likely via API link), connect to the calendar, show + book from START, his own pricing/terms. Different audience (guests) = different coloring/site (the public HookStreetServices-Site / Bookings). This is a real revenue lever (keep Airbnb's cut). PARKED as its own initiative — note it, don't scope it into START v1.

MONEY / LIFE — connect + chase FOR him (capture)

Sam's vision for the money layer: the system should KNOW his monthly obligations — where each comes from, when, how — go GET the info (utility statements, etc.), tell him what's missing ("Sam you haven't given me X, where is it?"), track paid/unpaid, and help him cash out / get out of debt (home equity vs credit card, etc.) so he doesn't think about stupid things. It should chase HIM: taxes ("what does the accountant need? you're missing XYZ, where is it?"), utilities ("did you get the latest statement? it's missing"), push things forward because "now you know."
- Connect: utilities, taxes/accountant docs, monthly obligations source-of-truth.
- Behavior: proactive chase + "what's missing" + paid/unpaid tracking + payoff strategy.
- This is the runway/depletion + obligations layer — already partly in plan; this sharpens the BEHAVIOR (chase me, don't wait).

LIVE UPDATES logged this session (to queue)

BUILD ORDER (when Sam says go)

  1. Narrow crest pill + customizable widget strip (+ per-person title).
  2. Type-by-color + bento zones wired to live QUEUE_JSON (real 165 cards, Cool Slate default).
  3. Sub-status/grade marks on cards.
  4. Reorient "Rethink everything" (AI, with approval) — reads real queue, dedupes/combines/re-scores.
  5. Swipe (Map B + full options on tap), calendar connection.
  6. Then: per-person scoping + Cloudflare per-path walls.
    PARKED (own sessions): direct-booking/hospitable, the money-chase automations, services site coloring.
Source trail · docs/START_BUILD_SPEC.md @ master · rendered 2026-07-02 7:23 PM EDT by scripts/build-docs.py · the .md in the repo is the truth; this page is the phone-readable view