Guides
Multi-file refactors
How to plan, propose, and review repo-wide changes.
The pattern
- Open Composer (⌘K) and describe the goal.
- @-mention the directories or symbols that matter.
- Ask for a plan before edits ("plan first, then apply").
- Approve or revise the plan.
- Apply per-file; run tests; iterate.
Tips
- Keep refactors small enough to land in one PR.
- Attach
@gitso the model can see what you’ve already changed and stay consistent. - Use rules to lock in conventions across iterations.