Develop: Refactor Build

Refactor the app by executing every task in docs/REFACTOR.md, in order, until all tasks are checked off.

Setup

Read docs/REFACTOR.md first — it is the source of truth for what to change and in what order, and it encodes decisions already made with the user. Do not relitigate them. docs/PRD.md is the spec the refactor is converging on; docs/DESIGN.md holds the visual design tokens. Do not load these wholesale — each phase lists the specific Reference sections to read, plus whatever a task's Notes line points to. If docs/REFACTOR.md is missing, stop and tell the user to run studio-develop-refactor-plan first.

Work loop

Repeat until every task in the refactor plan is complete:

1. Find the first unchecked task (- [ ]). Tasks are ordered intentionally — removals and foundations come before rebuilds. Never skip ahead.
2. Read what the task needs — its Files and Notes lines, plus the current phase's Reference sections if not yet read this session.
3. Implement the task exactly as specified. Follow the repo's CLAUDE.md/AGENTS.md guidelines: surgical changes only — touch what the task names, don't "improve" adjacent code, and remove any imports, variables, or files your change orphans.
4. Test and verify before moving on. Run the verification step at the end of the task's Notes, run the app, and run the test suite — a refactor's first job is to not break what works, so existing tests passing is part of every task's definition of done. If the task changes behavior intentionally, update the affected tests and say so. If verification fails, fix it first — never mark a failing task complete or start the next task with the app broken.
5. Mark the task complete — change - [ ] to - [x] and update the header status line (**Status:** X/Y tasks complete, **Current Phase:** ...).
6. At each phase boundary: run the app end to end and confirm the phase's Goal is true. Commit with a message Refactor Phase {N}: {Phase Title} summarizing the goal and completed task range, then push and keep going — there's no need to open a pull request or pause for review between phases. If the phase touched auth, payments, user input, or data access, run the coding agent's built-in review (/review in Claude Code, or the equivalent in Cursor or Codex) and address the findings before continuing.