Maintaining an Open-Source Library With AI Agents: AGENTS.md and the Rule They Kept Breaking
Six weeks of go-proxmox with coding agents doing most of the typing taught me what belongs in AGENTS.md. Five parallel agents got the same API shape wrong, and a coverage metric bent the code around it.
On May 9th I merged #264. It added an AGENTS.md to
go-proxmox and a stub CLAUDE.md that just points at it. The next six
weeks ran through the v0.8.0 migration guide on June 15th. In that time main took 77 commits and +31,794 / -1,144
lines. The repo went from 84 to 186 .go files. Endpoint coverage went from 30% to
100% of the Proxmox API. Most of that code was typed by coding agents,
a lot of it by several at once. This is what that looked like from the maintainer’s chair. It’s…
