skills.rest
tonomb
tonombCOMMUNITY
Explore all skills by this author →
Website𝕏@tono_mtzbGitHub

request-refactor-plan

Create incremental refactoring plans through structured interviews and codebase analysis.

Updated Apr 8, 2026
Search Tags:#planning#development#architecture#refactoring#codebase#github
One-click install
npx skills add https://github.com/tonomb/personal-pnl --skill request-refactor-plan-tonomb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: request-refactor-plan
Source: https://github.com/tonomb/personal-pnl/tree/main/.agents/skills/request-refactor-plan
Command: npx skills add https://github.com/tonomb/personal-pnl --skill request-refactor-plan-tonomb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the challenge of managing complex code refactors by breaking them down into safe, manageable, and verifiable steps, preventing regressions and architectural drift.

Core Features & Use Cases

  • Structured Interviewing: Guides the user through a detailed discovery process to define the problem, scope, and desired outcomes.
  • Incremental Planning: Translates high-level goals into a sequence of tiny, atomic commits that keep the codebase in a working state.
  • GitHub Integration: Automatically formats and generates a comprehensive GitHub issue template to track the refactor lifecycle.

Quick Start

Initiate the request-refactor-plan skill to begin an interview about the specific module or architectural change you wish to implement.

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 safe, incremental codebase refactor without causing regressions?▼

To plan a safe codebase refactor, you must break complex architectural changes into tiny, atomic commits that keep the codebase working. This approach prevents regressions and architectural drift by verifying each step before moving to the next.

What is the best way to translate high-level architectural goals into a step-by-step refactor plan?▼

Translating high-level architectural goals into a refactor plan requires structured interviewing and codebase analysis. This process defines the problem scope and desired outcomes, then sequences them into verifiable implementation steps for technical debt reduction.

Does this refactoring process integrate with GitHub issues for tracking technical debt?▼

Yes, incremental refactoring integrates with GitHub issues by automatically formatting and generating a comprehensive issue template. This tracks the entire refactor lifecycle and standardizes documentation for technical debt reduction tasks.

Can I use this structured refactoring approach for complex software engineering tasks on any codebase?▼

Yes, you can apply structured refactoring to any complex software engineering task on a codebase requiring safe, step-by-step implementation strategies. It is specifically designed to manage architectural changes through detailed discovery and incremental planning.

When do I need an incremental refactoring plan instead of a standard code update?▼

You need an incremental refactoring plan when facing complex software engineering tasks that risk architectural drift or regressions. If a change requires atomic commit planning and safe, verifiable implementation steps, standard updates are insufficient.

Related Skills

Explore More Software Engineering Skills→
GDSDNGDSDN
3

document-project

Generate a brownfield baseline and architecture map for an existing codebase.

Community
Intermediate
DonTiziDonTizi
2

implement

Translate GitHub issue specs into incremental implementation plans with tests and commits.

Community
Advanced
AO-Cyber-SystemsAO-Cyber-Systems

df:map-codebase

Coordinate parallel mapper agents to produce eight codebase documents and CLAUDE.md.

Official
Advanced
0xRayAI0xRayAI

refactoring-strategies

Provide structured refactoring techniques to reduce technical debt and improve code maintainability.

Official
Intermediate