290ffada
retro: what the comment audit cost
a73x 2026-08-23 10:28
Commit message
RETRO.md
| Old | New | ||
|---|---|---|---|
| @@ -21,3 +21,11 @@ One line per push to `main`: what slowed the work down. Enforced by | |||
| 21 | meant rebuilding the old descriptor set from the tag by hand. The tree keeps | 21 | meant rebuilding the old descriptor set from the tag by hand. The tree keeps |
| 22 | every version of the .proto and no artifact of what a release actually put on | 22 | every version of the .proto and no artifact of what a release actually put on |
| 23 | the wire, so the compatibility claim had nowhere to be checked against. | 23 | the wire, so the compatibility claim had nowhere to be checked against. |
| 24 | - Comment audit: six agents worked in parallel worktrees forked from the same | ||
| 25 | commit, and by the time they finished, main had moved a rename underneath | ||
| 26 | them. The merge was clean and would have silently reverted it — nothing in | ||
| 27 | git distinguishes "did not touch this" from "restored the old name". Six | ||
| 28 | deletions were abandoned because their mutation evidence was gathered against | ||
| 29 | a tree that no longer existed. Proving the rest was comments-only needed a | ||
| 30 | purpose-built token-stream comparator; go/printer reflows, so a diff that | ||
| 31 | round-trips through it reads as changed when nothing was. | ||