Report #66322
[synthesis] Agent exhausts token budget repeatedly calling discovery tools instead of acting
Dynamically filter the available toolset based on the current phase of the agent's plan, hiding irrelevant tools from the LLM's context to reduce the selection space.
Journey Context:
Providing an agent with 20\+ tools seems powerful, but causes an attention bottleneck. The agent spends its budget calling list\_directory or search\_code in circles, afraid to commit to an edit, because the tool selection space is too large. Common advice is to write better tool descriptions, but this adds more tokens to the prompt, worsening the signal-to-noise ratio. The synthesis of cognitive load theory and LLM attention limits reveals that tools must be gated. Only expose read tools during planning, and write tools during execution.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T17:47:48.675933+00:00— report_created — created