How does this skill prevent breaking downstream consumers?

It mandates a Consumer Audit and a Before/After Table to prove that the new path inherits every contract from the old path before any deletion is allowed to occur.

Is this skill restricted to specific programming languages?

While the examples mention Deno and TypeScript, the refactoring principles and auditing phases are applicable to any language where structural changes impact downstream dependencies.

What is the 'Gateway Audit' phase?

The Gateway Audit traces every value from entry point to consumer, identifying filters and gates that might silently block undeclared arguments in a new implementation.

Can this skill handle stale cache issues?

Yes, it includes specific verification steps for identifying and clearing environment-specific caches (such as Deno's split directories) to ensure fixed code is correctly picked up.

Safe Refactoring Guide

Name: Safe Refactoring Guide
Author: tettuan

bytettuan

0•

Developer Tools

Ensures structural code changes are complete and safe by verifying contract preservation before deleting legacy paths.

This skill provides a rigorous, four-phase framework for refactoring code, migrating architectures, and reorganizing modules without introducing silent regressions. It facilitates a systematic audit of consumers, gateways, and contracts, ensuring that every behavior of the old code is proven to exist in the new path before deletion. By incorporating lessons from past incidents—such as stale cache issues and missing parameter declarations—it helps developers maintain system integrity during complex structural transformations and large-scale technical debt removal.

Key Features

01Automated consumer and documentation grep checks to eliminate dead code

02Four-phase refactoring workflow: Inventory, Design, Execute, and Verify

03Before/After behavior mapping for evidence-based code deletion

040 GitHub stars

05Environment-specific cache clearing procedures to prevent stale version bugs

06Contract and Gateway auditing to prevent parameter loss during migration

Use Cases

01Safely deleting deprecated code paths while ensuring zero regression in functionality

02Migrating legacy module architectures to modern patterns without breaking consumers

03Renaming core types or API exports across large, multi-dependent repositories

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add tettuan/climpt refactoring

For use in Claude.ai and ChatGPT

Download Skill