Writing an AGENTS.md
One guide per ecosystem, because the advice genuinely differs. A Python project's biggest problem is the unpinned runtime. A Java project's is that nothing exposes a test command. Every number below was measured, not assumed.
TypeScript
median 71
Most common gap: instruction quality, in 47% of them
Python
median 60
Most common gap: pinned runtime version, in 84% of them
Go
median 70
Most common gap: instruction quality, in 51% of them
Rust
median 63
Most common gap: lint and format rules, in 58% of them
JavaScript
median 60
Most common gap: static type checking, in 76% of them
Java
median 44
Most common gap: lint and format rules, in 100% of them
C++
median 42
Most common gap: pinned runtime version, in 88% of them
Start with the general one
What AGENTS.md is, what belongs in it, and what makes one useless regardless of language.
Or skip the reading. Point the tool at a repository and it drafts one from what is already there: the install command from your lockfile, the commands you already declare, your real directory layout.