AGENTS.md moved AI performance up a model tier. Package trust needs the same.

AugmentCode analyzed dozens of AGENTS.md files across real codebases. The best result: a performance jump equivalent to upgrading from Claude Haiku to Opus. Same model, same task, one structured context file. The discovery data explains why: Root-level AGENTS.md: 100% agent discovery Directory-level READMEs: 80%+ Nested READMEs: 40% Orphaned /docs folders: under 10% The agent didn't fail to understand the documentation. It never found it. A decision table at the root beat a thorough narrative bu