docs: design-vs-build gap audit recorded (61 items, 6 build waves)

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01QJs13VsyiSKYQP6rj3NNmc
2026-07-31 05:46:32 -04:00
parent e257474cc8
commit 49565b5f02
2 changed files with 61 additions and 0 deletions
@@ -648,3 +648,26 @@ and `user_notifications` both **0 rows**) · recap **SPEC'D-NOT-BUILT** (no file
 The live settle path emits ops alerts only, with zero user-facing output.

 316 suites / 3,930 tests green, web build exit 0.
+
+---
+
+# DESIGN-vs-BUILD GAP AUDIT — 2026-07-31 → `specs/design-vs-build-gap-audit.md`
+
+**61 implementable items** enumerated from `specs/design-reference/` (Jul 22) against the current repo:
+**BUILT-TO-SPEC 20 · BUILT-BUT-DRIFTED 7 · PARTIAL 16 · ABSENT 18.** The design is ahead of the build;
+the gap is implementation, not design.
+
+**Biggest gap:** the glyph library — **38 of 83 SVGs wired (46%)**, and the design implies **74 display
+archetypes vs the registry's 41**.
+
+**Drift on recently-built surfaces:** book comparison (wired 07-29) has **no crown, no disagreement
+axis, no SPLIT chip, no movement strip**; the mobile tab bar lacks the designed **READ-FAB**;
+calibration gates at **n≥20 vs the designed N30**.
+
+**Correction to the earlier status pull:** the **Newsletter IS designed** (S5 "The Report") →
+design-exists-needs-build. Only **Live tracking** and **Slip reader** are genuinely design-missing.
+
+**Six-wave ordered build list:** self-contained (glyphs, primitives, boundary-channel blue) → scanner-
+nudge-gated → model-gated (Price Triplet EV leg, calibration curve) → **resolution-pipeline-gated
+(share-card masters — the tail has no generation step and no trigger)** → licensing-gated (book logos,
+push-to-book) → large surface builds (Offseason, S3 media, The Report, S2 primitives).