Matt Pocock shares a prompt to audit codebase comments: classify, delete, and ratchet with lint

mattpocockuk · x · 2026-11-20

Matt Pocock shares a long prompt that has an AI agent audit every code comment by classifying it as Tautology, Excuse, Stale, or Decision Record—deleting the first three (filing issues for hacks), moving the last into ADRs. It then creates a lint rule banning comments, applies a ratchet approach, and adds a reusable /delete-comment skill. His verdict: 'comments considered harmful.'

Original post →

More from coding & agent

coding & agent channel →