Readers report symptoms, not causes. They say that a book drags in the middle, that they could not tell the sisters apart, that the twist was obvious or the ending a cheat, and they are usually right about what they felt and often wrong about where it came from. This index starts from the report. Each row gives a symptom as a reader or a writer might put it, the failure pattern that most often produces it, the diagnostic test that finds the pattern in a draft, and the place to look first before repairing it. The patterns and tests are those of the eighteen chapters, each linked to the chapter’s Failure Patterns and Diagnostic Tests parts, where the mechanism, the remedy and a published exception are given.
The index is arranged by where a symptom is felt, using the five rungs of the revision ladder set out in The Structural Edit (Chapter 18): the promise (what kind of book this is and what question it asks), allocation and arrangement (whose book it is, how many stories it tells, in what order of time), the shape (the middle, the arc, the reveals, the ending), the joins (transitions, chapter breaks, cutaways, the opening pages) and the scene and its materials (scenes, sequels, dialogue, detail). It begins at the bottom, with the scene, because that is where most reports are made. A last section lists the symptoms of a revision that is going wrong.
The column Look first applies The Structural Edit’s rung-up rule (Chapter 18): a symptom felt on one rung is often caused on a higher one, so before repairing a scene, check whether the decision above it is settled. The entry is a first guess, not a verdict. Where it says Local, the cause usually lies on the rung where the symptom is felt, and the instrument named is the one to use. A report that fits no row closely can be matched by its rung: find the rung where it was felt, and read that section’s rows for the nearest pattern.
Felt in a scene
These are the reports a reader makes about a single scene, exchange or passage of description: that nothing happens, that the talk is flat, that the description tells her nothing. The table draws on The Purposes of a Scene (Chapter 1), Scene and Sequel (Chapter 2), The Dialogue Exchange (Chapter 3) and The Descriptive Detail (Chapter 4).
| Report | Failure pattern | Test | Look first |
|---|---|---|---|
| Pleasant, well observed, and nothing happens | The purposeless scene | Value shift, test 3 | Rung 3: does the shape need the scene? |
| Another quarrel on the same terms; “we knew that already” | The redundant scene | Redundancy, test 6 | Rung 3: the value-shift log of the middle (The Middle, Chapter 11) |
| Characters ask what they would already know, and one explains fluently | The expository scene in disguise | Pressure, test 9 | Rung 3: when the reader needs the fact (The Reveal, Chapter 15) |
| The drive, the queue, the waiting room; the business comes at the end | The errand scene | Entry and exit, test 8 | Rung 4: the transition (The Transition, Chapter 5) |
| She wants it and gets it, at no cost | The unresisted want | Resistance, test 2 | Rung 3: the option list (The Middle, Chapter 11) |
| The scene ends in unmixed success | The clean win | Disaster, test 3 | Rung 3: the option list (The Middle, Chapter 11) |
| Disaster, a break, a new goal, and nothing between | The skipped sequel | Descent, test 2 | Rung 4: the chapter ending (The Chapter Break, Chapter 6) |
| A choice whose right answer is obvious | The false dilemma | Dilemma, test 7 | Rung 3: the criterion log (Arc and Theme, Chapter 12) |
| Reaction and weighing, then a change of subject | The sequel without a decision | Reversibility, test 9 | Rung 4: the chapter ending (The Chapter Break, Chapter 6) |
| Every scene ends worse, and the stakes stop mattering | The escalation treadmill | Criterion, test 8 | Rung 3: the criterion log (Arc and Theme, Chapter 12) and the middle (The Middle, Chapter 11) |
| Characters tell each other what both know | As you know, Bob | Cost, test 4 | Rung 3: when the reader needs the fact (The Reveal, Chapter 15) |
| “They all sound the same”, or all sound like the author | The ventriloquist exchange | Transcript, test 7 | Rung 2: the grant (The Viewpoint Shift, Chapter 13) |
| Everyone says what they mean, or explains their own psychology | On the nose | Implicature, test 6 | Rung 3: is the change dramatised or announced? (Arc and Theme, Chapter 12) |
| Quick, clever lines, forgotten a page later | The tennis match | Want, test 2 | Rung 3: does the shape need the exchange? |
| Respelled dialect that readers find hard going | Phonetic dialect | Transcript, test 7 | Local: the line edit |
| A list of accurate furniture | The inventory passage | Inventory, test 10 | Rung 2: whose attention selects (The Viewpoint Shift, Chapter 13) |
| The same charged detail, in the same words, scene after scene | The static motif | Recurrence, test 7 | Rung 3: what the motif should measure (Arc and Theme, Chapter 12) |
| A detail no one present could have noticed | The unfocalised detail | Focalisation, test 5 | Rung 2: the grant (The Viewpoint Shift, Chapter 13) |
| The broken clock at the right emotional moment | The symbol announcing itself | Denotation and connotation, test 2 | Rung 1: is the theme a question or a statement? (Arc and Theme, Chapter 12) |
| Everything is seen; no smell, touch or temperature | The sense monoculture | Modifiers and senses, test 9 | Local: the line edit |
Most of these symptoms point upward. A scene in which nothing changes is often a scene the shape does not need, and characters who all sound alike often signal that the book has granted more minds than it can distinguish, so the higher rung should be checked before the scene is rewritten.
Felt at a join
These are the reports a reader makes about the movement between units: that she was lost after a break, that the book is relentless or slow when no scene is at fault, that she skimmed the flashbacks or put the book down in its first chapter. The table draws on The Transition (Chapter 5), The Chapter Break (Chapter 6), Backstory and Flashback (Chapter 7) and The Opening Pages (Chapter 9).
| Report | Failure pattern | Test | Look first |
|---|---|---|---|
| “Lost after the breaks” | The orphaned cut | Anchor, test 1 | Rung 2: the arrangement (Non-linear and Multi-timeline Architecture, Chapter 8) |
| A paragraph of approach before every scene | The throat-clearing bridge | Momentum, test 5 | Local: the count of change (The Transition, Chapter 5) |
| Every gap crossed with Three days later | The metronome | Consistency, test 10 | Local: the six techniques (The Transition, Chapter 5) |
| The transition retells what the reader knows | The recap bridge | Redundancy, test 7 | Rung 2: how long the thread was dormant (The Subplot, Chapter 14) |
| A skipped stretch turns out to have held the important event | The false ellipsis | Gap content, test 6 | Rung 3: when the reader needs the fact (The Reveal, Chapter 15) |
| “Relentless”: every chapter ends in danger | Cliffhanger fatigue | Variety, test 7 | Rung 3: the proportion of the shape |
| The chapter goes on past its own ending | The padded chapter | Proportion, test 6 | Rung 3: the proportion of the shape |
| The turn arrives mid-chapter, and the chapter goes on | The buried pivot | Placement, test 5 | Rung 3: where the reveal falls (The Reveal, Chapter 15) |
| A danger the next paragraph dispels | The false cliffhanger | Payoff, test 2 | Local: what the chapter proposes (The Chapter Break, Chapter 6) |
| Chapters end with the character falling asleep | The sleep ending | Permission, test 3 | Local: the ending types (The Chapter Break, Chapter 6) |
| The flashback interrupts the tensest moment | The momentum killer | Momentum, test 1 | Rung 2: the arrangement (Non-linear and Multi-timeline Architecture, Chapter 8) |
| Pages of history read as a report | The info-dump backstory | Register, test 2 | Rung 2: cutaway or strand? (Non-linear and Multi-timeline Architecture, Chapter 8) |
| A long visit to the past before the end of chapter two | The second-chapter flashback | Placement, test 8 | Rung 2: the arrangement (Non-linear and Multi-timeline Architecture, Chapter 8); rung 1: the contracts (The Opening Pages, Chapter 9) |
| The present resumes as if nothing had happened | The untethered return | Return, test 5 | Local: the trigger and the return (Backstory and Flashback, Chapter 7) |
| One childhood scene explains the adult | The childhood-explains-everything cutaway | Removal, test 3 | Rung 3: the arc (Arc and Theme, Chapter 12) |
| The book opens with someone waking up | The waking-up opening | Momentum, test 3 | Rung 1: what the opening promises |
| History and world before any character | The info-dump opening | Zero context, test 5 | Rung 2: the arrangement, or a prologue (Non-linear and Multi-timeline Architecture, Chapter 8; The Prologue, Chapter 10) |
| The gripping start the book never returns to | The borrowed hook | Promise, test 6 | Rung 1: the promise inventory (Series and Genre, Chapter 17) |
| The narration coyly withholds what the character knows | The withholding tease | Contract, test 1 | Rung 3: who withholds, and why (The Reveal, Chapter 15) |
| “It starts on page four” | Throat-clearing | Abandonment, test 10 | Local: the scene test (The Opening Pages, Chapter 9) |
A join is the place where a reader notices the arrangement, so its failures are often failures of rung 2 seen from the page: a flashback skimmed may be a strand that has no question, and a reader lost after a break may be a reader who was never told the book has two times.
Felt in the shape of the whole
These are the classic reports on a full draft: the middle drags, the protagonist does not change, the twist was guessed or felt like a cheat, the ending fell flat or was too tidy. The table draws on The Middle (Chapter 11), Arc and Theme (Chapter 12), The Reveal (Chapter 15) and The Ending (Chapter 16).
| Report | Failure pattern | Test | Look first |
|---|---|---|---|
| “Nothing happens in the middle”, though much does | The plateau | Value-shift log, test 1 | Rung 1: is the want urgent? |
| The middle’s sequences could change places | The episodic middle | Reorder, test 3 | Rung 1: the book’s question |
| The opposition vanishes while the protagonist prepares | The absent opposition | Opposition, test 5 | Rung 2: the threads (The Subplot, Chapter 14) |
| The middle waits for an event scheduled at its end | The holding pattern | Option list, test 2 | Rung 1: is the want urgent? |
| The second half reads as a different book | The broken back | Midpoint, test 4 | Rung 1: the promise (Series and Genre, Chapter 17) |
| “She doesn’t change”, or “I was told she had changed” | The announced arc | Hinge, test 2 | Rung 1: the governing question (Arc and Theme, Chapter 12) |
| The change comes when the old rule has nothing left to defend | The free hinge | Price, test 3 | Local: the criterion log (Arc and Theme, Chapter 12) |
| Readers predict the change from the first chapters | The scheduled arc | Seed, test 4 | Rung 1: the governing question (Arc and Theme, Chapter 12) |
| After the change, she chooses by the old rule again | The revoked arc | Enactment, test 6 | Rung 1: does the change answer the question? |
| “Lectured” | The sermon | Answers, test 8 | Rung 1: the answer map (Arc and Theme, Chapter 12) |
| “Felt cheated” by the twist | The cheat | Teller, test 2 | Rung 2: who tells the book (The Viewpoint Shift, Chapter 13) |
| “Guessed the twist” | The giveaway | Double reading, test 1 | Rung 2: the grant (The Viewpoint Shift, Chapter 13) |
| The largest truth arrives in a line of dialogue | The reported reveal | Recognition, test 7 | Local: the disclosure map (The Reveal, Chapter 15) |
| The twist surprises, and nobody cares | The idle reveal | Consequence, test 6 | Rung 1: the book’s question |
| “Convenient”: a letter, a stranger, a coincidence | The reveal from outside | Source, test 8 | Rung 2: the cast and the threads (The Subplot, Chapter 14) |
| “Unearned”: the rescue comes from nowhere | The unearned rescue | Earned, test 3 | Local: the plant audit (The Ending, Chapter 16) |
| Someone sums up what it all meant | The explained ending | Domain, test 5 | Rung 1: the theme as a question (Arc and Theme, Chapter 12) |
| Every thread tied off with equal care | The tidy-everything ending | Proportion, test 6 | Rung 1: what the book declines (Series and Genre, Chapter 17) |
| A death solves the problem | Death as resolution | Earned, test 3 | Rung 3: the arc (Arc and Theme, Chapter 12) |
| The open ending reads as evasion | Ambiguity used as evasion | Domain, test 5 | Rung 1: the declared decline (Series and Genre, Chapter 17) |
The shape depends sideways on itself, so a symptom here can lie in a neighbouring decision on the same rung: an ending that falls flat is often a middle that did not narrow, and a twist that is shrugged at is often a reveal that answers a question the book never made urgent. The Structural Edit (Chapter 18) orders the checks on this rung as middle, arc, reveal and ending.
Felt in the arrangement
These are the reports about whose book it is and how it is laid out: that the viewpoints were indistinct, that one timeline was skimmed, that the subplot was the better story, that the prologue promised another book. The table draws on Non-linear and Multi-timeline Architecture (Chapter 8), The Prologue (Chapter 10), The Viewpoint Shift (Chapter 13) and The Subplot (Chapter 14).
| Report | Failure pattern | Test | Look first |
|---|---|---|---|
| Hard to follow, yet easy to retell in order | The arbitrary arrangement | Necessity, test 1 | Rung 1: what the order is for |
| “I didn’t know when I was” | The lost reader | Orientation, test 3 | Local: the orientation marker (Non-linear and Multi-timeline Architecture, Chapter 8) |
| “Skimmed the past timeline” | The explaining strand | Strand question, test 2 | Rung 1: does the strand serve the question? |
| Two good timelines, and the book is monotonous | The lockstep braid | Rate, test 5 | Local: the strand table (Non-linear and Multi-timeline Architecture, Chapter 8) |
| The timelines meet by a birthmark or a shared house | The convergence by coincidence | Convergence, test 7 | Rung 1: the book’s question |
| The prologue could be headed Chapter One | Chapter One in disguise | Label, test 3 | Local: the double test (The Prologue, Chapter 10) |
| The prologue promises a different book | False advertising | Genre contract, test 9 | Rung 1: the promise inventory (Series and Genre, Chapter 17) |
| An unnamed victim dies, and the detective’s book begins | The anonymous-victim cold open | Higher bar, test 1 | Rung 1: the promise inventory (Series and Genre, Chapter 17) |
| The prologue gives the ending away | The prologue that spoils | Higher bar, test 1 | Rung 3: the disclosure map (The Reveal, Chapter 15) |
| The prologue’s gap is never closed | The unresolved distance | Closing, test 6 | Local: closing the distance (The Prologue, Chapter 10) |
| Minds change inside a scene | Head-hopping | Scene integrity, test 9 | Local: the declaration (The Viewpoint Shift, Chapter 13) |
| A viewpoint that exists to fetch information | The information mule | Necessity, test 1 | Rung 3: the disclosure map (The Reveal, Chapter 15) |
| “Hard to get into”; too many viewpoints | The diluted ensemble | Page-share, test 5 | Rung 1: whose question the book asks |
| A new viewpoint at two-thirds, and readers skim it | The unearned late arrival | Late grant, test 7 | Rung 3: the shape |
| The villain’s chapter tells the reader the answer | The antagonist chapter that spoils its own suspense | Necessity, test 1 | Rung 3: the disclosure map (The Reveal, Chapter 15) |
| One thread is read impatiently | Parallel play | Convergence, test 5 | Rung 1: the book’s question |
| “Preferred the subplot” | The main-plot hijack | Promotion, test 10 | Rung 1: which question is the book’s? (Arc and Theme, Chapter 12) |
| A thread from nowhere decides the climax | The late-arriving thread | Dormancy, test 8 | Local: the thread’s appearances (The Subplot, Chapter 14) |
| The threads converge because the characters meet | Convergence by encounter | Convergence, test 5 | Local: the convergence test (The Subplot, Chapter 14) |
| A love story beside a plot it never touches | The romance bolted on | Analogy, test 4 | Rung 1: the governing question (Arc and Theme, Chapter 12) |
Arrangement is decided once for the whole book, so a repair here moves whole stretches of text and reopens the joins and scenes inside them. That is the reason to check the promise first: an arrangement can be faultless and still serve a question the book is not asking.
Felt in the promise
These are the reports that a book was not what it promised, or that a series did not keep faith with its volumes. They are made late, often at the ending, and they are the hardest to place, because the reader feels them at the last page and their cause lies before the first. The table draws on Series and Genre (Chapter 17).
| Report | Failure pattern | Test | Look first |
|---|---|---|---|
| Liked it until the end, then felt cheated | The undeclared decline | Declared decline, test 3 | Decide on this rung |
| Readers of the genre call it slow or evasive | The genre in costume | Core promise, test 2 | Decide on this rung |
| “Nothing was resolved; I have to buy the next one” | The volume that owes its question | Volume question, test 5 | Decide on this rung |
| The series’ long-awaited answer is too small | The deferred answer | Series step, test 6 | Decide on this rung |
| Returning readers skim the opening; new ones are lost | The recap at the door | Re-entry, test 7 | Rung 4: the opening as written (The Opening Pages, Chapter 9) |
The promise is the top rung, so a symptom here is decided rather than diagnosed. The writer chooses what the book is and what it declines, and then declares the choice early enough for a reader to stake on it. The one exception in the table is the recap at the door, whose decision is made at the top and whose repair is made in the opening pages of the later volume.
Symptoms of the revision itself
These are the reports a writer makes about her own revision: that each pass makes the book longer, or produces new contradictions, or answers the same note again. They are failures of the order of the edit, not of the book, and they are treated in The Structural Edit (Chapter 18).
| Report | Failure pattern | Test | Look first |
|---|---|---|---|
| The opening is the most revised part, and the least like the book | The page-order edit | Opening last, test 6 | Rung 1, then down the ladder |
| Cuts resisted; the best prose is in scenes that change nothing | Premature polish | Map, test 1 | The book map (The Structural Edit, Chapter 18) |
| The same note on every draft, in new words | The local repair | Rung-up, test 3 | The rung above the symptom |
| Each revision makes new contradictions | The cascade | Reopen, test 4 | The reopened tests (The Structural Edit, Chapter 18) |
| Each draft longer, slower and more explained | The edit by addition | Economy, test 5 | The economy of the repair (The Structural Edit, Chapter 18) |
A writer who recognises one of these should stop revising scenes and build the book map, since every one of them comes from making repairs in an order the book’s decisions do not support.
The Craft Behind the Story — Appendix B, Symptom Index. Introduction · Glossary