Comment Pass
Removes comments restating the code and adds the ones explaining why, which is the only kind that does not go stale into a lie.
Free — no card needed
Create a free account
to open Comment Pass — and the other 364 prompts across 21 categories.
Already have an account?
Running it, start to finish
- Paste the code with the decisions that are not visible in it.
- Delete the restating comments and fix the false ones.
- Replace what you can with better names.
What you get back
The output this produces, every time.
- Deletes comments that restate the code, which are the ones that drift into lies.
- Identifies where a better name or an extracted function beats a comment.
- Flags comments asserting invariants the code does not actually enforce.
Getting better results
Where this usually goes wrong, and how to avoid it.
- Tell it the hidden decisions. The why is the only thing worth commenting and it is the one thing not visible in the code. That field is the whole input.
- Fix the already-false comments first. A stale comment is worse than none because readers trust it and act on it.
- Put history in the commit message. A comment serves someone reading this line today. The story of how it changed belongs in git or an ADR.
More Coding prompts
All Coding →- Coding
Refactor With a Safety Net
Plans a refactor as a sequence of individually safe, individually shippable steps, with the characterisation tests that make each one verifiable.
ClaudeChatGPT000Open → - Coding
Review for the Bug, Not the Style
A code review that hunts correctness failures and states the exact input that breaks each one, instead of listing naming preferences.
ClaudeChatGPTGemini000Open → - Coding
Database Migration Plan
Plans a schema change that ships without downtime, in steps that are each independently safe and reversible.
ClaudeChatGPT000Open →
Written for The AI University. Every prompt in this library is original work — authored, tested and revised here, not collected from elsewhere. 365 of them, free with an account.
