Build Log
Known Brain Sync + UX Pass
June 30, 2026
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.
KnownUXEngine
2
new scripts
5
files auto-synced on build
6
UX issues ranked
Timeline
Start
Session direction question
Zeb arrived unsure about the Runbook — ran Anvil Check on whether the bottleneck is logistical or human
15m
Brain sync script decision
Option B: close copy-sync debt first, then decide
30m
Scripts built and verified
sync-brain-content.mjs + check-brain-sync.mjs + prebuild hook — build runs clean
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.”