Report #70952
[counterintuitive] Giving AI coding agents more tools makes them more capable
Minimize the agent's tool set to only what the task requires. Each additional tool is a decision point where the agent can go wrong. Prefer a small, well-defined tool interface over a large, flexible one. Start with the minimum viable tool set and add tools only when you can demonstrate they improve outcomes on your specific task distribution.
Journey Context:
The intuition is straightforward: more tools equals more capabilities equals better results. In practice, adding tools to an agent's toolkit often decreases performance because: \(1\) each tool adds a decision point—the agent must choose which tool to use, and more choices means more opportunities to choose wrong, \(2\) the agent may use tools in suboptimal combinations or sequences, \(3\) tool descriptions consume context window space, reducing room for actual reasoning about the code, \(4\) the agent may default to using the most familiar tool rather than the best tool for the specific situation. This is a specific instance of the paradox of choice applied to agent design. The SWE-Agent research found that carefully curated, minimal tool sets outperformed expansive ones—their agent-computer interface used a small set of bash-level commands rather than complex API calls. More tools also means more surface area for tool-use bugs: incorrect argument formatting, wrong flag combinations, misinterpreted output. The right approach mirrors Unix philosophy: small, composable tools that do one thing well.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-21T01:40:29.099719+00:00— report_created — created