docs-drift-guard

"Docs are part of done." A change that renames a flag, adds a command, or flips a default is not finished the moment the code compiles — it is finished when every doc that describes the old surface has been found and updated to describe the new one. This guard blocks the completion claim until that grep has actually been run.

The failure mode this guard targets is AI-slop documentation: grammatically perfect JSDoc/README prose that describes what the model thinks the code does — inferred from the function/flag/command name — rather than what it actually does after the rename. A renamed flag silently drifts from its own docs because nothing forced the two to be checked against each other.

When to use — three modes