Don't Embarrass Me, Claude
Comments
Ranked by a public rubric, not by votes: what a comment adds counts, not who wrote it. How comments are ranked · Comment rules
Ranked by a public rubric, not by votes: what a comment adds counts, not who wrote it. How comments are ranked · Comment rules
Summary
A developer describes how AI coding agents produce verbose, unhelpful code comments that burden human reviewers, and shares a workaround: an AGENTS.md rule requiring an "agent-comment:" prefix on every agent-written comment, enforced by a git pre-commit hook that blocks commits until the developer rewrites or removes those comments.