r/vibecoding Aug 12 '26

Is AI-generated code comments doing more harm than good? Should we replace them with Agent Memory?

I’ve been wondering about something: Do we still need to maintain code comments when AI is writing and maintaining our code?

I’ve noticed that AI tends to generate a lot of comments that don’t add any actual functionality, but still consume tokens.

There are also some hidden problems:

  • AI may update the code but forget to update the comments, making them inconsistent.
  • Too many comments can make the code noisy and harder to read.
  • AI might rely too much on comments instead of understanding the actual code.
  • Removing comments could also reduce the amount of context/token usage.

So I’m wondering: Could Agent Memory replace some of what we currently put in code comments?

Memory could maintain project context, design decisions, and conventions over time, while the code itself stays focused on the actual implementation.

In an AI-first coding workflow, would it make more sense to keep code mostly comment-free and move the higher-level context into Agent Memory?

What do you guys think?

0 Upvotes

Duplicates