diff --git a/docs/design-system.md b/docs/design-system.md
index 4ad6795..d1db05e 100644
--- a/docs/design-system.md
+++ b/docs/design-system.md
@@ -362,7 +362,7 @@ If using Tailwind, extend the theme with these tokens rather than relying on def
 
 > This section tracks decisions made while adapting the FabledSword baseline above for Scribe specifically. Items here are *in progress* — once they feel solid, they get folded into the main body of the document (either as Scribe-specific extensions in the per-app section, or as updates to the universal rules where Scribe's needs reveal a gap in the baseline).
 
-*Iteration started: 2026-04-26.*
+*Iteration started: 2026-04-26. Foundation pass shipped 2026-04-27 in `7a9a8b7` — palette, fonts, light mode, action tokens, hardcoded indigo cleanup, warm-gold deprecation. Surface phase (button reclassification, border audit, Lucide migration, voice/tone) tracked in a separate spec.*
 
 ## Decisions made so far
 
@@ -531,4 +531,21 @@ Border weight is not load-bearing for Scribe — happy to use the doc's 0.5px ha
 
 ## Open threads (next iterations)
 
-*All initial-iteration threads resolved. Next phase is the polish pass — applying the system to existing UI, component by component. New threads will accumulate here as we discover gaps in the polish pass.*
+### Foundation pass — shipped 2026-04-27 (`7a9a8b7`)
+
+Mechanical token + font + light-mode rewrite of `frontend/src/assets/theme.css`, plus a sweep of hardcoded indigo and `--color-accent-warm` references across ~14 component files. Action tokens (`--color-action-primary` Moss, `--color-action-secondary` Bronze, `--color-action-destructive` Oxblood, `--color-action-ghost-border` Pewter) are defined but not yet applied — buttons still flow through `--color-primary` and read as dusty-violet gradients in the meantime, by design. Spec lives at `docs/superpowers/specs/2026-04-27-design-system-polish-foundation-design.md` (gitignored, local-only).
+
+### Surface phase — next
+
+Per-component work, picked up surface-by-surface:
+
+- Button reclassification per the Hybrid rule — for each button decide brand moment (accent) vs Moss / Bronze / Oxblood / Pewter, swap to the appropriate `--color-action-*` token
+- Lucide icon migration (~16 files, 30–60 swaps) — install `lucide-vue-next`, replace hand-inlined SVGs, enforce 16/24px scale and 1/1.5 stroke weights
+- Border placement audit per the structural-not-decorative rule — strip from list rows, inline `ToolCallCard` inside chat bubbles, filter chips, empty-state callouts
+- Voice/tone copy touchups, opportunistic as components are touched
+- 3 emoji-as-icons replaced with Lucide equivalents
+- Long-form 1.7 line-height applied to Notes viewer, Journal entries, assistant chat bubbles
+- Bubble shape tweaks (radius asymmetry, tail) if needed beyond the foundation recolor
+- Per-component scoped-CSS font-family declarations cleaned up opportunistically
+
+A surface-phase design spec gets written when the work begins. New threads will accumulate here as gaps surface during application.