Skills
.Work. You
Rest

systematic-refactoring

Community

Safe, phase-gated refactoring with strict gates.

Software Engineering#refactoring#commit#code-quality#plan#version-control#tests#characterization
Authornotque
Version1.0.0
Installs0

System Documentation

What problem does it solve?

Safe, phase-gated code refactoring ensures changes are small, verifiable, and isolated by requiring characterization tests and incremental commits to prevent regressions.

Core Features & Use Cases

  • Characterization tests first: Capture current behavior before any modification.
  • Incremental commits: Make one atomic change per commit and validate after each step.
  • Gate-driven workflow: Follow phases CHARACTERIZE, PLAN, EXECUTE, VALIDATE to manage refactors safely.
  • Preserve external API: Changes stay backward compatible unless explicitly requested.
  • Caller migration discipline: Update all call sites in a controlled, verifiable manner.

Quick Start

Run characterization tests to capture current behavior, then follow the PLAN and EXECUTE steps with one atomic change per commit and validate tests after each step

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: systematic-refactoring
Download link: https://github.com/notque/claude-code-toolkit/archive/main.zip#systematic-refactoring

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 471,000+ vetted skills library on demand.