What problem does it solve?
This Skill enables safe, incremental refactoring of large codebases by requiring a validated scope, a prioritized plan, and test-backed execution, ensuring changes are traceable and reversible when needed.
Core Features & Use Cases
- Reflect on Context: gather requirements, features, tech specs, and scope boundaries to map code relationships.
- Plan Refactoring: design a target structure applying SOLID, DRY, and KISS principles with phased changes and risk assessment.
- Execute Incrementally: apply changes phase-by-phase, commit checkpoints, run tests after each change, and revert if necessary.
- Update References: synchronize technical designs, requirements, and feature specifications with the new structure.
- Tracing & Compliance: preserve or apply tracing instrumentation for new and moved code.
- Rollback on Failure: stop, analyze, and revert if tests fail or behavior changes are detected.
Quick Start
Prepare the required prerequisites (refactoring_suggestion, refactoring_principle, and code_quality_evaluated) and trigger the end-to-end refactoring flow by first running x-ipe-task-based-refactoring-analysis to generate a plan, then x-ipe-task-based-improve-code-quality to validate readiness, and finally invoke this skill to execute the plan incrementally. After each phase, review test results and commit changes, updating references as needed.
Note: The execution follows a strict DoR/DoD flow and requires human approval at key decision points.
