Skip to content
Trending storyDeveloping

Lauren Tan urges banning most code comments because coding agents copy them

1 article1 sourcesince Oct 13Last article 2h ago ·

Overview

AISummary of 1 article

Lauren Tan (@poteto) says coding agents copy existing code comments, so temporary workaround notes spread through codebases, and recommends banning and deleting most code comments.

He points to pstack's /no-comments skill as a tool to find and prune useless comments. He says comments that explain real quirks, such as a browser quirk, should be kept.

Tan also suggests a prompt that uses a swarm of agents to identify comments to prune and to recommend refactoring or deletion for each workaround. The report is a single X post, and no tests or results from applying the approach are given.

Written by AI from the articles below · updated Oct 13, 7:37 PM ET

Check the sources:

Article timeline

The articles in this story. Times are ET.

Oct 13
  1. laurenX
    Lauren Tan urges banning most code comments to stop agents copying them

    AILauren Tan (@poteto) says agents copy existing code comments, so temporary workaround notes spread through codebases and should mostly be removed. She recommends pstack's /no-comments skill to find and prune useless comments while keeping ones that explain real quirks, such as a browser quirk. She also suggests a prompt that uses a swarm to identify comments to prune and recommend refactoring or deletion for each workaround.

Heat trend

Current comparable heat
9
Peak comparable heat
10Oct 13, 8:00 PM ET
Change in past 24 hours
–

The trend compares only continuously observed participants, so its scope may be smaller than the current heat total. Hover or tap for hourly heat; use arrow keys with a keyboard.