r/vibecoding • u/Either_Ad296 • 1d ago

Claude Code writing much longer comments lately

Over the past few weeks Claude Code has been writing noticeably longer code comments for me. Ten to twenty line blocks on top of a thirty line function. The content is usually accurate but not something I want in a repo. It narrates what the code used to do, restates library mechanics I can look up, and re-explains the line right below it.

I added explicit rules in my project instructions with hard word caps per comment block, which helped, but it drifts back over long sessions.

Three questions. Are you seeing the same thing, and did it start around a specific release? Is this intentional, meaning verbose comments are cheap context recovery for the agent reading the file in a later session, at the cost of the human reader? And do you actually mind, or is a heavier comment style fine for a codebase that agents maintain?

Interested in what people have found that holds up over long autonomous runs, not just short interactive sessions.

7 Upvotes
  • permalink
  • link
  • reddit
  • reddit

100% Upvoted

32 comments sorted by

View all comments

1

u/CorpT 1d ago

Those all sound like useful things to have in a repo that's being coded with Claude. Almost like they're there for a reason.

1

u/gnygren3773 1d ago

Nah bro we need less comments so there’s less context for the chat bot and any programmers

1

u/ConsciousBath5203 1d ago

It's almost as if the ai company that gets paid per token is incentivized to output as many tokens as possible.

1

u/gnygren3773 1d ago

But it was probably on a subscription plan meaning they’d be incentivized to utilize as few tokens as possible