Clogmeter

Posts · Monday 16 Nov 2026

Replace the explanation with one example command

Instruction files often spend a paragraph explaining how to run things: which test runner, which flags, how to target one file, when to skip the slow suite. The agent rereads all of it every turn and still guesses at the exact syntax.

Quick fix: replace each paragraph with the one command it describes, such as pnpm test -- src/api/user.test.ts. A real command is shorter, unambiguous, and the agent can copy it as-is. Keep a line of prose only for what the command can’t show, like “needs Docker running”. Then weigh the file again to see what you saved.

See which sections cost the most tokens → Clogmeter runs entirely locally and can export a trimmed copy. Nothing is uploaded.

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