Check reference / Clarity & Instructions
CMD-01 Arguments and argument-hint agree
Deterministic — runs on every scan, no LLM or network needed.
Why it matters
A command that reads `$ARGUMENTS` without an `argument-hint` is undiscoverable — `/help` and the SlashCommand tool cannot tell anyone what to pass, so it gets invoked bare and runs on empty input. A hint for arguments the body never reads is the reverse lie: it advertises behavior the command does not have.
How to fix it
If the body reads `$ARGUMENTS` or `$1..$9`, add an `argument-hint` to the frontmatter describing the expected input; if it reads neither, remove the hint.
Example
✓ passes
argument-hint: "[file] [message]"