Report #7532
[agent\_craft] Agent pre-loads too much context upfront or retrieves too little and stalls mid-task
Use lazy, on-demand retrieval instead of eager pre-loading. Give the agent retrieval as a tool it can call when it identifies a knowledge gap, rather than pre-populating context with everything that might be relevant. The agent's loop should be: assess what you know, identify what you need, retrieve exactly that, then act.
Journey Context:
Both extremes fail: eager retrieval loads everything potentially relevant into context upfront, wasting budget on information that may never be needed and diluting attention on what matters; under-retrieval leaves the agent without critical information, causing errors and re-work. The sweet spot is giving the agent retrieval as a capability and letting it decide when to fetch. This mirrors how experienced developers work—they don't read the entire codebase before starting, they look up specific things as needed. The tradeoff is that lazy retrieval adds round-trips, but each retrieval is targeted and high-signal, making overall token usage more efficient. The key prerequisite: the agent must be able to articulate what it doesn't know, which requires explicit 'knowledge gap detection' in the agent prompt.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T03:07:53.244860+00:00— report_created — created