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.