AI Guides › Claude Mastery
By Nigel Guy · 2 min read
"Can you fix this up" is the instruction people give whether they want a comma moved or the whole thing restructured from scratch, and the two are not close to the same job. Claude has to guess which one you meant, and it will guess wrong often enough to be a real source of the "this isn't what I asked for" feeling — not because the writing was bad, but because the wrong kind of change was made to it.
The rule: editing preserves the structure and mostly the wording and fixes what's broken in place; rewriting starts over from the intent and produces new wording throughout — decide which one you want before you ask, because the instruction that gets you one will actively get in the way of the other.
| Editing | Rewriting | |
|---|---|---|
| What stays | Structure, most sentences, your original phrasing | Only the underlying facts and intent |
| What changes | Specific errors, weak spots, flagged sections | Everything — sentence by sentence |
| Ask for it with | "Edit this — fix the grammar in paragraph two and tighten the opening, leave the rest" | "Rewrite this from scratch — same points, but as a punchier, shorter version" |
| Right when | The draft mostly works and you know what's wrong with it | The draft's approach itself isn't working, not just its execution |
| Wrong when | The whole approach needs to change (editing patches over a bad foundation) | You actually like most of the original wording (rewriting throws it away needlessly) |
Say which one explicitly. "Make this better" (see the companion guide on that exact phrase) collapses this decision into one vague word and leaves Claude to guess; naming edit-or-rewrite up front removes the guess entirely.
Skip asking for a full rewrite when you only disagree with one paragraph — you'll get new wording throughout and have to re-check all of it, when a targeted edit would have left the parts you already approved untouched. And skip iterating with small edits when the actual problem is structural — patching sentence by sentence around a fundamentally wrong approach wastes more rounds than a single honest rewrite would have.