cd /news/developer-tools/ai-code-comments-are-getting-unbeara… · home topics developer-tools article
[ARTICLE · art-105163] src=pradeeproark.com ↗ pub= topic=developer-tools verified=true sentiment=↓ negative

AI code comments are getting unbearable

Developers are increasingly frustrated by verbose AI-generated code comments that often misstate the code's intent, leading to confusion and anger among agents and humans returning to the codebase. One developer plans to write a lint rule to prohibit such comments.

read1 min views1 publishedAug 20, 2026
AI code comments are getting unbearable
Image: source

AI code comments are getting unbearable #

AI’s have appeared to learn a new trick to help them with context. It looks like this was done to help an agent returning to a code base for improvements. What they do is to add a lot of verbose comments on why something does the way it is. An agent reading it gets better context instead of inferring the motivations behind the code. Unfortunately they don’t always do a proper job, they leave comments which are “intent” but not done. Like a “we did X here because …” but actually no X was done. Agents returning to the code base come across this and are angry. God knows why the other agent left a comment like that.

I am going to write a lint rule to stop writing comments and see how it goes.

── more in #developer-tools 4 stories · sorted by recency
sponsored brought to you by zahid.host 4,200+ EU-deployed projects
reading about agents? ship yours in a single git push.

Run your AI side-project on zahid.host

EU-based hosting, git-push deploys, automatic HTTPS, no cold starts. Free tier with a custom domain — perfect for shipping the agent you just read about.

$git push zahid main
Live at https://your-agent.zahid.host
Get free account → Pricing
from €0/mo · no card required
LIVE [news/ai-code-comments-are…] indexed:0 read:1min 2026-08-20 ·