Vault
Spotlight is a viewer over ~/vault/clients/. Markdown stays the source of truth — Claude edits state.yaml, queue.md, timeline.md, and analyses/*.md during normal work; this UI just renders what's there.
Client folder shape
vault/clients/{slug}/
├── README.md ← profile, status, decision maker, north star
├── state.yaml ← optional structured state (status, mrr, snapshot, type)
├── queue.md ← proposed actions, "## Pending" / "## Approved"
├── timeline.md ← chronological diary, newest first
├── analyses/ ← markdown source for each published analysis
├── notes/ ← ad-hoc notes
└── data/ ← raw exports (csv, json)state.yaml example
status: active-paying type: ad-client mrr: 5000 snapshot: "CPL $47 last week. 218 leads / 30d. 4 actions queued." last_touched: 2026-04-29 health: healthy decision_maker: "Josh Halpern (firm owner)" started: 2026-04-01 north_star: "Cost per qualified PI lead"