simplify
Use when the review is done and before SHIP, quality pass on the changed code (reuse, simplification, efficiency), no bug hunting.
SKILL.mdskills/simplify/SKILL.md
GitHubsimplify
Step 9 of the pipeline (WORKFLOW.md). Clean up what was built, once it's correct.
When
After review (reviewed), before ship.
Steps
Re-read the diff: missed reuse, duplicated code, pointless indirection, over-abstraction.
Simplify at identical behaviour (the GATE tests stay green).
Check consistency with what
archi(3) wrote down, and mark as built what is now built — so the architecture record stops describing a plan and starts describing the code.Prove the behaviour held: run the same proof you ran at the gate, on the simplified code, and read the result (
skills/gate§8). A simplification you did not re-verify is a change you did not review.A simplification that moves responsibility between files or layers is a structural change: follow
skills/safe-refactorfor it (proof first, one boundary per step) rather than folding it into this pass.Remove only what the change itself made redundant; leave neighbouring code and report it instead (
skills/code-baseline§0).
Output / checkpoint
simplified.
Guardrails
Quality only: no bug hunting here (that was review/gate). Don't change behaviour; if a
simplification breaks a test, it's a real change → back to code. Never edit a test to make a simplification
pass: that is the behaviour change, hidden (skills/tdd).
Origin
Native Claude Code (simplify skill) + internal, rewritten.