Guides/Craft Strategies

The Revision Workflow

A complete start-to-finish revision process

Before You Start ↓Phase 1: The Big Picture ↓Phase 2: Scene-Level Analysis ↓Phase 3: Line-Level Polish ↓Phase 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.

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.

Phase 1: The Big Picture

Start your revision at the highest altitude. Open the Key Findings view first, because it synthesizes signals from every dashboard into a short list of the most important issues. These are not random flags. They represent cross-dashboard patterns that indicate real structural problems, like a tension arc that never escalates or a point-of-view character who disappears for a hundred pages.

After reviewing Key Findings, move to the individual dashboards. The Manuscript Health dashboard shows you scene length distribution, chapter balance, dialogue ratios, and POV distribution at a glance. Look for outliers: chapters that are dramatically longer or shorter than the rest, dialogue ratios that spike or crash unexpectedly, or POV characters who dominate one section and vanish in another.

The Tension Plot and Pacing dashboards reveal the shape of your story's dramatic arc. A healthy manuscript shows rising tension with deliberate valleys for recovery. If your tension line is flat through the middle third, you have found the structural problem that matters most.

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

Check the Tension Plot for flat zones or premature peaks that undermine your climax.
Review the Pacing Distribution to see if your mix of action, reflection, and transition scenes matches genre expectations.
Scan the Character dashboard for presence gaps where major characters vanish from the narrative.
Use the Continuity dashboard to catch timeline errors and contradictions before they compound during revision.

Phase 2: Scene-Level Analysis

With your structural priorities identified, run a full analysis using the Analyze button in the ribbon toolbar. This is where you work through your manuscript chapter by chapter, using the Chapter Inspector to surface scene-level issues. The analysis engine draws from eleven insight sources, including continuity tracking, timeline validation, character consistency, pacing, and tone analysis.

Work sequentially through your chapters rather than jumping around. Insights are organized by severity: critical issues first, then warnings, then informational notes. Trust this ordering. A critical continuity error where a character references an event that has not happened yet matters more than an informational note about a slightly long scene.

For each chapter, read through the flagged insights 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 insight in a single sitting. Mark the ones that connect to your Phase 1 priorities and handle those first.

Use the Analyze button to run analysis on each chapter as you work through your revision.
Address critical and warning severity insights before moving to informational ones.
Pay special attention to continuity and timeline insights, as these compound across chapters.
When an insight suggests a structural change, make a note and keep moving. Batch structural edits after you have reviewed all chapters.

Phase 3: Line-Level Polish

Once your structure is sound and scene-level issues are resolved, switch to Proofread Mode for line-level polish. This phase has two distinct layers, and the order matters. Start with the grammar layer, then move to style.

The grammar layer covers five categories: passive voice, readability, repeated words, indefinite article errors, and sentence spacing. These are mechanical issues that are straightforward to fix and satisfying to clear. Work through them chapter by chapter, and do not skip the repeated-words check. Nothing undermines polished prose like a character who nods four times on a single page.

After grammar, move to the style layer. This is where revision becomes craft. The eight style categories, including show-dont-tell, cliche detection, purple prose, filter words, adverb overuse, dialogue tags, sentence variety, and head-hopping, address the patterns that separate competent prose from compelling prose. These flags require more judgment than grammar fixes. Not every adverb is a problem, and not every instance of telling needs to become showing. Use the suggestions as prompts for reconsideration, not commands.

Handle grammar before style. Fixing a passive-voice sentence may also resolve a filter-word flag in the same passage, saving you duplicate work.

Phase 4: Final Review

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

Re-check the Tension Plot to verify that your structural changes produced the dramatic arc you intended. Look at the Pacing dashboard to confirm your scene-pace distribution still matches genre expectations. If you added or removed scenes, your chapter balance may have shifted, so scan the Manuscript Health dashboard for new outliers.

Run the Continuity dashboard one more time. 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. The chronology view shows whether your timeline still holds together after all the changes you have made.

Compare your current Tension Plot shape to the genre benchmark shape in your settings.
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 the Key Findings view 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 passes, not random fixes. Each phase of this workflow is designed as a complete pass through the manuscript with a single lens. Finish one pass 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 Phase 3.

Trust the severity ordering. Bookshaper's three severity levels, critical, warning, and info, are calibrated to help you focus energy where it matters most. A manuscript with zero critical issues and twenty informational notes is in strong shape. A manuscript with five critical issues is not ready for line editing, no matter how clean the prose.

Take breaks between phases. Revision demands a different kind of attention than drafting, and fatigue causes you to start accepting mediocre fixes. Step away between phases, 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 issues will improve your manuscript more than an unfocused eight-hour session that touches everything.

← All guides Documentation FAQ