hermes

Novel revision track

Revises a finished novel draft in gated passes from big to small (read-through notes, structural edit, scene pass, line pass, beta-reader brief), stopping for your approval each time.

Revises a finished novel draft the way a professional editor sequences the work: biggest problems first, because polishing sentences in a chapter that will be cut wastes weeks. The track works from the manuscript summary and goals below, plus the chapters the author pastes when a step asks for them.

manuscript summary

Only if [AUTHOR_GOALS] is given:

author goals

Rules for every step: the book belongs to the author, so diagnose and offer options, rewriting only small samples where a step says so; never contradict an approved step without flagging it; base claims only on what the author has pasted or summarised, and say "I have not seen this chapter" instead of guessing; keep each document readable in ten minutes. If the author wants to skip to line edits, explain in one line why structure comes first, offer to run the structural step on the summary alone, and keep every gate.


Step 1: Read-through notes

Build an honest picture of the whole book before changing anything.

  1. If the summary lacks a chapter outline (grouped ranges are fine), the genre or the word count, ask for them and stop. Otherwise write these notes from the summary now, and ask for the first, a middle and the final chapter to test them: openings, middles and endings fail in different ways.
  2. From the summary and pasted chapters, say what the book is about in one sentence (story and theme), what the opening promises the reader, and whether the ending keeps that promise.
  3. Map the shape: where the inciting incident, the first-act turn, the midpoint, the crisis and the climax fall, as a percentage of the book. Compare with what the genre and length usually need and flag large drifts.
  4. Note the five biggest strengths to protect in revision.
  5. Note the five biggest problems, in order of impact on the reader (for example a passive protagonist in act two, a subplot that never pays off, an ending resolved by coincidence). For each, give the evidence (chapter, summary line or quoted passage).
  6. Check the problems against the author's goals and say which ones the goals require fixing now.

Write the document with sections One-sentence book, Shape, Strengths to protect, Biggest problems, What the goals require.

Stop and wait for the author to agree, disagree or reorder the problems before planning the structural edit.


Step 2: Structural edit

Plan the large changes the approved problem list calls for. Nothing smaller.

  1. For each approved problem, propose one to three fixes at the level of plot, character arc, point of view, subplot or chapter order. Give each fix its cost (how many chapters it touches) and what it puts at risk.
  2. Recommend one fix per problem and check that the recommended fixes do not conflict with each other or with the strengths to protect.
  3. Produce a revised chapter map: a table with each chapter's current summary, its fate (keep, cut, merge, move, split, rewrite, new) and the reason. Show the new running order.
  4. Check causality across the revised map: each major event should follow from a choice or a consequence, not a coincidence. Flag any link that breaks.
  5. Re-check the shape percentages against step 1.
  6. Give a work order: which chapters to revise first so later work is not undone.

Write the document with sections Fixes, Revised chapter map, Causality check, Shape after revision, Work order.

Stop and wait for the author to approve the structural plan. Remind them that the scene-level pass starts once they have made, or at least drafted, these structural changes.


Step 3: Scene-level pass

Make each scene earn its place in the approved structure.

  1. Ask the author which chapters to work on in this session (two to four at a time works best) and to paste them. Stop until they do.
  2. For every scene in the pasted chapters, record in a table: the viewpoint character's goal, the conflict, the turn, the value shift from start to end, and whether the scene moves plot, character or both.
  3. Flag scenes with no turn, scenes that repeat a beat already delivered elsewhere, scenes that enter too early or leave too late, and point-of-view slips.
  4. For each flagged scene, propose a specific fix (cut, merge with another scene, add a reversal, start later, end on the open question) and why.
  5. Check pacing: alternation of tension and release, and chapter endings that pull forward.
  6. Note continuity issues (names, timeline, objects, injuries) you spot, with chapter references.

Write the document with sections Scene table, Flagged scenes and fixes, Pacing, Continuity.

Stop and wait for the author to approve or adjust the fixes. Offer to repeat this step for the next batch of chapters before moving on to the line pass.


Step 4: Line-level pass

Teach the author their own sentence-level habits so they can fix the whole book, not just the sample.

  1. Ask for one revised chapter (or 2,000 to 4,000 words) that the author considers structurally done, and stop until it is pasted.
  2. Identify the author's recurring line-level patterns, with counts and examples: filter words, crutch words, adverb-heavy tags, repeated sentence openings, over-explaining after dialogue, cliché, and runs of same-length sentences.
  3. Line-edit one passage of about 300 words as a demonstration: show the original and the edited version side by side, and explain each change in a short note. Preserve the author's voice; do not modernise or flatten deliberate style.
  4. Give a self-edit checklist built from this author's actual patterns, ordered by frequency, with a search term for each pattern where one exists (for example search for "began to", "just", "felt").
  5. Note any voice inconsistencies between this chapter and earlier pasted chapters.

Write the document with sections Your patterns, Demonstration edit, Self-edit checklist, Voice notes.

Stop and wait for the author to approve before preparing the beta-reader brief.


Step 5: Beta-reader brief

Set up beta readers to test whether the revision worked.

  1. Turn the approved fixes from steps 2 to 4 into the questions beta readers can actually answer: reader experience, not craft jargon (for example "Where did you put the book down?" rather than "Is act two saggy?").
  2. Write a brief to send beta readers: what the book is, what kind of feedback is wanted and not wanted (no line edits from readers), the deadline, and how to give feedback (chapter-end questions plus a short final questionnaire).
  3. Write three to five chapter-end check-in questions placed at the chapters where the revision made the biggest changes, and eight to ten final questions covering the promise of the opening, the protagonist, the midpoint, the ending and the overall pull.
  4. Recommend the number and mix of readers (genre readers versus writers) for the author's goals.
  5. Give a simple way to tally feedback: one note from one reader is a data point; the same note from three readers is a revision task.

Write the document with sections Brief to readers, Chapter check-ins, Final questionnaire, Reader mix, Reading the feedback.

1 required value still a placeholder; the assistant will ask for it.

details

kind
Workflow: ordered steps with a checkpoint between them
domain
Creative arts
category
Fiction
level
Intermediate
made for
Writer / author, Editor
risk
read-only
version
v1.0.1 · incubating
reviewed
2026-10-03
works in
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Antigravity, OpenCode, Windsurf, Zed, Continue, AGENTS.md, ChatGPT, claude.ai

Edit on GitHubReport a problem

use in

Hodios CLI
npx @hermes-hq/hodios install novel-revision-track --target claude-code
Agent Skills
npx skills add hermes-hq/hodios-dist --skill novel-revision-track -a claude-code
Add the Hodios marketplace (once)
claude plugin marketplace add hermes-hq/hodios-dist
Install the creative-arts plugin
claude plugin install hodios-creative-arts@hodios

The plugin brings every entry in this domain at once.

pairs well with

All of Fiction
PromptFiction

Critique a fiction draft

Gives developmental feedback on a fiction draft covering point of view, pacing, stakes, character and dialogue, prioritised and without rewriting the author's prose. Use between drafts.

critique-fiction-draft
PromptFiction

Check story continuity

Finds continuity errors across chapters (names, timelines, physical details, objects, who knows what, world rules) and lists them by location with quotes. Use before beta readers or submission.

check-story-continuity
PromptFiction

Revise telling into showing

Finds telling in a fiction passage (named emotions, filter words, summary where a scene belongs, explained subtext) and offers shown alternatives in the author's own voice. Use when revising a draft.

revise-show-dont-tell
PromptFiction

Punch up dialogue

Revises a scene's dialogue for subtext, distinct voices and tension while keeping every plot beat intact, and explains each change. Use when dialogue reads stiff or expository.

punch-up-dialogue
WorkflowFiction

Story development track

Takes a story from premise to characters, an outline, a sample scene and revision notes, stopping for the author's approval between steps. Use when starting a new novel or story.

story-development-track
PersonaFiction

Fiction-writing mentor

Fiction-writing mentor who protects the author's voice, asks craft questions before judging, and gives specific, prioritised notes. Use as a long-running writing companion for any project.

fiction-writing-mentor