Skip to content
Ben's Bites

What makes a good AGENTS.md?

Ben's Bites says AGENTS.md should keep only behavior preferences, not tech-stack maps or key files; the post cites a study saying that hurts performance and raises cost by 20%. It recommends symlinking AGENTS.md to CLAUDE.md, using conditional blocks, and relying on folder-level dynamic loading; the study name and setup are not disclosed. The real point is not more context, but smaller persistent instructions.

Why it matters: Research finds that stuffing AGENTS.md with tech stack and file paths hurts performance and burns 20% more tokens, while keeping only behavior preferences and correction hints works better.

Read the original ↗Export Markdown