docs: Add v2 wireframes and theme specification

14 files in docs/wireframes/v2/ addressing 13 UX gaps from v1:
- Theme spec with indigo brand, status tokens, terminal/diff tokens,
  dark mode, Geist typography, 6px radius, layered shadows
- Wireframes for all pages with loading/error/empty states
- Shared component specs (SaveIndicator, EmptyState, ErrorState,
  CommandPalette, ThemeToggle)

docs/wireframes/v2/README.md

@@ -0,0 +1,51 @@
+# v2 Wireframes
+
+Redesigned wireframes for Codewalk District frontend — addressing 13 UX gaps identified in v1.
+
+## Changes from v1
+
+| # | Issue | Resolution | Wireframe |
+|---|-------|------------|-----------|
+| 1 | No brand identity — achromatic palette | Indigo brand color (#6366F1), differentiated tokens | [theme.md](theme.md) |
+| 2 | No dark mode toggle | 3-state toggle (Sun/Monitor/Moon) in header | [app-layout.md](app-layout.md), [theme.md](theme.md) |
+| 3 | Missing loading/error states across pages | Skeleton loaders, AlertCircle + retry patterns | [shared-components.md](shared-components.md) |
+| 4 | No save feedback on editors | SaveIndicator component (Saving.../Saved/Failed) | [content-tab.md](content-tab.md), [plan-tab.md](plan-tab.md) |
+| 5 | No breadcrumb navigation in content | Breadcrumb row above page title | [content-tab.md](content-tab.md) |
+| 6 | Inconsistent empty states | Standardized EmptyState component | [shared-components.md](shared-components.md) |
+| 7 | No search/filter on agents page | Provider, mode, and name search filters | [agents.md](agents.md) |
+| 8 | Missing agent context (what task/initiative) | Context row on agent cards | [agents.md](agents.md) |
+| 9 | No batch dispatch in execution | "Queue All Pending" button + dispatch feedback | [execution-tab.md](execution-tab.md) |
+| 10 | Confusing inbox button layout | Simplified 2-button form (Send + Stop) | [inbox.md](inbox.md) |
+| 11 | No initiative metadata on cards | Branch badge + project names + timestamp | [initiatives-list.md](initiatives-list.md) |
+| 12 | Missing review tab loading/error | Spinner + AlertCircle states | [review-tab.md](review-tab.md) |
+| 13 | No command palette | Cmd+K palette for cross-entity search | [shared-components.md](shared-components.md) |
+
+## Files
+
+### Theme
+
+| File | Description |
+|------|-------------|
+| [theme.md](theme.md) | Complete design system specification |
+
+### Pages
+
+| File | Route | Description |
+|------|-------|-------------|
+| [app-layout.md](app-layout.md) | `*` | Global shell: consolidated header, theme toggle, health dot |
+| [initiatives-list.md](initiatives-list.md) | `/initiatives` | Cards with metadata, sort, search |
+| [initiative-detail.md](initiative-detail.md) | `/initiatives/$id` | Two-row header, tab badges |
+| [content-tab.md](content-tab.md) | `?tab=content` | Breadcrumbs, save indicator, placeholder |
+| [plan-tab.md](plan-tab.md) | `?tab=plan` | Split empty states, save indicator |
+| [execution-tab.md](execution-tab.md) | `?tab=execution` | Queue All, dispatch feedback, overflow |
+| [review-tab.md](review-tab.md) | `?tab=review` | Loading/error states, jump-to-unresolved |
+| [agents.md](agents.md) | `/agents` | Multi-filter, search, context row |
+| [inbox.md](inbox.md) | `/inbox` | Simplified question form |
+| [settings.md](settings.md) | `/settings/*` | Error states on Projects |
+
+### Components
+
+| File | Description |
+|------|-------------|
+| [dialogs.md](dialogs.md) | Updated dialog wireframes |
+| [shared-components.md](shared-components.md) | Reusable component specs |