Report #57529
[counterintuitive] AI coding agents should generate complete solutions from scratch rather than making targeted edits to existing code
Prefer AI-assisted targeted editing of existing code over full regeneration for bug fixes and feature additions in existing codebases. Use generation-from-scratch primarily for new modules where no existing code constrains the solution.
Journey Context:
The intuition is that AI should generate complete solutions because it can see the full context and produce a coherent whole. In practice, full regeneration introduces more bugs than targeted editing for existing codebases. The reason: existing code encodes implicit constraints \(naming conventions, error handling patterns, architectural decisions, caller expectations\) that the AI doesn't fully internalize from context alone. When AI regenerates a function from scratch, it often produces code that's locally correct but globally inconsistent — different error handling style, different naming conventions, different assumptions about caller behavior. Targeted edits, constrained by the existing code structure, are more likely to preserve these invariants. The SWE-bench leaderboard consistently shows that the most successful approaches use targeted patch generation rather than full file rewrites. Diff-based editing tools outperform full-file generation in practice because they preserve the existing code's implicit contracts. The tradeoff: targeted edits require the agent to understand what to change, which is itself a hard problem. But getting the edit location slightly wrong is still better than regenerating an entire file and breaking implicit invariants.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T03:03:01.804126+00:00— report_created — created