request-refactor-plan

Interview users to plan refactors into tiny commits for GitHub issues.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps teams plan and document a refactor by interviewing the user to surface goals, constraints, and risks, then formalize the plan into a GitHub issue with a tiny-commit path.

Core Features & Use Cases

  • Guided user interview to extract problem statements and desired outcomes.
  • Breakdown of refactor work into a sequence of tiny commits with clear scope for each.
  • Automated generation of a GitHub issue template including Problem Statement, Solution, Commits, Decisions, and Testing sections.

Quick Start

Start by interviewing the user about the refactor and generate a GitHub issue with a tiny-commit plan.

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 code refactor with tiny commits for a GitHub issue?

Plan a code refactor with tiny commits by interviewing stakeholders to capture problem statements, define solution outlines, and break changes into a structured commit-by-commit sequence for a GitHub issue. This ensures safe, incremental refactoring with clear scope.

What should a GitHub issue template for a refactor proposal include?

A GitHub issue template for a refactor proposal should include a Problem Statement, Solution outline, Commits plan, Decisions, and Testing sections. These sections formalize goals, constraints, and risk areas discovered during the planning interview.

How do I break down a large software refactor into safe incremental changes?

Break down a large software refactor by guiding discovery through user interviews to surface goals and risks, then dividing the work into tiny commits with clear scope. Each commit represents a safe, incremental change suitable for tracking.

When do I need a guided interview to scope a refactoring project?

You need a guided interview to scope a refactoring project when you must surface hidden goals, constraints, and risk areas before coding. It verifies the current state and translates findings into a structured, commit-by-commit plan.

Can I generate a commit-by-commit plan for a GitHub issue without manual outlining?

Yes, you can generate a commit-by-commit plan for a GitHub issue without manual outlining by using an automated interview process. It captures the problem statement and solution outline, then structures the sequence into tiny, actionable commits.

What is the best way to document refactor decisions and testing strategies in GitHub?

The best way to document refactor decisions and testing strategies in GitHub is to generate a structured issue template. It captures decisions made during the scoping interview and outlines specific testing steps alongside the tiny-commit plan.