writing-revise

Revise a draft's substance against critique findings or a brief — structural and argumentative changes with a change log, meaning changed deliberately. Use when the user wants restructuring, a differe

SKILL.md

GitHub

Revise

Change the substance while holding the commitments fixed. Where writing-edit touches sentences with meaning fixed, this touches meaning and shows its work.

  1. Establish the target. The writing-critique findings, or the user's brief. If neither exists and the change is structural, run writing-critique first — revision without a diagnosis degenerates into taste-based rewriting, and the user loses the thread of why anything moved.
  2. Inventory the commitments before touching anything: facts, numbers, names, exact terms, promises to the reader, qualifiers, the audience, and — for fiction — established canon in the bible (facts, timeline, voice tells, who-knows-what). These are protected; a revision may not quietly change them. Inventing a fact to bridge a gap is the one unforgivable revision.
  3. Revise from the top down: spine, then structure and scene order, then paragraphs, then sentences. A lower-tier fix is wasted when a higher-tier change relocates it — fix the spine, then re-read, then the next tier.
  4. Surface conflicts, never bridge them. When a needed fix would change a commitment, remove a condition, or require material you don't have, stop and present the conflict with its tradeoff. Never invent a fact, source, or scene to bridge a gap; a new scene or section is proposed, not smuggled.
  5. Re-read the file from disk before each write. Edit in place; never overwrite text the user has changed. If the user edited a passage since you read it, their edit outranks the plan — re-plan around it.
  6. Return a change log keyed to the findings or brief: what moved, what was cut, what was added, and any commitment renegotiated. A revision the user cannot audit is a revision they cannot trust.

Handoffs: line polish afterwards is writing-edit; new material that changes the canon goes through writing-bible so the ledger stays true.