Post #733
Matt Pocock @mattpocockuk
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…
Join the conversation with the author on X.
SHARE YOUR PICK
Put it on your timeline.
Post the link on X. This card shows up as the preview.
