A simple but very effective rule I use in Claude Code is this "comments[.]md" file.
It prevents Claude from writing slop comments like "increment counter" on already self-documenting code.
In /.claude/rules/comments.md:
## Comment Policy
### Unacceptable Comments
- Comments that repeat what code does
- Commented-out code (delete it)
- Obvious comments ("increment counter")
- Comments instead of good naming
### Principle
Code should be self-documenting. If you need a comment to explain WHAT the code does, consider refactoring to make it clearer.
Link to the original tweet with this rule (published on Jan 7, 2026).
In the tweet reply, Jordan Parker corrected the rule to not include the syntax from Cursor.
