refactor

Analyze refactor requests and produce implementation plans or epics.

18|Updated Feb 14, 2020
One-click install
npx skills add https://github.com/subroh0508/colormaster --skill refactor-subroh0508
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: refactor
Source: https://github.com/subroh0508/colormaster/tree/main/.claude/skills/refactor
Command: npx skills add https://github.com/subroh0508/colormaster --skill refactor-subroh0508

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps teams turn refactor requests into actionable work plans without accidentally changing behavior, by analyzing scope, impact, and the safest execution path.

Core Features & Use Cases

  • Impact Analysis: Identifies affected files, modules, tests, and specifications before work begins.
  • Behavior Preservation Checks: Lists verification points to confirm that inputs, outputs, public APIs, and UI behavior remain stable.
  • Scale Routing: Determines whether the change fits a single plan or should be promoted to an epic for multi-PR execution.
  • Use Case: A developer wants to rename a client layer, simplify dependencies, or reorganize a module while keeping the app behavior unchanged.

Quick Start

Ask the refactor skill to analyze your requested change, identify the impacted code and validation points, and draft the appropriate plan or epic.

Frequently Asked Questions about refactor

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

FAQPage Schema
How do I safely plan a Kotlin module reorganization without changing behavior?

A safe refactor requires touch-file impact analysis and test tracing to generate behavior-preservation verification points. This process identifies affected files and public APIs before you begin codebase cleanup or module reorganization.

What is the best way to analyze the impact of a dependency reduction refactor?

The best way to analyze a dependency reduction refactor is by tracing touch-files to map affected modules, tests, and specifications. This impact analysis establishes verification points to confirm inputs, outputs, and UI behavior remain stable.

How do I route a large-scale UI refactor into an actionable epic?

You route large-scale UI refactors into epics through scale-based routing. This mechanism evaluates the refactor scope to determine if the behavior-preserving changes fit a single implementation plan or require multi-PR epic execution.

Does this refactor planning approach work for standardizing naming conventions?

Yes, naming standardization is supported by generating implementation plans that trace impacted files and tests. The refactor process applies behavior-preservation checks to ensure public APIs and UI behavior remain stable during standardization.

When should I use an epic instead of a single plan for a codebase cleanup?

You should use an epic for a codebase cleanup when the refactor scope demands multi-PR execution. Scale-based routing evaluates the touch-file impact analysis to promote large behavior-preserving changes from a single plan to an epic.

How do I verify behavior preservation during a client layer rename?

To verify behavior preservation during a client layer rename, the generated plan lists explicit verification points confirming inputs, outputs, and public APIs remain stable. It traces affected tests and specifications to validate the refactor.