Stop Using /init for AGENTS.md

This title could be clearer and more informative.Try out Clickbait Shieldfor free (5 uses left this month).

Auto-generated AGENTS.md files (produced via /init) hurt AI coding agent performance and inflate costs by 20%+ because they duplicate information agents can already discover by reading the codebase. Two 2026 research papers show LLM-generated context files reduce task success while increasing cost, whereas human-written files help only when they contain non-discoverable information like tooling gotchas, non-obvious conventions, and hidden landmines. The right mental model is to treat AGENTS.md as a minimal, living list of codebase friction points that can't be inferred—not a comprehensive onboarding document. Every discoverable line is noise that competes with the actual task via context dilution. A better architecture involves a routing layer with dynamically loaded, task-specific context rather than a monolithic static file, though tooling support for this is still lacking.

#ai-agents

#context-engineering

#llm

#productivity

#prompt-engineering

Feb 24•13m read time•From addyosmani.com

Table of contents

What the research actually says The pink elephant problem The case against /init specifically What actually earns a line The static file problem The better architecture people aren’t building yet The automated optimization angle The right mindset for AGENTS.md What the research doesn’t resolve Practical takeaways