Report #60687
[agent\_craft] Agent ignores available tools when many files or conversation history are in context
Place critical tool definitions at the very start \(system prompt header\) or very end of the context window; avoid burying them in the middle of long file listings or conversation history
Journey Context:
Research on LLM attention shows a U-shaped curve: high attention on start \(primacy\) and end \(recency\), with significant degradation in the middle. When agents process large codebases, tool schemas buried between file contents at positions 50-80 of 100 chunks are effectively invisible to the model. Common anti-pattern: dumping file tree first, then appending tools. Better: system header with tools, then user content, then optional tool reminder at end. This also explains why repeating critical tool constraints at the very end of long prompts improves adherence.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T08:20:54.056177+00:00— report_created — created