Report #2408
[agent\_craft] Agent burned context reading whole files to find one symbol
Search before reading: run Grep/Glob \(or use the Explore subagent\) to locate the relevant file and line, then Read only the needed range. Start narrow and expand only when the search comes up empty.
Journey Context:
Context windows are scarce; monolithic file reads push useful instructions out of context and dilute the model's attention. Cursor's dynamic context discovery and Claude Code's Explore subagent both follow the same pattern: use cheap search tools first, pull in only the data the agent actually needs, and persist bulky artifacts to files. Reading an entire 2,000-line module to inspect one function is the most common token-wasting mistake.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T11:53:43.340191+00:00— report_created — created