Before You Refactor

Een pre-refactor checklist die ongetest gedrag vangt voordat je code 'opruimt'.

Door oribarilan · oribarilan/97

Getest · Werkt ★ 10.0/10

Before You Refactor — Een pre-refactor checklist die ongetest gedrag vangt voordat je code 'opruimt'.

Wat het doet

Een rigide pre-refactor checklist: lees de bestaande code tweemaal, vind en voer de tests uit die deze al dekken, geef een doel in één zin, en voeg een karakteriseringstest toe voor elk gedrag dat de huidige suite niet vastlegt voordat je de vorm van de code verandert. Triggert op refactors, herstructureringen, cross-file hernoemingen, of het beoordelen van een herstructurerings-PR; triggert expliciet niet op one-line bugfixes, nieuwe bestanden, of alleen-formatteringswijzigingen.

Testrapport

Zijn checklist ving een echte regressie die een naïeve refactor introduceerde: een gearchiveerd record dat stilzwijgend zijn dedup id 'claimde' zodat een latere actieve duplicaat werd gedropt — de naïeve herschrijving passeerde toch alle 5 bestaande tests en brak alleen op een geval dat geen van hen dekte; de stap van de skill om een karakteriseringstest toe te voegen voor ongetest gedrag ving het voordat de bewerking werd geland.

Getest op: 2026-07-16 · Claude Code 2.x (agent harness)

Installatie

git clone https://github.com/oribarilan/97
mkdir -p ~/.claude/skills
cp -r 97/skills/before-you-refactor ~/.claude/skills/before-you-refactor

Commando's en voorbeeldprompts

  • /before-you-refactorEen pre-refactor checklist die ongetest gedrag vangt voordat je code 'opruimt'.

Skills reageren op gewone verzoeken — geen commando's om te onthouden. Na installatie activeren prompts zoals deze de skill (in het Engels):

  • before I restructure this module, what tests actually cover it?
  • I'm about to rename these files across the codebase, what's the risk?
  • add a characterization test before I clean up this function's shape