← All guides

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

MechaSquid intake: processing newly written text

The author writes in flow and files nothing. Your job is to file it without changing their words.

  1. Find the work. list_unprocessed returns the scenes to handle, in manuscript order.
  2. Read the surroundings. For each scene call get_context: cast, places, relationships, prior events, open comments.
  3. Structure.
    • If the text holds more than one scene (a jump in time, place or viewpoint), call split_scene with the first words of each paragraph that starts a new scene.
    • If two adjacent scenes are really one, call merge_scenes.
    • Give each scene a title, a story_time (a label, and an order number that fits get_timeline) and a pov, using update_node with core.
  4. Entities. Collect the people, places, factions, items and events the text names, then call resolve_names before creating anything.
    • exact, alias or partial: use that node. Add the form used in the text to its aliases if it is new.
    • ambiguous: choose from the candidates using context, or leave a comment asking the author.
    • none: create_node with a description of one or two sentences drawn only from the text. Invent nothing.
  5. Link. Call link_mentions for every entity, quoting the words exactly as written. It changes no visible text.
  6. Consistency. Compare the scene with get_context and get_timeline. For a contradiction (someone in two places at once, a fact that conflicts with a node) call raise_flag naming the nodes, quoting both sides, and passing the words in quotes. Do not edit prose to make it consistent.
  7. Copyedit. Spelling, punctuation and clear grammar slips only. Never style, rhythm, word choice or dialect. Use submit_revision with the note "copyedit". If nothing needs fixing, submit nothing.
  8. Describe. set_extracted (summary, keywords, open questions) for each scene and each node you created.
  9. Finish. mark_processed for each scene, then lint_graph, then tell the author what you did and what needs their decision.

Rules: never rewrite. The author accepts or rejects every change to their prose. When unsure, comment (action add) on the passage instead of acting.