06-reference / concepts

hq as decision surface notion as data store

Sun May 10 2026 20:00:00 GMT-0400 (Eastern Daylight Time) ·concept ·status: canonical-pattern ·source: Founder synthesis (Discord 2026-05-11 11:57 ET) ·by Ben Wilson (founder) + Ray (synthesis)
hq-architecturenotion-as-data-storedecision-surfaceclick-back-railboard-railsgenerative-uiasync-clearing

HQ as Decision Surface, Notion as Data Store (the lightest-touch architecture)

Why this is in the vault

Founder caught a real drift on 2026-05-11 11:57 ET: Notion task board accumulated ~80 active items, founder never visits Notion, and the board was being misused as a “founder-decision queue” when its original intent was “Ray-fills-empty-cycles.” The proposed fix is structural but lightweight — keep Notion as the operational data store, move the DECISION SURFACE to HQ’s click-back rail. This concept doc names the canonical pattern so future skill design (and the Ray-Starter-Kit) defaults to it.

Mapping against Ray Data Co

The original intent of the board (recovered)

“The board was intended to be a place where you could look at tasks that can be completed on your own time. You are always on and never sleep. I sleep 8 hrs and cannot give you attention to make decisions all the time. You’ll have a lot of empty cycles and the board was intended as a way to fill them.” — Founder, Discord 2026-05-11 11:57 ET

So:

Ray drifted: many of the items piled on the board over April-May 2026 were founder-strategic-decisions (“Productize MAC + Client Reporting”, “Sanity Check v3 revival strategy”, “RDCO website relaunch”) which should have lived on the /decisions/ surface with click-back rails, not in Notion. The drift built up an apparent 80-item queue that was actually a misclassification.

The proposed architecture

Surface map (after fix)

SurfaceHoldsAudience
Notion Task BoardRay-able-async work. Skill builds, newsletter batches, YouTube backfills, audits, mechanical maintenance.Ray-only (board lives where Ray picks up empty-cycle work).
Notion Research BacklogFounder-triage queue. Curiosity-generated questions awaiting approval. Status field IS the founder-action surface.Founder + Ray (founder approves Inbox → Approved, Ray dequeues from Approved).
HQ /decisions/Founder-decision surface. Every founder-action item gets a page with click-back lock-in.Founder primary, Ray writes + reads payloads.
HQ /vault/Knowledge nervous system.Founder browses, Ray writes.
HQ /bets/Per-bet dashboard. Surface the state, not the decisions.Founder browses.

The click-back rail upgrade

Per the founder’s synthesis, the existing click-back lock-in button gets two new options:

Mechanically: the click-back URL gains a query-param ?cadence=now|async|defer that the iMessage payload encodes, and Ray’s parser routes accordingly. Single-line code change once the click-back HTML template is updated.

What goes WHERE going forward (the discipline)

When Ray encounters something that needs founder judgment:

  1. Is it a true decision? (yes/no, A/B, ship/hold, build/skip) → HQ /decisions/<slug> click-back page. NOT Notion.
  2. Is it a research question? (something to investigate before deciding) → Notion Research Backlog Inbox. Founder approves → Ray dequeues.
  3. Is it Ray-able-async work? (a thing Ray can do alone) → Notion Task Board.
  4. Is it just status? (a thing happening, no action needed) → no surface; let the cron rhythm + morning brief cover it.

The mistake to avoid: putting a real decision in Notion. If it’s a decision, it goes to /decisions/.

Phase 0 roll-out plan (this week)

  1. Update HQ click-back template to support the ?cadence=now|async|defer query-param. Generate the 3-button UI on every decision page. (~30 min HTML/JS edit.)
  2. Update iMessage MCP parser in Ray’s session to route cadence=async payloads into an idle-cycle queue file at ~/.claude/state/async-decision-queue.json. Each entry: {decision_slug, cadence, payload, queued_at}. (~30 min.)
  3. Update /check-board to read the async-queue file at the top of each fire. Process queued decisions before scanning Notion. (~15 min skill edit.)
  4. Audit current Notion items. Items that are actually founder-decisions (e.g. “Productize MAC + Client Reporting”, “Sanity Check v3 revival”) get migrated to HQ /decisions/ pages. Notion entry stays as Done/Archived with a pointer to the new HQ page. (~1-2 hours; dispatched as subagent 2026-05-11 11:57 ET, parallel to this concept doc.)
  5. Update /improve, /curiosity, /deep-research to use the new discipline (where they currently file founder-decisions to Notion, they file to /decisions/ instead). (~30 min skill audit.)

Total: ~4-5 hours of focused work. Doable Mon-Tue alongside Mammoth-demo prep.

What this preserves

What this changes

Open follow-ups