refactor

Guide iterative refactoring through clarifying questions and option-based design choices.

Updated Jan 25, 2026
One-click install
npx skills add https://github.com/Evan-acg/Evan-Skills --skill refactor-evan-acg
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/Evan-acg/Evan-Skills/tree/main/refactor
Command: npx skills add https://github.com/Evan-acg/Evan-Skills --skill refactor-evan-acg

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Before refactoring, this process must be used to ensure that the intent, requirements, and design are explored in depth through collaborative dialogue.

Core Features & Use Cases

  • Stepwise clarification: Start with understanding the current context and goals, then progress with one-question-at-a-time refinement.
  • Option-driven planning: Propose 2–3 design options with trade-offs to choose from.
  • Phased design & documentation: Present the design as segmented chapters, verify content with stakeholders, and maintain a task checklist for implementation.
  • Implementation readiness: Create an actionable plan with a clear scope, milestones, and testing considerations.

Quick Start

Initiate by outlining the current refactor scope and proceed with a single clarifying question to begin the guided design.

Frequently Asked Questions about refactor

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

FAQPage Schema
What is collaborative refactoring and when do I need it for software architecture changes?

Collaborative refactoring is a structured process to explore intent, requirements, and design direction before rewriting code. You need it for major software architecture changes, component rewrites, or cross-team codebase modifications to ensure design alignment.

How do I plan a major codebase refactor step by step?

To plan a codebase refactor, start by outlining the current scope and goals, then use a stepwise questioning loop to clarify intent. Evaluate 2-3 design options with trade-offs, segment the design into chapters, and generate an actionable task checklist with change documentation.

Can I use structured refactoring guidance for component rewrites across multiple teams?

Yes, structured refactoring guidance is designed for software projects planning component rewrites across teams and codebases. It facilitates collaboration by verifying modular design content with stakeholders through an iterative, option-based planning process.

What's the best way to document architecture changes during a collaborative refactor?

The best way to document architecture changes is through phased design and documentation. Present the design as segmented chapters, verify content iteratively with stakeholders, and maintain a task checklist with clear scope, milestones, and testing considerations.

How does option-driven planning work for software design refactoring?

Option-driven planning for software design refactoring proposes 2-3 design options with specific trade-offs to choose from. It enables iterative refinement by applying a step-by-step questioning loop to clarify requirements before finalizing a modular design output.

When should I not use a stepwise questioning loop for refactoring?

You should avoid a stepwise questioning loop for minor code modifications or isolated bug fixes that do not require major architecture changes. This structured refactoring approach is specifically built for complex, collaborative design direction across teams and codebases.