Hoe de kwaliteit van AGENTS.md de output van coding agents vormt

Augment Code voerde gestructureerde benchmarks uit op hun interne codebase en ontdekte dat een goed geschreven AGENTS.md-bestand de agent output met 10-15% verbetert - ongeveer de kloof tussen Claude Haiku en Opus. Een slecht bestand presteert zelfs slechter dan geen bestand. De praktische bevindingen zijn specifiek: houd bestanden onder 150 regels, gebruik genummerde workflows in plaats van proza, koppel elke verbod aan een concreet alternatief, en geef de voorkeur aan beslissingstabellen bij meerdere geldige benaderingen. Een opvallend datapunt - agents die uitgebreide architectuurdocumenten laden, verwerken 80K irrelevante tokens en verliezen 25% op volledigheid. Ontdekkingspercentages tellen ook: AGENTS.md scoort 100%, geneste README\'s dalen naar 40%, en losse docs in zijmappen registreren nauwelijks. Naarmate Claude Code, Copilot en Cursor harder leunen op repo-niveau instructies, wordt het schrijven van goede agentdocumentatie een echte engineeringvaardigheid.