skills/skills.volces.com/big-refactoring-planner

big-refactoring-planner

SKILL.md

Big Refactoring Planner

When to Use

You have a structural design problem that cannot be fixed in a single refactoring session. The individual moves — Extract Method, Move Method, Extract Class — are not in question. The challenge is that the problem is architectural: dozens of classes are tangled, or a hierarchy is doing multiple jobs, or procedural logic is spread across a codebase that nominally uses objects. The fix takes weeks to months, not minutes.

This skill is for those campaigns.

Fowler and Beck's core principle: "You refactor not because it is fun but because there are things you expect to be able to do with your programs if you refactor that you just can't do if you don't."

Big refactorings are done for a purpose — specifically because a particular kind of change that the team needs to make is blocked or costly without the restructuring. You are not refactoring for cleanliness. You are refactoring because the architecture is standing in the way of features you need to build.

This skill applies to four named patterns:

Pattern Core problem Time scale
Tease Apart Inheritance One hierarchy doing two independent jobs Weeks
Convert Procedural Design to Objects OO language used in procedural style Weeks to months
Separate Domain from Presentation Business logic embedded in GUI classes Weeks
Installs
5
First Seen
Apr 25, 2026