/reader-panel

Reader Panel

Overview

Run structured persona reads of a chapter range and write each one as a feedback file in the shape feedback-triage already reads, so the existing triage flow takes over unchanged. The panel is a first read before human readers see the draft: it finds the problems a reader would trip on, so the human round spends its attention on what only people can tell you.

Every panel read is simulated. It is written by the agent, marked source: simulated, and never presented as feedback from a real reader.

Prerequisites

A story project (story.md in the root) with the chapters in range drafted. The feedback-triage skill must be available for the synthesis.

When to Use

• Before the first beta round, to catch the obvious problems cheaply
• After a revision, to check a fix landed before sending it to people
• When the user has no readers yet and wants a structured first read
• NOT as a substitute for human readers. A simulated round cannot close a book as ready for submission or publication
• NOT for a sensitivity or authenticity read. The sensitivity persona only flags passages for a paid human reader (use editorial-review)

Personas

Each persona has a reference file listing what it reads for, what it never comments on, and how it rates severity. Load only the personas in the panel.

Workflow

1. Scope the panel

1. Ask the user for the chapter range (default: every drafted chapter) and which personas to run (default: all five). Take genre, form, POV, and tense from the story context output in step 2 (its Story essentials section), not from story.md, whose Synopsis may describe the ending. The genre reader needs the genre.

2. Pick the round number: the next free N under feedback/. A panel gets its own round. Never add simulated reads to a round of human readers, so the human synthesis stays independent.

3. Build the review copy the panel cites, so its labels match the ones human readers will use:

   story build . --format html --stamp panel-round-{N}

   The build holds the whole book, so use it for labels only: a persona reads the chapter files in range, never the review copy. Cite each note with its paragraph label (ch03-p12) and the paragraph's first few words, exactly as the feedback template asks of human readers.

2. Gather context without spoilers

A persona reads the book as a reader would: only the chapters in range, in order. For background (who the characters are, what the story has promised so far), run story context on the last chapter in range:

story context chapter-{NN} --path . --budget 4000

It includes nothing from later chapters and leaves out the synopsis. Do not read story.md, plot/, arc files, promise payoffs, or chapters after the range: a persona that knows the ending cannot tell whether the setup works. When the genre reader needs the genre's promises, take them from the chapters and the genre, not from the outline.

3. Run each read independently

1. Run one persona at a time. If you can start subagents, give each persona its own subagent with only its reference file, the chapters in range, and the story context output, so no persona reads another's notes. Otherwise finish and save one persona's file before starting the next, and do not revise earlier files after reading later ones.
2. Follow the persona's reference file. Read the whole range before writing any note.
3. Every problem cites evidence: the paragraph label, the quoted first words, and the words that cause the problem. A note with no location in the text is not a note; drop it.
4. Report what the persona finds, not a quota. A persona that finds nothing writes that in Overall Impression and leaves Problems empty. Never pad a read to look thorough, and never invent a problem another persona or a craft checklist would expect.
5. Mark uncertainty. When a note depends on something the persona cannot see (a later payoff, the author's intent), say so in the note instead of asserting it.

4. Write the files

Write each read to feedback/round-{N}/{persona}.md using ../feedback-triage/references/feedback-template.md, with these frontmatter values:

---
reader: "{Persona name} (simulated)"
round: {N}
chapters-read: "{range}"
overall-verdict: "{loved it | liked it with reservations | mixed | didn't connect}"
source: simulated
persona: {file id from the table}
---

Leave each note's Canon check line as not checked (simulated read): checking against the bible means reading past the range, so feedback-triage does it at synthesis. Severity uses the template's scale (blocking, major, minor, nit), rated by the persona's reference file; some personas use only part of it (the sensitivity persona never rates a note blocking, and the first-page reader has no nit).

5. Hand off to feedback-triage

Hand the round to the feedback-triage skill for synthesis. It reads source: simulated and weighs the round accordingly: agreement between personas is not independent convergence, and a simulated round's ready verdict means ready for human readers, nothing more. Tell the user plainly that the notes are simulated, and which personas ran.

Conventions

• Panel files live under feedback/round-{N}/, one per persona, named by the persona's file id: feedback/round-2/line-editor.md.
• Every panel file carries source: simulated and persona. A file without them is a human reader's file.
• A panel round holds only simulated reads. Human and simulated reads are never mixed in one round.
• Never describe a simulated read as a reader's, a beta reader's, or a sensitivity reader's feedback, in chat, in commit messages, in the synthesis, or in anything the user might send on.
• Do not revise the manuscript during the panel. The revision plan comes from the synthesis, as for a human round.

CLI Maintenance

Use the Story CLI when it is available. If story is not installed, use bun run story -- from the Story Skills repository checkout or the bundled fallback node ../story-maintenance/scripts/story.js with the same arguments, resolving the path relative to this skill folder. If no CLI is available, read the chapters in range directly and cite chapter and paragraph positions by hand.

The CLI does not read feedback/, so panel files never cause validation errors. Run story build . --format html --stamp panel-round-{N} for the labels and story context chapter-{NN} --path . for spoiler-safe background. When the synthesis adds or resolves continuity/questions/ entries, run:

story reindex .
story links .
story validate .

Reference Files

• references/genre-reader.md - The target-genre reader: the genre's promises, pacing, and conventions, and how to rate a missed beat
• references/line-editor.md - The line editor: POV slips, filter words, repetition, antecedents, and voice drift at the sentence level
• references/sensitivity-reader.md - The sensitivity persona: flags portrayals for a paid human reader, never clears one
• references/continuity-reader.md - The continuity-minded reader: facts, names, objects, timeline, and character knowledge within the range
• references/first-page-reader.md - The first-page reader: whether they would keep reading, and where they would stop