The LLMs I use know what an ADR is; try asking for one the next time you and the agent come up with a significant one. What I will do is in Claude/agents.md specify where decisions live (usually docs/decisions), and then during inference I’ll ask them to produce one. I am using Claude mostly, and I find that it proactively reads most docs (too many lol), but something like the Pi harness may need explicit cues or a skill.

The “how” is less important though ime; keeping it from getting out of hand is the real trick. Agents will happily file ADRs all day and align their decisions with all of them, and this will cost you $tokens. Yegge’s recent article resonated with me for precisely this reason - I am in no way using these tools at his scale, but am seeing the same behavior. Its sunday, and an agent has asked me to “ratify” an adr twice already :)