request-refactor-plan

Create a detailed refactor plan via user interview and file it as a GitHub issue.

356|59|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/amazingloft999-droid/mattpocock-skills --skill request-refactor-plan-amazingloft999-droid
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/amazingloft999-droid/mattpocock-skills/tree/main/skills/deprecated/request-refactor-plan
Command: npx skills add https://github.com/amazingloft999-droid/mattpocock-skills --skill request-refactor-plan-amazingloft999-droid

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps engineering teams convert vague refactor ideas into a detailed, auditable plan, captured as a GitHub issue, with a sequence of tiny commits to minimize risk.

Core Features & Use Cases

  • Interview-driven planning: collect scope, constraints, and success criteria from stakeholders.
  • RFC and issue generation: produce a formal refactor plan document and a GitHub issue describing tiny commits.
  • Safe incremental changes: break large refactors into small, verifiable steps with clear rollback guidance.

Quick Start

Describe the refactor goal and let the skill generate a GitHub issue with a plan of tiny commits.

Frequently Asked Questions about request-refactor-plan

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

FAQPage Schema
How do I break a large codebase refactor into safe incremental steps?

A codebase refactor plan converts vague ideas into a detailed, auditable document via user interviews. It collects scope, constraints, and success criteria from stakeholders to ensure safe incremental changes across projects.

How do I create a GitHub issue for a codebase refactor plan?

To create a GitHub issue for a refactor, an automated skill conducts a user interview to define scope and constraints. It then generates and files a GitHub issue containing tiny-commit sequences and PR templates to guide implementation.

Can I use tiny commits to plan an RFC for complex changes?

Yes, you can use tiny commits to plan an RFC for complex changes. The planning process breaks down refactors into small, verifiable steps with clear rollback guidance, generating formal RFC documents and GitHub issues to guide implementation.

What is the best way to document a refactor plan for stakeholders?

The best way to document a refactor plan is an interview-driven approach that captures stakeholder constraints and success criteria. It produces a formal plan document filed as a GitHub issue, ensuring the refactor is auditable and easy to track.

Does planning a codebase refactor require user interviews for scope definition?

Planning a codebase refactor uses user interviews to accurately define scope and constraints. This interview-driven planning collects success criteria from stakeholders before generating a GitHub issue with tiny commits, ensuring the refactor meets project goals.