request-refactor-plan

Creates a detailed refactoring plan with small commits and files it as a GitHub issue.

Updated Jun 2, 2026
One-click install
npx skills add https://github.com/lfuuu/claude-rules --skill request-refactor-plan-lfuuu
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/lfuuu/claude-rules/tree/main/global-skills/request-refactor-plan
Command: npx skills add https://github.com/lfuuu/claude-rules --skill request-refactor-plan-lfuuu

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Refactoring without a plan often leads to oversized, risky changes that break the codebase. This Skill turns a vague refactoring idea into a structured, interview-driven plan broken into tiny safe commits, documented as a GitHub issue. ## Core Features & Use Cases - Structured User Interview: Walks the user through problem description, alternatives considered, implementation scope, and testing strategy before writing anything. - Codebase Verification: Explores the repository to validate the user's claims and checks existing test coverage of the affected area. - Incremental Commit Plan: Breaks the refactor into the smallest possible commits following Martin Fowler's principle that the codebase stays working after every step. - GitHub Issue Output: Files the final plan as a GitHub issue using a fixed template covering problem, solution, commits, decision record, 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, inspects the code, then produces a GitHub issue with a step-by-step commit plan. ## Quick Start Ask the assistant to create a refactoring plan for the module you want to change and file it as a GitHub issue.

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 refactoring safely?

Break the refactor into the smallest possible commits so the codebase stays in a working state after each step, following Martin Fowler's advice. This Skill guides you through an interview, verifies the codebase, and produces a commit-by-commit plan as a GitHub issue.

How to create a refactoring RFC as a GitHub issue?

The Skill interviews you about the problem, alternatives, scope, and testing, then files a GitHub issue using a fixed template with sections for problem description, solution, commit plan, decision record, testing decisions, and out-of-scope items.

Does the refactoring plan include specific file paths or code snippets?

No. The decision record deliberately excludes concrete file paths and code fragments because they become outdated quickly. It documents modules, interfaces, architectural decisions, schema changes, and API contracts instead.

What happens if test coverage is insufficient for the refactor?

The Skill checks the codebase for test coverage of the affected area during planning. If coverage is insufficient, it asks the user about their testing plans before finalizing the implementation plan.

When should I not use an interview-based refactoring plan?

For trivial renames or single-file cleanups, a full interview and GitHub issue adds unnecessary overhead. The Skill targets substantial refactors where scope, alternatives, and testing strategy need explicit documentation.