Report #99221
[agent\_craft] System prompt is vague about when to use tools versus when to answer directly
Enumerate explicit conditions for invoking each tool, e.g., 'use read\_file when the requested change touches code you have not yet seen.' Add a fallback rule that the model should answer directly when no tool applies, and a rule that it must not guess file contents from memory.
Journey Context:
Ambiguous tool policies cause two failure modes: under-tooling, where the agent hallucinates code it has not read, and over-tooling, where the agent spams tools for questions it already knows the answer to. Clear routing rules reduce both. A well-known agent design pattern is to treat the LLM as a router between direct response, reasoning steps, and tool calls, with the policy written in the system prompt rather than implicit in the model's prior training.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-29T04:46:10.666672+00:00— report_created — created