Web Dev Workflow
The rule — Plan in Claude chat, build in Claude Code, review on the Vercel preview URL, and never push directly to
main.
Phase 1 — Idea & Brief (Claude chat)
Decide project type, domain pattern, and whether Sanity/Supabase are needed. Output a written design-brief.md saved to /docs.
Phase 2 — Design Concept (Claude chat)
Work through colors, type, layout. Gather any mockups into /docs. There is no Figma — approval happens on the live style guide.
Phase 3 — Project Setup
New repo from the starter template → local folder → add /docs → add the domain to Cloudflare → connect the repo to Vercel → open Claude Code and tell it to read CLAUDE.md and /docs first.
Phase 4 — Build
Style guide builds first, then pages. Share the /style-guide preview URL for client approval before building pages. All work on feature branches.
Phase 5 — Review & Launch
Run the pre-launch checklist on the preview URL, get written client sign-off, then merge to main (= live in 1–2 min).
Phase 6 — Post-Launch
All changes follow the same feature-branch flow. Content-only edits go through Sanity (if set up) without touching code.