← All guides

Guide for agents. Over MCP: help with topic voice.

Writing in the author's voice

Before any prose work, call voice_brief (optionally with mode: capture, plan, draft, review). It returns told: the point of view and tense the author chose for the book, with what the style allows (in third person, objective, never enter anyone's thoughts; in omniscient, you may enter anyone's). Keep to it; a chapter or scene may differ, and scene_context gives what applies to each scene. Then, in order of authority:

  1. samples: passages the author chose. Imitate these first: rhythm, distance, vocabulary.
  2. measured: facts counted from their scenes (tense, person, sentence length, dialogue share, punctuation habits). Where the author chose a tense or style in told, that wins over what is measured.
  3. book_rules, then author_rules: plain instructions. Follow them even where your own taste differs.
  4. guides: how-tos for this book's genres; fetch one with help.

Characters speak as themselves. A character's voice field comes with scene_context and page_get. Dialogue follows it. If a main character has none and you have seen enough of them, suggest one to the author; set it with page_update only when they agree.

Drafting a scene. scene_context for the scene is its brief: its plan, the cast (with their voices) and where each was last seen (set_in is where that scene happens; names_places are only named there), relationships true at that point in the story, how the previous scene ends, what the next one is for, the plot threads it carries, earlier events, the author's rules, and open flags and comments. Draft from that, not from memory; pick up where the previous scene leaves off, and lead into the next. Read the scene's plan first: it should say what happens and what the scene is for. If it does not say what the scene is for, ask the author before drafting (help topic plotting).

One scene is one piece of text. A scene's text never contains a rule (---, ***, ___) or a #/## heading: in MechaSquid those are scene and chapter boundaries, and Write mode would cut the text there. For a break inside a scene (a jump in time, a change of place within the same scene), write a line with ⁂. If the draft really is two scenes, save it as one and scene_split it, or page_create the second with chapter and position. Tools refuse scene text with a boundary in it and say which line.

Learning from a no. When the brief says there is feedback to learn from, call voice_feedback: what they rejected, what they rewrote after accepting, and why. If several decisions point the same way, voice_propose_rule: one short, concrete line ("Do not end a scene on a reflective line."), scope book or author, a note saying what you saw, and the revision_ids. It is only a suggestion until they accept it on the Voice page. Do not propose what existing already covers, including what they dismissed.

Writing in the author's voice · MechaSquid docs