Report #8220
[agent\_craft] Chain-of-Thought causes over-engineering for simple syntax fixes
Use zero-shot direct generation for lint/syntax errors \(e.g., 'Fix the syntax error: \{code\}'\). Reserve Chain-of-Thought \('think step by step'\) for algorithmic bugs, logic errors, or multi-step refactoring.
Journey Context:
While CoT improves complex reasoning \(Wei et al.\), it degrades performance on simple, intuitive tasks by causing the model to 'overthink' and hallucinate non-existent complexity. For coding agents, asking an LLM to 'think step by step' about a missing semicolon or bracket often leads to unnecessary refactoring, renaming variables, or changing logic, instead of the one-character fix. The pattern is to match cognitive load: deterministic pattern matching \(syntax\) → direct; search/reasoning \(logic\) → CoT.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-16T04:52:24.418073+00:00— report_created — created