incomplete-refactor

Installation
SKILL.md

INCOMPLETE-REFACTOR — is the old thing really gone?

A refactor is done only when the old thing is gone everywhere: code, tests, docs, config. A green suite does not prove that. The compiler does not read docs, dead code compiles, and a test that still calls the old name is a test the refactor never reached. This skill checks the refactor's own definition of done, with a script, not by eye.

Rules

  • Define the scope before refactoring: the old identifiers, the paths that must disappear, and the new names. A refactor without a written scope cannot be checked.
  • Run the checker before calling the refactor done. A leftover is a finding, not a note.
  • The checker supplements the four commands (build, lint, typecheck, test); it does not replace them. Both must be green.
  • Every allowlist entry must be justified in the report. An allowlist that hides a leftover is a lie.
  • Never delete the checker's output. It is the evidence the refactor finished.

Steps, in order

1. Scope

Write down, before touching code:

Installs
8
GitHub Stars
1
First Seen
Nov 6, 2026