Refactor Planner

What this skill does

This skill directs the agent to analyze a block of code (or an entire module) and produce an ordered, safe refactoring plan. Rather than rewriting everything at once, it breaks the work into small, reversible steps — each one leaving the tests green and the behavior unchanged. It identifies code smells, maps dependencies, flags high-risk areas, and sequences the changes so you can ship incrementally without introducing regressions.

Use this when you have messy, hard-to-understand code that works but needs cleaning up before you can safely add features.

How to use

Claude Code / Cline

Copy this file to .agents/skills/refactor-planner/SKILL.md in your project root.

Then ask the agent:

• "Use the Refactor Planner skill on src/utils/dataProcessor.ts."
• "Plan a safe refactor of this function using the Refactor Planner skill."

Paste in the code you want refactored, or point to a file path.