LGTM
← Back to the feed

Post #733

Matt Pocock @mattpocockuk

Open on X

Prompt of the day (a long one): Take a look at every code comment in <my codebase | this section of the code>. Categorise each comment as: - Tautology: simply repeats what is already visible from the code - Excuse: many comments allow the agent to get away with a hacky implementation, which then gets propagated through the code - Stale: references code or implementation information that is no longer relevant - Decision Record: documents an important, non-obvious decision about the code For each comment, take this action: - Tautology/Stale: delete the comment - Excuse: delete the comment and file an issue to fix the hacky implementation - Decision Record: move it into an ADR Once this is done: - Create a lint rule banning comments for <my codebase | this section of the code> - Take a ratchet approach, assuming not all comments will be deleted this PR - Create a /delete-comment skill in this repository so we can repeat this process later - Estimate for me how many lines of code w…

Open on X ↗· 2 views · 2 clicks

Join the conversation with the author on X.