What problem does it solve?
It helps you translate a vague refactor desire into a clear, actionable refactoring plan you can execute safely, using an interview-driven approach and then documenting the outcome as a GitHub issue.
Core Features & Use Cases
- User-interview-driven scope: Gathers the problem context, desired outcomes, constraints, and implementation assumptions before planning the work.
- Repo verification and options: Checks the repository state to validate claims and considers alternative approaches to reduce risk.
- Tiny-commit execution plan: Produces a commit-by-commit plan aligned to Martin Fowler’s guidance so each step keeps the codebase working.
- Issue-ready deliverable: Writes the plan in a structured GitHub issue template, including decisions, testing, and explicit out-of-scope items.
- Use case: When you want to refactor a subsystem (e.g., improving architecture or simplifying modules) without breaking functionality, this skill structures the work into incremental changes and produces an issue ready for implementation and review.
Quick Start
Ask for a refactor plan by saying: “Create a detailed refactor plan for my codebase by interviewing me about the current behavior and goals, verifying the repo, proposing alternatives, breaking the refactor into tiny commits, and filing it as a GitHub issue.”