Report #6340
[agent\_craft] Agent rewrites entire large files to make small changes, causing high token usage and merge conflicts with concurrent human edits
Use search/replace block or diff-based editing tools for modifications, and restrict full-file rewrites to files under a certain size \(e.g., 100 lines\) or when creating new files.
Journey Context:
Generating an entire 1000-line file to fix a typo burns thousands of output tokens and is slow. Worse, if a human edited a different part of the file while the agent was generating, the agent's full-file output will overwrite the human's changes. Diff-based or search/replace tools force the agent to specify exactly what to change. The tradeoff is that search/replace requires the agent to have the exact lines in its context to match, meaning it must read the file first. But this read-then-patch cycle is far safer and more token-efficient than generate-then-overwrite.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-15T23:48:33.589226+00:00— report_created — created