Claude Code Says Done Before It Has Proved Anything. This Fixes It.
How to stop a coding agent from saying "done" before it has proved anything, and how to make it run ten checks at once instead of one at a time
Read this part first, because the name is ambiguous
There are two popular Claude Code skills with ADHD in the name, and neither of them is the other. If you install the wrong one you will get something genuinely good that does a completely different job, and you will think the guide was wrong.
- A skill named adhd that does parallel divergent ideation. It splits a question into five isolated agent branches under different framings, scores them, prunes, and deepens the best three. It is for thinking wider, not for verifying work. Around 4,000 stars, MIT.
- A skill named i-have-adhd that fixes output formatting, so the agent stops burying the answer under preamble. Very widely starred. Also not a verifier.
- And a third skill, not named ADHD at all, that is the one implementing the mechanism this guide describes: a written ledger, a check command that has to run, and a hook that refuses the word "done" until the check passes.
So treat "the ADHD skill" as a description of a behaviour, not as a package name. What follows is the behaviour, how to recognise a skill that actually implements it, and how to build it yourself in about twenty minutes if you would rather not install anything.
Keep reading
Free, for an email.
Unlocks 7 more sections, the document version, and every other guide on the site, for free. Enter your email once to keep reading.
19,000+ follow where these guides come from.No spam. Unsubscribe in one click.