Script and documents

A project has one documents tree, shown in the editor’s sidebar. The script is pinned at the top; below it sit any reference documents you add. Everything on the following pages applies to every document — only a few things (scene links, the coverage strip) are script-only.

Kinds of document

Kind	What it is
Script	The project’s draft. Exactly one per project, pinned, cannot be deleted or renamed. Its blocks can be linked to scenes.
Reference document	Any note you keep beside the script — a character sheet, brand guidelines, tone notes. Has an image bank of named pictures you can reference inline.
Instructions	Standing directions for Manan, loaded always or on demand.
Skill	A reusable prompt Manan runs when you type `/` and pick it.
Memory	Manan’s own notebook, read-only for you.

The last three are described in Memory and instructions. A document’s kind comes from a card at its very top; the sidebar shows the kind next to the title.

Structure

A document is an ordered list of blocks — paragraphs, headings, lists, quotes, code, dividers, images, galleries. Each block has a stable identity, which is what a scene link points at, what a suggestion targets, and what history diffs are computed on. There is no scene nesting inside a document: prose stays flat, and scenes are linked from blocks.

The header of a document shows its rollup: block count, how many blocks are linked to scenes, and an estimated spoken duration.

The story template

The script’s default shape is one block per scene: a Scene N — Title heading over a bullet list whose items open with a bold label — References, Story Beat, Action, Visual / Camera, Dialogue / Narration, Voice / Performance, Audio / SFX / Music, New / Changed. The script opens with a title and an Overall Story Direction line. Start an empty script with / → Story template, add sections with / → Scene section; Manan writes scripts in this shape unless you ask for another, and reads only the items a job needs (the dialogue of every scene for a narration pass, the visual lines for images).

A reference document follows a matching skeleton — What is it?, Description, Reference Images / Media, Consistency, Avoid, Additional Notes — which the sidebar’s + → Reference and / → Reference template insert. The principle behind the two: references define what things are; the script defines what happens. Name a character or place under References instead of describing it again in every scene.

Organising the tree

Documents nest up to three levels deep. Drag a document in the sidebar to reorder it; drag sideways to nest it under a neighbour. Nesting is for organisation only — mentioning a parent does not pull in its children, and children stay independently mentionable. Deleting a document moves its children up to its parent; nothing is cascade-deleted.

Sizes

Limit	Value
Blocks per document	2,000
Document size	2 MB (the editor shows document too large past this)
Title	200 characters
Image bank	24 images per document; 5 superseded versions kept per image
Nesting depth	3