refactoring-readiness-assessment
Installation
SKILL.md
Refactoring Readiness Assessment
When to Use
You are about to change existing code — adding a feature, fixing a bug, doing a code review, or cleaning up — and you are not sure whether to refactor first, refactor not at all, or start from scratch.
This skill runs before any code changes. It answers three questions:
- Should we refactor? (Go / No-go)
- If yes, what approach? (Opportunity trigger, Two Hats plan, session rules)
- What are the risks? (Constraint inventory, stop conditions, backtrack rules)
What this skill does NOT do:
- It does not apply any refactoring transformations (use
method-decomposition-refactoring,conditional-simplification-strategy, or other catalog skills for that) - It does not diagnose specific code smells (use
code-smell-diagnosisafter this assessment) - It does not plan a large multi-session effort (use
big-refactoring-plannerfor codebase-scale work)