skills.rest
mia-cx
mia-cxOFFICIAL
Explore all skills by this author →
WebsiteGitHub

refactor-plan

Plans commit-by-commit refactor roadmaps and generates GitHub issue templates.

Updated Mar 23, 2026
Search Tags:#git#planning#worktree#interview#refactor#issues#tiny-commits
One-click install
npx skills add https://github.com/mia-cx/.agents --skill refactor-plan-mia-cx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: refactor-plan
Source: https://github.com/mia-cx/.agents/tree/main/skills/refactor-plan
Command: npx skills add https://github.com/mia-cx/.agents --skill refactor-plan-mia-cx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides a structured approach to planning refactors by interviewing stakeholders, validating the problem, and turning insights into a precise, incremental plan that can be filed as a GitHub issue.

Core Features & Use Cases

  • Interview-driven scoping to identify the exact refactor objectives and constraints.
  • Stepwise decomposition into tiny commits to ensure a safe, testable migration.
  • Generation of a GitHub issue template that documents the problem, solution, worktree setup, commits, decisions, and testing approach.
  • Guidance for testing coverage and risk assessment to reduce regression risk.
  • Real-world use: plan a monolith refactor into clearer modules with a staged rollout.

Quick Start

Describe the refactor problem in detail and let the tool outline a stepwise plan of tiny commits and a GitHub issue.

Frequently Asked Questions about refactor-plan

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

FAQPage Schema
How do I plan a safe refactor using tiny commits?▼

Planning a safe refactor involves breaking changes into tiny, testable commits using a structured roadmap. This approach enforces a scoped plan and a worktree-based workflow to ensure a safe, incremental migration.

What is the best way to break down a monolith refactor into safer steps?▼

The best way to break down a monolith refactor is stepwise decomposition into tiny commits. This generates a precise, incremental rollout plan to migrate modules safely while reducing regression risk.

How do I create a refactoring RFC with a GitHub issue template?▼

Creating a refactoring RFC involves documenting the problem, solution, and testing approach within a GitHub issue template. This captures stakeholder insights and worktree setup details to track decisions throughout the migration.

How do you validate refactor objectives before starting code migration?▼

Validating refactor objectives requires an interview-driven scoping process with stakeholders. This identifies exact constraints and turns insights into a precise plan before code migration begins.

Does planning refactors with tiny commits require a specific git worktree setup?▼

Planning refactors with tiny commits enforces a worktree-based commit workflow to isolate changes. This setup ensures safe, incremental migrations are tracked properly within the scoped plan.

Related Skills

Explore More Software Engineering Skills→
raphaelmansraphaelmans

request-refactor-plan

Plan structured refactor work into a GitHub issue template.

Community
Intermediate
rnaarlarnaarla

request-refactor-plan

Interview users to create a tiny-commit refactor plan and GitHub issue.

Community
Advanced
yonatangrossyonatangross
217

issue-progress-tracking

Automates GitHub issue tracking through labels, feature branches, commits, and PRs using gh CLI and git.

Community
Intermediate
cacr92cacr92
4

codex

Execute Codex CLI for code analysis, refactoring, and automated modifications.

Community
Advanced