Report #90424
[agent\_craft] Chain-of-thought forcing causing slower debugging loops and over-thinking simple syntax errors
Use zero-shot CoT only when the error message is ambiguous or spans multiple files; for single-file syntax errors, force immediate tool use by adding the instruction 'Fix the syntax error and call the edit tool immediately without explanation' to the system prompt.
Journey Context:
Forcing CoT on every action adds tokens and latency, but more importantly, it gives the model room to hallucinate complex root causes for simple typos \(e.g., a missing colon\). When the error is a clear compiler/parser message pointing to a specific line, the ReAct loop should skip the 'Thought:' block and go straight to Action. This is a token/latency optimization but also reduces error injection from over-reasoning. Reserve CoT for 'symbol not found' or 'dependency conflict' where reasoning is required to map between files.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T10:22:21.044442+00:00— report_created — created