Guides/Craft Strategies

The Revision Workflow

A complete start-to-finish revision process

Before You Start ↓Stage 1: Structural Analysis First ↓Stage 2: Chapter-by-Chapter Review ↓Stage 3: Line-Level Analysis ↓Stage 4: Final Review ↓Tips for Staying Focused ↓

Before You Start

Revision is where manuscripts become books, but it only works when you approach it with structure. The single most important prerequisite is a complete draft. Revising chapter three while chapter twenty does not exist yet is a recipe for wasted effort, because the ending will change what the beginning needs to do.

The second prerequisite is a divided draft. Analysis reads structure, not word count. Anything that compares facts across your book — continuity, timeline, act structure — needs more than one chapter to compare between, and anything that judges a scene needs scenes to judge. A finished manuscript sitting in the app as a single undivided chapter will come back with very little to say, and that quietness is a measurement of the structure, not a verdict on the writing. Split the draft into chapters and scenes before your first analysis pass.

Before running any analysis, take five minutes to set your genre in Bookshaper's project settings. This one step calibrates every benchmark, insight threshold, and comparison range to match the conventions your readers actually expect. A literary fiction manuscript and a thriller operate by different rules, and the tools should reflect that.

Set your expectations clearly: revision is not one task but a series of focused passes, each with a different lens. Trying to fix everything at once leads to shallow edits that miss the real problems. The workflow below breaks revision into four distinct phases, each building on the one before it.

Resist the temptation to start editing sentences before you have evaluated the manuscript's structure. Polishing prose in a chapter that needs to be cut or restructured is time you will never get back.

Stage 1: Structural Analysis First

Start your revision at the highest altitude. Open Analyze and work through the Structural Analysis facets first — Scene weight, Dialogue balance, Chapter length, Tension flatness, and Pacing uniformity. Each one is a measured, reproducible read with its own coverage denominator (how much of the manuscript it actually examined) and a flag count when it has something to show you, so the list itself tells you where to look before you open a single facet.

These are not random flags. Each one is a located pattern that crossed a threshold — a run of consecutive scenes that never turns, chapters far out of proportion with the rest, a dialogue ratio that spikes against your genre, pacing that never varies enough to give the reader a sense of acceleration.

Bookshaper also offers a Copy Editor's Read — one interpretive take on how your book is built and how it moves, written as prose rather than as measured findings. Read it, because a second perspective is useful, but weigh it the way you would weigh notes from a copy editor you hired: worth considering, never a verdict. It is explicitly labeled as one reading, not a measurement, and you can turn it off in Settings › AI features if you want only the measured facets — it's on by default.

Write down the three biggest issues you find in this stage. These become your revision priorities for Stage 2. Everything else is secondary until these are addressed.

Check Tension flatness for stretches that never escalate and Pacing uniformity for a manuscript that never varies its tempo.
Open Scene weight for consecutive scenes classified at low tension with no work being done.
Scan the Presence tab under Characters for gaps where major characters vanish from the narrative — on your own tag map, on mention density, or on both.
Read the Timeline under Structure for chapter dates that move backward, and check Record Gaps for characters or places your prose introduces that your roster is missing.

Stage 2: Chapter-by-Chapter Review

With your structural priorities identified, work through your manuscript chapter by chapter, resolving the findings you flagged as you reach each one. For every finding you have three answers: Agree adds it to My Actions, your revision checklist; Set aside clears it for now without grading it, so a later read will not make you triage it again; Disagree, available once you open a finding's full detail, records that the read was wrong.

Work sequentially through your chapters rather than jumping around. There is no severity ordering to follow — a finding's coverage fraction and its plain-language claim tell you what it is and how much of the book it looked at, and you decide what matters most for your book.

For each chapter, read through the flagged findings and decide how to act on them. Some will require rewriting scenes. Others might call for splitting a chapter, combining two short scenes, or adding a transitional beat. Do not try to resolve every finding in a single sitting. Mark the ones that connect to your Stage 1 priorities and handle those first.

Agree to a finding to add it to My Actions, then work through that checklist front to back as you revise.
Pay special attention to continuity and timeline findings, as these compound across chapters.
When a finding suggests a structural change, make a note and keep moving. Batch structural edits after you have reviewed all chapters.

Stage 3: Line-Level Analysis

Once your structure is sound and chapter-level findings are resolved, move to Line-Level Analysis: Repetition, Sentence openers, Filter words, and Adverb overuse. These are deterministic scanners, not a synthesized style read — each one flags the same pattern on every run, with its own coverage fraction, so you can trust a clean facet as genuinely clean.

Repetition catches words and phrases that recur too closely together. Sentence openers catches runs of consecutive sentences starting the same way. Filter words catches overused distancing constructions ("she felt", "he saw"). Adverb overuse catches chapters running well above the book's own rate, and adverbs riding along in dialogue tags.

For anything beyond what the scanners catch, use the editor's craft tools on a selection: Refine rewrites a passage in your own voice as an accept-or-discard diff, and Proofread catches mechanical issues. Neither runs over the whole book automatically; you invoke them where you want them.

The four scanners are objective and reproducible, so a clean read is real news. Reach for Refine and Proofread for the line-craft judgment calls a deterministic scanner cannot make.

Stage 4: Final Review

After completing your line-level pass, return to Structural Analysis for a final check. This is not busywork. Your revisions have changed the manuscript, and you need to confirm that your fixes did not introduce new imbalances.

Re-check Tension flatness and Pacing uniformity to verify that your structural changes produced the shape you intended. If you added or removed scenes, your chapter balance may have shifted, so re-open Chapter length for new outliers.

Revision itself is a common source of continuity errors — changing a detail in chapter five without updating the reference in chapter twelve creates exactly the kind of contradiction that readers catch and never forgive, so a manual continuity pass (see the Continuity & Timeline guide) is worth the time here. The Timeline under Structure shows whether your chapter chronology still holds together after all the changes you have made.

Compare your current Tension flatness and Pacing uniformity findings against where you started.
Verify that no character has new presence gaps introduced by scene restructuring.
Run a final continuity check specifically looking for errors introduced during revision.
Review My Actions one more time to confirm your original top priorities have been resolved.

Tips for Staying Focused

The most common revision failure is not missing problems. It is trying to fix everything simultaneously. When you jump between structural edits, scene rewrites, and sentence polish in the same session, you make shallow progress on all fronts and deep progress on none.

Work in stages, not random fixes. Each stage of this workflow is a complete pass through the manuscript with a single lens. Finish one before starting the next. If you spot a sentence-level issue during your structural review, make a note and keep moving. You will catch it in Stage 3.

Trust the coverage denominators over any felt sense of how thorough you have been. A facet that reads 47 of 47 chapters reviewed, nothing flagged, is real news precisely because it says what it examined — a manuscript with several structural findings still open is not ready for line-level work, no matter how clean the prose reads.

Take breaks between stages. Revision demands a different kind of attention than drafting, and fatigue causes you to start accepting mediocre fixes. Step away between stages, ideally for at least a day. When you return, you see the manuscript with fresh eyes and make better decisions about what needs to change.

A focused two-hour revision session that addresses one category of findings will improve your manuscript more than an unfocused eight-hour session that touches everything.

← All guides Documentation FAQ

Proofread Mode Deep Dive

Reading Analyze