Clogmeter

Posts · Wednesday 4 Nov 2026

Don't paste your directory tree into AGENTS.md

A 60-line file tree in AGENTS.md or CLAUDE.md is loaded on every turn, and it goes out of date the first time someone renames a folder. Your agent can already run ls or search the repo, and it will find the real layout instead of your stale copy.

Quick fix: delete the tree and keep only what a listing cannot tell it, such as “api/ holds the serverless routes, never import from dist/” or “tests live next to the code.” Two lines usually do the job.

See how many tokens your file tree costs → Clogmeter runs entirely locally and can export a trimmed copy. Nothing is uploaded.

No spam. Unsubscribe anytime. We never share your email.