alt Hacker News> agent write release notes for your agent in the future...
I have been going back to verbose, expansive inline comments. If you put the "history" inline it is context, if you stuff it off in some other system it's an artifact. I cant tell you how many times I have worked in an old codebase, that references a "bug number" in a long dead tracking system.
But how do you deal with communicating that some library you maintain has a behavior change? People already need to know to look at your code in order to read your comments.