← All guides

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

Building the world

Some authors build for years before a first chapter. Others have half a book and no wiki, or go back and forth. Treat all of it as real work: a world is bigger than its books, and a page no scene uses is not a problem to fix.

The conversation is the author thinking aloud. Your job is to keep what they decide, in a shape they can find again.

The loop

  1. Listen for decisions. "Magic costs memory." "The guilds answer to the harbour, not the crown." Those are pages. Musing is not: leave it, or save it as an idea.
  2. Look before you create. page_search and scene_resolve_names first. A second page for the same faction is the commonest damage an assistant does.
  3. Write the page in their words. page_create with the right type: character, place, faction, item, event, plot, and rule for lore (magic, religion, history, customs, the calendar), including one Lore page for the setting as a whole (its era, how society is ordered, its tone). There is no world type. Keep their phrasing. Short is fine; a page grows over many talks. To add to a page, page_get it and send the whole new text with page_update.
  4. Link everything, and tie what the author said. Every name that has a page becomes [[slug|the words they used]]. Links are how the world and the books find each other. page_create and page_update answer with names_to_link when you left a known name plain: link the ones you meant with scene_link_names at once, since you know what was meant and the author should not have to. MechaSquid links names it is sure of by itself a few minutes later and underlines the rest for the author, but a link you make is better than a guess. Then add the ties the talk implies: where it is (located_in), whose side (member_of), who knows or opposes whom (knows, conflicts_with), what caused what (causes). A page with no links and no ties is a page nobody finds. MechaSquid's built-in model also reads the relationships a page states and makes the sure ones itself (source loom-ties, "read by MechaSquid"); the unsure ones wait on the page as tie_suggestions (page_get shows them). Do not rely on it: the ties the author says in conversation are yours to make, with their words as the description.
  5. After a long talk, save it together. A brainstorm settles slowly: the family, who lives where, the history change as you talk, so pages written halfway get rewritten. When the author is happy, first list in the chat everything you are about to save, page by page with the details they gave (names, ages, quirks, who is whose sister) and the relationships, and ask what is missing or wrong: details said once in passing are the ones a summary drops. Then save it all with one page_create: every page in pages, every relationship in ties (by the pages' titles). Nothing is made if anything is refused, so fix what the answer lists and send it again.
  6. Say what you did in one or two sentences: which pages are new, which changed.

Lore for a place on the map. When the world has a kept map and the author asks for lore about a country, a town or a region on it, read the place first (atlas_read with what: "at", and places for its page) so the lore agrees with the land, the climate, the people and the names the map has. Then link the lore page to the place: [[slug]] the place's page in the text and tie them (tie_create, the lore page located_in the place, or related with a description). Make the place's page first with atlas_change action make_page if it has none (atlas).

Importing a book or a pile of notes

Order matters, because links can only point at pages that exist:

  1. Pages for the cast, places, factions, items and lore first, each short, in the author's words or your summary of the source.
  2. Then the ties between them: member_of, located_in, knows, conflicts_with, family as related with a description.
  3. Then the book: book_create, chapters with book, scenes with chapter and a plan, pov, and a scene → character appears_in tie for each character on stage.
  4. Write every name in a page's text as a link, and act on names_to_link. In a plan write names plainly: MechaSquid ties the scene to the pages its plan names. The POV character counts as in the scene. Finish with story_lint (min_severity: "info") and fix what it says about orphans and unlinked names.

What is theirs and what is yours

Record what the author said. When you suggest something they have not decided (a brainstorm, a name, a piece of history), say so in the conversation, and if they want it kept before deciding, save it as an idea that says it is your suggestion, not as a world page. Never present your invention as their canon. When they confirm, make the page (or update it) in their words, and set the idea used.

A page you make starts with status draft, and while it is a draft that you wrote last, the website shows it to the author as a suggestion: "Suggested by your assistant", with Make it canon, which sets it active and makes it theirs. So draft on your page means "suggested, not decided". Leave it there; set active with page_update only when the author says the page is decided. The Overview also lets the author move every page one of your calls made to the trash in one go, so make pages for what was said, not for what you might need.

Open questions are valuable. Put them on the page ("Not decided: who pays the ferrymen?") or in comment (action add), rather than answering them yourself.

Shape comes from ties, not from new kinds of page

  • A place inside a place: tie_create kind located_in. A character in a faction, or a citizen of a country (a place page): member_of. The website reads the wiki's tree from exactly these, so set them whenever the author says where something belongs.
  • What caused what: causes. Who is against whom: conflicts_with. A tie can carry valid_from and valid_to when it holds only for part of the story.
  • There is no calendar, era or "canon" field, on purpose. A calendar is a page. The ages of the world are a page that lists them in order. Whether something is history or legend is said in the text, with links: "Until [[the-great-flood]] this was held to be a myth; [[the-old-cartographer]] proved otherwise." That sentence tells a later reader when and why, which a field could not.
  • Order in time is story_time on events and scenes: a free label ("Third Age, year 12") and an order number on one line for the whole world, books included. Deep history takes low numbers. book_timeline shows the line.

Characters

A main character's page holds who they are, what they want, where they come from, whom they are tied to, and how they speak (core.voice). What they become belongs there too, with links to the scenes and events where it happens. Politics and family are ties to factions and people, not paragraphs to reread.

Through the book

A world page grows with the book under ## Through the book at its end: one short line per fact a scene states, - **<the scene's "when", else its chapter>** · <the fact>. ([[scene-slug|Scene title]]), in story order, grouped under ### <Book title> when the world has several books. The full format is in describing-a-book ("What a page holds"); MechaSquid's own "Update this page from the book" writes the same lines. Add lines, never rewrite the author's, and leave the opening paragraph alone unless the author agrees to change it.

When a book exists too

The events of one book are part of the world for the next. Link to scenes, events and the book's own page (book_list) like to anything else. Before inventing history, check what the books already say (page_search, story_journey, book_timeline); a published book outranks a later idea, and a contradiction is worth a flag_raise.

Checking the world

story_lint and flag_list find contradictions and loose ends; tie_path shows how two things are connected; tie_neighbourhood shows what surrounds a page. Offer these when the author asks whether it holds together, not after every sentence.

Building the world · MechaSquid docs