aihero.dev·May 7, 2026
The AI Coding Dictionary explains that AGENTS.md is a file loaded at the start of a session that serves as a project's brief to the agent, but warns against using it for content that should be progressively disclosed, as it incurs a token cost. It encourages users to avoid unnecessary token expenditure by properly utilizing skills for content management.
Ensure that your AGENTS.md file is optimized by avoiding unnecessary content that could incur token costs every session turn. Instead, leverage progressive disclosure techniques by placing comprehensive guides or instructions behind skills, minimizing upfront token consumption and enhancing efficiency in AI workflows.