What
Claude writes project documents with the project_write tool. The tool now gives Claude extra guidance about which file path to use. Both additions appear only when a certain condition holds. The findings do not say what that condition is.
- Read-first error: Claude has to read a file before writing it. The error Claude gets for a file it has not read used to end with "or pass its text as content." It can now add another sentence. If the file is an unchanged copy of a file Claude wrote with a tool, Claude should pass the path where it wrote that file.
local_pathguidance: the description of the tool'slocal_pathinput now adds a note. Claude should give the path where it read or wrote the file, not the path of a copy that a shell command made.
Why
In practice, Claude is steered away from copying a file with a shell command and uploading the copy. It uses the original file it already worked with instead, which helps the existing read-before-write check succeed.