Lauren Tan urges banning most code comments because coding agents copy them
Overview
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.
lauren@potetoXLauren Tan urges banning most code comments to stop agents copying themAILauren 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.