← ClaudeAtlas

thalarch-refactorlisted

Behavior-preserving refactoring protocol for simplifying, restructuring, modularizing, or modernizing existing code without silently changing externally observable behavior. Use for non-trivial cleanup, decomposition, abstraction changes, package/module moves, or legacy modernization where regression risk matters.
LUC4N3X/antigravity-thalarch · ★ 2 · Code & Development · score 65
Install: claude install-skill LUC4N3X/antigravity-thalarch
# Thalarch Refactor A refactor changes structure without intentionally changing observable behavior. Bug fixes, feature changes, and refactors are separate operations unless the user explicitly combines them. ## 1. Freeze the behavior contract Before editing, identify the behaviors that must remain stable: - public inputs/outputs; - exceptions/error semantics; - side effects and ordering; - persisted/wire formats; - timing/concurrency guarantees that callers depend on; - ABI/API/binary compatibility where relevant. If tests are weak, create or locate characterization evidence before broad restructuring when feasible. ## 2. Identify the actual pressure Name the reason for the refactor: duplicated knowledge, ownership confusion, excessive coupling, unsafe state, difficult testing, dependency direction, obsolete platform pattern, or another specific maintenance cost. Do not refactor merely because a different style is aesthetically preferred. ## 3. Small semantic steps Prefer a sequence where each step is independently understandable and verifiable: - rename; - extract/move; - replace data shape; - invert dependency; - remove duplication; - delete old path. Avoid simultaneous formatting, renaming, behavioral changes, and architecture movement in the same diff unless unavoidable. ## 4. Abstraction test Before creating an abstraction ask: - what repeated knowledge or dependency boundary does it own? - are there real consumers today? - does it reduce coupling or mere