Blogmark

Claude models have been doing way too much yapping in the code comments in recent weeks. So I've been experimenting with a simple "Code Comments Conventions" section in the CLAUDE.md file.

"Only write code comments that cover critical and unintuitive behavior, preferring concision and clarity. A comment should have long-term durability. Skip the comment if it is only disclosing reasoning about the specifics of this change."

It must be working because after about a week of using this I ended up on a branch that didn't have these changes yet and was bowled over by the sudden verbosity of the comments.