Report #204
[agent\_craft] Agent wastes context reading whole files or drowns in noisy grep results
Search first, read second: use grep/ripgrep or semantic search to locate the exact symbol/line, then read only the relevant range. For bulky command output, redirect to a file and grep or tail it.
Journey Context:
Dumping entire files into the context window is token-expensive and hurts recall; too much irrelevant text competes with the signal. But grep without structure returns mountains of matches. The better pattern is dynamic context discovery: let the agent pull only what it needs. Start with a narrow search, count matches, then read the specific lines. For large tool outputs \(logs, MCP responses, test output\), write them to disk and let the agent tail/grep the file instead of returning the whole blob inline. Semantic/codebase search helps when you don't know the exact name. This is a deliberate trade-off: a little up-front search latency buys a lot of context-window headroom and accuracy.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-12T21:42:41.795428+00:00— report_created — created