code-hygiene
Code Hygiene
A narrow, calibrated review pass — not a general bug hunt. lint catches syntactic violations,
test-coverage catches untested lines, and a normal correctness-focused review catches bugs — none
of those structurally catch an abstraction that got duplicated instead of reused, a feature that
validates but silently does nothing, or a comment that admits a gap nobody closed. This skill's job
is specifically the class of smell that only shows up when you read code against this repo's own
architectural mandates (CLAUDE.md) and ask "does this actually do what it claims to," not just
"does this compile and pass its own tests."
This skill reports; it does not redesign. A real architectural smell usually needs a design decision, not a mechanical patch — report it clearly enough that a human (or a follow-up planning pass) can make that call. See "Auto-fix policy" below for the one narrow exception.