Does this skill work with any programming language?

Yes, it is designed to be language-agnostic. It adapts the refactoring patterns and test-running commands to the specific language and framework used in your repository.

What makes this refactoring process 'safe'?

It is safe because it mandates running the full test suite after every single small change. If a test fails, the change is immediately undone, ensuring the codebase never stays in a broken state.

Can I use this skill to fix bugs or add features?

No, this skill is strictly for refactoring—improving code structure without changing behavior. Bug fixes and features should be handled by specialized skills like 'fixing-bugs' or standard development workflows.

Why does the agent commit so frequently during refactoring?

Frequent commits create a clear history of transformations. This makes it easier to review changes, understand the evolution of the code, and revert to a known-good state if a complex step fails.

Safe Refactoring Agent

Name: Safe Refactoring Agent
Author: withzombies

bywithzombies

•

Developer Tools

Executes a strict, test-driven refactoring workflow to improve code structure through incremental transformations and continuous verification.

The Safe Refactoring Agent implements a disciplined 'Change → Test → Commit' cycle designed to eliminate the risks associated with large-scale code restructuring. By breaking down complex refactoring tasks into the smallest possible units, it ensures that your test suite remains green throughout the entire process. The skill utilizes integrated task tracking to manage goals and provides a clear audit trail of transformations, making it ideal for cleaning up legacy code, extracting utilities, or reorganizing architectures without introducing regressions.

Key Features

01Behavior-preservation enforcement to prevent accidental feature creep

02Strict incremental Change-Test-Commit cycle

03Automated test-runner agent dispatch for continuous validation

04Integrated task tracking via beads (bd) for complex transformations

05Strangler Fig pattern support for legacy system modernization

0658 GitHub stars

Use Cases

01Simplifying complex legacy functions by applying small, verifiable code transformations

02Extracting duplicated logic into shared utility classes without breaking existing services

03Reorganizing project file structures and module hierarchies while maintaining stability

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add withzombies/hyperpowers refactoring-safely

For use in Claude.ai and ChatGPT

Download Skill