request-refactor-plan

Creates a detailed refactor plan with tiny commits and files it as a GitHub issue.

1|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/mst-software-vn/mst-checkscam --skill request-refactor-plan-mst-software-vn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/mst-software-vn/mst-checkscam/tree/main/.claude/skills/request-refactor-plan
Command: npx skills add https://github.com/mst-software-vn/mst-checkscam --skill request-refactor-plan-mst-software-vn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Refactoring without a plan leads to oversized, risky changes that are hard to review and roll back. This Skill turns a vague refactoring idea into a structured, interview-driven plan broken into tiny, safe commits, then files it as a GitHub issue for team visibility. ## Core Features & Use Cases - Structured Interview Process: Walks through problem description, codebase verification, alternative options, scope definition, and test coverage checks before planning. - Tiny Commit Breakdown: Applies Martin Fowler's principle of making each refactoring step as small as possible so the codebase stays working after every commit. - GitHub Issue Output: Produces a complete refactor plan using a fixed template covering problem statement, solution, commits, decision document, testing decisions, and out-of-scope items. - Use Case: A developer wants to split a monolithic service into modules. The Skill interviews them about scope and constraints, checks existing test coverage, then files a GitHub issue with a step-by-step commit plan the team can execute incrementally. ## Quick Start Ask the assistant to create a refactor plan for the module you want to restructure and answer its interview questions.

Frequently Asked Questions about request-refactor-plan

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I plan a large refactor without breaking the codebase?▼

Break the refactor into tiny commits where each step leaves the codebase in a working state, following Martin Fowler's advice to make each step as small as possible. This Skill guides you through scoping, then produces a commit-by-commit plan filed as a GitHub issue.

How to create a refactoring RFC or proposal for my team?▼

Use this Skill to interview through the problem, solution options, scope, and testing strategy, then generate a structured GitHub issue. The issue template includes problem statement, solution, commit plan, decision document, testing decisions, and out-of-scope items.

What should a refactor plan document include?▼

A good refactor plan includes a problem statement, the proposed solution, a detailed list of tiny commits, a decision document covering modules and architectural choices, testing decisions, and explicitly out-of-scope items. It should avoid specific file paths that quickly become outdated.

Does the refactor plan include test coverage considerations?▼

Yes, the process checks the codebase for existing test coverage of the affected area before planning. If coverage is insufficient, it asks the developer about their testing plans, and the final issue documents testing decisions and which modules will be tested.

When should I not break a refactor into tiny commits?▼

Tiny commits are almost always appropriate for refactoring since they keep the program working at each step. The main exception is when a change is atomic by nature, such as a single mechanical rename that cannot be meaningfully subdivided.