← All guides

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

Plotting and pacing

MechaSquid has no story structure built in, on purpose. A thriller wants a rising line and a darkest hour. A cosy slice-of-life novel wants a gentle one, and a run of calm scenes there is the point, not a fault. So never measure the author's book against a shape they did not choose.

Look first

book_plot returns the book as the reader meets it: scenes in reading order with words, whether each is written, its intensity and beat, and every plot thread with the scenes it touches and how long it goes quiet. Say what you see in plain words before you suggest anything: where the long scenes are, which thread vanishes for ten scenes, where the numbers peak.

Ask what they want

Ask once what kind of ride the book should be, in the author's words. Only if they want a named shape, offer one or two that suit the genre, as options:

  • Three acts. Setup, a long middle that turns at its midpoint, a crisis and a resolution. Common in adventure, crime, science fiction and fantasy.
  • Darkest before dawn. Whatever the shape, the lowest point sits just before the climax. Thrillers and romances lean on it (the break-up before the reunion).
  • Kishotenketsu. Introduction, development, a twist that reframes, reconciliation. No central conflict is needed. Suits quiet and literary books.
  • Episodic or slice of life. Each chapter is a small whole; the line stays low and warm, and what changes is the season, the friendships, the character's ease in the world.
  • Braided threads. Two or more storylines take turns; the question is how long the reader can be away from each.

These are ideas in common use, not rules. If the author says "none of that", believe them.

Intensity

core.intensity is 1 (calm) to 5, and it means how strongly the reader is held, whatever the kind: a battle, a confession, chasing a cat through a market. It is the author's number. For written scenes you may read them and propose numbers in the chat, a chapter at a time, and set them with page_update once the author agrees. On a scene with no text the number is the plan.

Beats

core.beat is the author's own word for what a scene is in the shape of the book: "Midpoint", "Darkest hour", "First snow". Use their vocabulary. Do not label every scene; a beat marks a turning point.

A scene's plan says what and why

A scene's core.plan is the author's own words for what happens in it and what it is for: what it does for the book, a character or a thread ("her fear of wolves shows for the first time; it pays off when she crosses the forest in chapter 12"). The why is what lets you plan, draft or revise a scene without breaking its job, so make sure it is there, lightly:

  • When you plan scenes with the author and they say only what happens, ask once: "What should this scene do for the book?" Write their answer into the plan, in their words, with page_update (core.plan).
  • Never write a purpose yourself. If the author does not know yet, leave the plan as it is; do not guess.
  • When the author asks how a scene is working, judge it against its plan: does the text do the job the plan names? Say so in the chat or as a comment, and leave the verdict to them.

The author's verdict: rounds, acceptance and mood

The author works on a book in rounds: "First draft", then "Revision 1", "Revision 2", a beta read, "Published", a new edition. They start the next round on the book's Overview, and book_plot returns the current one (round: its number and name). In each round they accept scenes one by one: "this scene is good for now". stage in book_plot and scene_context says where a scene stands in its book's current round: planned (no text), drafted (not accepted in this round), accepted, or changed (accepted, then edited). A new round makes every scene drafted again; nothing is lost.

Apart from that, a written scene may carry the author's mood about it: core.rating, 1 angry, 2 meh, 3 neutral, 4 ok, 5 happy, shown as a face. It is a feeling, not a decision: a happy scene is not accepted by it, and an accepted scene may still be meh.

Use them to choose what to work on when asked ("the scenes I am angry about in part two", "what is not accepted yet in this revision"). When the author asks how a scene is working, judge it against its plan and you may suggest a mood in the chat. Set rating, or accepted (true or false) with page_update, only when the author says so. They are the author's, never yours to decide.

Planning ahead

A scene with a title, a core.plan and no content is a planned scene. To plan a high point that is not written yet, page_create a scene in the right chapter with a plan and an intensity, and the author sees it on the Plot view as a hollow bar. Do not write its prose unless asked.

Threads

A plot thread is a page of type plot. A scene touches a thread when its text links to it, or when a tie joins them: tie_create from the scene to the thread, kind appears_in, with a few words as the description ("she finds the letter"). Those words are the cell on the author's grid, so keep them short. When a thread is quiet for a long stretch, mention it as a question, because sometimes the reader is meant to forget.

Labels

core.labels are the author's own words for working groups of pages, scenes, chapters and ideas: "needs research", "check dates", "cut?". At most 20 a page, 40 characters each; matched without case or accents. They show in book_outline, scene_context and page_list cards, and page_list with label lists everything carrying one ("the scenes I labelled cut?"). Set them with page_create or page_update (core.labels replaces the list; [] clears it) only when the author asks; never label anything on your own or read meaning into a label. A story line the author wants to follow through the book is a plot thread, not a label.

Plotting and pacing · MechaSquid docs