Build Log · June 30, 2026

Known Brain Sync + UX Pass

Closed the copy-sync debt with a prebuild script, then did a full UX audit — the import flow is the founding session surface and needs to move.

  • Known
  • UX
  • Engine
new scripts
2

new scripts

files auto-synced on build
5

files auto-synced on build

UX issues ranked
6

UX issues ranked

Timeline

  1. Start

    Session direction question

    Zeb arrived unsure about the Runbook — ran Anvil Check on whether the bottleneck is logistical or human

  2. 15m

    Brain sync script decision

    Option B: close copy-sync debt first, then decide

  3. 30m

    Scripts built and verified

    sync-brain-content.mjs + check-brain-sync.mjs + prebuild hook — build runs clean

  4. 45m

    Full UX pass

    Read every screen, every component — 6 issues ranked by priority

What shipped

  • Known/scripts/sync-brain-content.mjs — copies docs/known/brain/*.md + mvp-hypotheses.md into Known/content/

  • Known/scripts/check-brain-sync.mjs — SHA-256 hash comparison, exits non-zero on drift, reports MISSING / DRIFT / ORPHAN

  • prebuild hook in Known/package.json — sync runs automatically before every npm run build

  • npm run sync:brain and npm run check:brain-sync scripts

  • Full UX audit of all Known screens — 6 issues with priority ranking and next-session action list

“Stop sharpening the shovel and dig one careful hole.”
— Session brief — the principle that shaped the UX pass