Scripts

Overview

Script Management is the single hub for all script-related work. Every upload creates a new versioned draft. Admins and super admins can trigger an AI breakdown directly from a newly uploaded version — no separate tool required.

Uploading a new version

• Navigate to Script Management in the sidebar (under Story).
• Drop a PDF or click to browse. The system reads the PDF, assigns the next version number, and — if a prior version exists — generates a plain-English change summary comparing the two drafts.
• The new version appears at the top of the version timeline.

AI script breakdown

After uploading a new version, admins and super admins are offered the option to run an AI breakdown. The breakdown reads the script and proposes every scene, location, and prop. Nothing is written to the project automatically — the results flow through a guided, three-step Breakdown Review (Locations → Scenes → Props & Items) where you confirm, edit, merge, or reject everything before it populates your project.

The breakdown also extracts the full set of scene breakdown elements beyond the art department: cast (speaking roles), stunts, extras (atmosphere and silent), special effects, makeup/hair, sound effects and music, special equipment, and animals. These populate the breakdown sheets and are reviewed on their own Elements tab before import.

Running a breakdown

There are two ways to start a breakdown, both admin-only:

• Right after upload — a prompt appears offering to run a breakdown on the version you just uploaded.
• Any time from the header — the Run Breakdown button in the Script Management header always runs on the latest version. Use it to (re)run a breakdown without uploading a new draft. While an analysis is already running the button shows Breakdown running and reopens its live progress instead of starting a duplicate.

• Click Run breakdown. The system uses the version’s pre-extracted text — no re-upload needed.
• A live progress screen shows the analysis stages (extract → analyze). You can close the page and come back; analysis runs in the background.
• When complete, it opens the Breakdown Review at Step 1 (Locations). You confirm each step in order before it populates the project.
• Scene count and boundaries come from a deterministic parser (the “spine”), not the AI. Two scenes at the same location are never treated as duplicates — a repeated flashback is still a scene to shoot.

Re-running on an updated draft

Running a new breakdown reopens the Breakdown Review at Step 1. If scenes, locations, or props already exist, a prominent warning appears first. If a review is still in progress, a second warning notes that re-running restarts that review at Step 1 and discards its item confirmations (records already committed in earlier steps stay):

Reconciliation now happens inside each review step: locations and scenes offer create / merge / keep / flag / delete choices, and item proposals reuse your established naming to converge on existing records. See Breakdown Review for the full flow and Script Revisions for how scene identity and comments are preserved across drafts.

Start fresh (super admins)

When a project already has breakdown data, super admins see a Start fresh option in the Run breakdown prompt. It wipes all scenes, locations, props, and breakdown elements — along with their comments and attachment records — and then immediately runs a new breakdown on the selected version, giving you a completely clean slate.

"Not in latest draft" badge

Props, scenes, and locations that have been flagged (but not deleted) show an amberNot in latest draft badge wherever they appear in the project — on the Props, Scenes, and Locations list pages. A Hide N not in draft filter lets you temporarily remove them from view.

Restoring an older version

On each version card in the history timeline, a Restore button (circular arrow icon) creates a new current version copied from the selected older version. This preserves the append-only history — nothing is overwritten in place.

Downloading scripts

Any crew member can download any version from the Script Management page. Click the download icon next to the version you want, or use Download Latest in the page header.

Usage limits

Each subscription plan includes a set number of AI breakdowns per project. Additional credits can be purchased from the Billing page.

Permissions