x-ipe-task-based-code-refactor

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.