Keep the why next to your code.

Comments narrate what the code already says, then drift until they lie. koment stores the reasoning outside the source, anchored to the exact lines it explains — and fails a check the moment it stops matching.

// retry 3 times because the API is flaky
for attempt := range 5 {

for attempt := range 5 {

  gotcha  retry.go:12  ok
  Five attempts, not three: the upstream rate limiter
  returns 429 for up to four seconds and the fourth
  retry is the first that can succeed.

Edit the loop and the annotation reports drifted instead of quietly misleading the next reader.