request-refactor-plan

Interview stakeholders to create an RFC-style refactor plan with tiny commits.

Updated Mar 23, 2026
One-click install
npx skills add https://github.com/fray-cloud/coin --skill request-refactor-plan-fray-cloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/fray-cloud/coin/tree/main/.agents/skills/request-refactor-plan
Command: npx skills add https://github.com/fray-cloud/coin --skill request-refactor-plan-fray-cloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps software teams plan and document refactors by interviewing stakeholders, producing a clear, tiny-commits RFC and a GitHub issue for safe incremental changes.

Core Features & Use Cases

  • Interview-driven problem definition to align the refactor scope
  • Incremental commit plan broken into tiny, verifiable steps
  • RFC-style documentation and GitHub issue generation template

Quick Start

Describe the refactor goal in detail to start the interview workflow and generate a tiny-commits RFC.

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 software refactor with incremental git commits?

To plan a software refactor with incremental git commits, you can use an interview-driven workflow that defines the problem scope and breaks the solution into a verifiable, commit-by-commit breakdown. This approach ensures each step remains auditable and safe.

What is an RFC-style refactor plan and when do I need one?

An RFC-style refactor plan is a document containing problem and solution statements, incremental commit steps, decisions, and testing scope. You need one when coordinating complex code changes to ensure safe, verifiable, and well-documented architectural updates.

How do I create a GitHub issue for an architecture refactor plan?

To create a GitHub issue for an architecture refactor plan, you generate an RFC-style template from interview answers that scopes the changes. The resulting issue documents the tiny commits, testing requirements, and architectural decisions for your team.

Can I scope a code refactor through a user interview?

Yes, you can scope a code refactor through a user interview to align stakeholders on the exact problem. This interview-driven problem definition ensures the resulting incremental commit plan directly addresses the intended architectural goals.

What is the best way to break down a large code refactor into tiny commits?

The best way to break down a large code refactor into tiny commits is enforcing an RFC-style plan with a commit-by-commit breakdown. This method scopes each change incrementally, ensuring every step is verifiable and auditable during review.