# Production office

> Build the producer's and line producer's tools on Kwark: a marked-up breakdown that writes its own sheets, cast and locations that feed the budget, paperwork that remembers when it was checked, and sharing by film role.

Source: https://kwark.space/designSystem/kits/production-office

## Who it is for

Teams building breakdown, budgeting, casting, locations and paperwork tools: the production office of a film. The people using it are producers and line producers, production managers and coordinators, ADs breaking down the script, casting directors, location managers, accountants, and heads of department checking their lists.

This kit is in Kwark's pre-production, which is grouped in three bands by how tightly each module is bound to the screenplay (memory: pre-production in three bands). Components: [Breakdown page](https://kwark.space/designSystem/components/breakdown-page.md), [Element tag](https://kwark.space/designSystem/components/element-tag.md), [Cast board](https://kwark.space/designSystem/components/cast-board.md), [Location card](https://kwark.space/designSystem/components/location-card.md), [Budget top sheet](https://kwark.space/designSystem/components/budget-top-sheet.md), [Data table](https://kwark.space/designSystem/components/data-table.md), [Description list](https://kwark.space/designSystem/components/description-list.md), [Stat](https://kwark.space/designSystem/components/stat.md), [Board column](https://kwark.space/designSystem/components/board-column.md) for department requests.

## The screens

| Screen | What it does | Components |
|---|---|---|
| Breakdown | Mark each scene's elements on the page; the sheet writes itself | [Breakdown page](https://kwark.space/designSystem/components/breakdown-page.md), [Element tag](https://kwark.space/designSystem/components/element-tag.md) |
| Breakdown sheets | One per scene, with counts by department | [Breakdown page](https://kwark.space/designSystem/components/breakdown-page.md) (sheet row) |
| Elements | Every element in the film, by department, with its scenes | [Data table](https://kwark.space/designSystem/components/data-table.md), [Element tag](https://kwark.space/designSystem/components/element-tag.md) |
| Cast & Crew | Parts from the script, candidates by stage; crew list | [Cast board](https://kwark.space/designSystem/components/cast-board.md) |
| Locations | Candidates for each scripted place, from idea to locked | [Location card](https://kwark.space/designSystem/components/location-card.md) |
| Budget | Top sheet and accounts; lines follow cast and location rates | [Budget top sheet](https://kwark.space/designSystem/components/budget-top-sheet.md) |
| Paperwork | Permits, releases and insurance, each with when it was last checked | [Data table](https://kwark.space/designSystem/components/data-table.md), [Description list](https://kwark.space/designSystem/components/description-list.md) |
| Department desks | What each department needs, asked and answered | [Board column](https://kwark.space/designSystem/components/board-column.md), [Media grid](https://kwark.space/designSystem/components/media-grid.md) |
| Sharing | People by film role, with dates | [Sharing and roles](https://kwark.space/designSystem/patterns/sharing-and-roles.md) |

## Live demo

The sheet row for Scene 12, a cast part opened, a locked location and the top sheet.

```html
<div class="kw-sheet-row"><span class="kw-tone" data-tone="int-night"></span><span class="kw-sheet-row__number">12</span><span class="kw-sheet-row__heading"><strong>INT. EDIT SUITE – NIGHT</strong><small>1 3/8 pages · Mira</small></span><span class="kw-sheet-row__counts"><span class="kw-element-tag" data-category="cast">Cast 1</span><span class="kw-element-tag" data-category="prop">Props 2</span><span class="kw-element-tag" data-category="sfx">Effects 1</span></span></div>
<ul class="kw-roles"><li class="kw-role" data-cast><button class="kw-role__head" type="button" aria-expanded="false"><span class="kw-role__number">1</span><span class="kw-role__name"><strong>Mira</strong><small>Lead · 14 scenes · 9 shoot days</small></span><span class="kw-stage" data-stage="confirmed">Cast</span><span></span></button></li></ul>
<div class="kw-locations"><article class="kw-location" data-status="locked"><button class="kw-location__open" type="button"><span class="kw-location__photo">Photo<span class="kw-location__status">Locked</span></span><span class="kw-location__body"><strong>Lumen Studios, Stage 2</strong><small>for EDIT SUITE · Scenes 12, 15</small><span class="kw-location__meta"><span>45,000 a day</span></span></span></button></article></div>
<div class="kw-topsheet" aria-label="Top sheet"><h4>Top sheet · INR</h4><div class="kw-topsheet__row kw-topsheet__sub"><span>Above the line</span><strong>18,40,000</strong></div><div class="kw-topsheet__row"><span>Production</span><strong>31,25,000</strong></div><div class="kw-topsheet__row"><span>Post-production</span><strong>9,80,000</strong></div><div class="kw-topsheet__row kw-topsheet__total"><span>Total</span><strong>59,45,000</strong></div></div>
```

## Domain conventions

### Breakdown

- A breakdown reads each scene for everything production must provide: cast, background (extras, junior artists), props, wardrobe, hair and make-up, vehicles, set dressing, special effects, visual effects, sound, music, stunts, animals and special equipment. Kwark's standard list adds mechanical effects, greenery, livestock, animal handlers, security, additional labour and miscellaneous; projects add their own.
- Traditionally an AD underlines elements in coloured pencil, one colour per department, then copies them to a sheet per scene. There is no single universal colour key; software and productions differ. Kwark keeps each department's colour fixed across the app, chosen so no department reads as another (breakdown.css). Always print a legend.
- A **breakdown sheet** heads with the scene number, INT/EXT, set, D/N and length in eighths, then lists elements by department.
- Elements are named in the script's words. "Police car" is one vehicle, not two marks.

### Budget

- A budget is organised into **accounts** (and lines within them), summarised on a **top sheet** read by producers and financiers.
- **Above the line** covers story and rights, producers, director and principal cast; **below the line** covers production, post-production and other costs. Account numbering differs by country and by the budgeting software a financier expects; let the production choose a chart of accounts rather than inventing one.
- Money in the project's currency, with that currency's grouping (Indian grouping 59,45,000 for INR).
- A line may **follow a rate** from Cast & Crew or Locations, read live and named in words, with *I type the rate* to unlink (Decision 0022). A figure copied twice will drift.

### Casting

Parts come from the screenplay; no role can be invented in casting (CastingBoard). Stages in Kwark: Idea, Approached, Read, Callback, Offer out, Cast, Passed. Fees and agents' details are behind Cast & Crew permission.

### Locations

Each scripted place (EDIT SUITE) has candidates: Idea, Recce, Shortlist, Locked, Dropped. One locked location per place. Dropped candidates keep their reason.

### Paperwork

Permits, releases, insurance and labour paperwork are **country-specific and change** (memory: understanding is about the story). Kwark records a person-typed *last checked* date and *what you were told*, and shows the age in words in grey (*Checked 12 days ago*). The app never decides a legal fact is out of date (Decision 0022).

### Sharing by film role

Share by the role people hold on a film: Reader, Actor, Co-writer, Director, Producer, Camera, Crew, or Custom, with an optional end date (Decision 0042). A role is a template over a per-module map. Never default to *edit everything*.

## Keyboard map

| Key | Does |
|---|---|
| Select text, then Enter | Open "is a…" to mark it on the breakdown page |
| 1 – 9 | In that panel, choose the category in list order |
| Esc | Close the panel without marking |
| ← / → (scene list) | Previous / next scene |
| ⌘ F | Find an element across the script |
| ⌘ ↵ | In the budget, add a line under the current account |
| ⌘ P | Print the current sheet |

## Phone and desktop

**Desktop** is where breakdowns and budgets are built: the marked page beside the sheet, accounts beside the top sheet.

**Phone** is for the recce and approvals:

- Locations: photograph a candidate and add it to the scripted place on the spot.
- Cast: move a candidate's stage after a call.
- Budget: read the top sheet; edit nothing larger than a note.
- Rows have no buttons on phones; actions are in the row's ⋯ sheet.

## AI and authorship

Kwark's breakdown already guesses, with rules on the device: it reads capitals and a short list of nouns production must account for, and offers them under *The script mentions*, each with *Add* and *Not needed*. Nothing counts until a person says so ([AI and authorship](https://kwark.space/designSystem/foundations/ai-and-authorship.md)).

- **May** find elements in the script and propose them, with the reason (*Set in capitals, the way an element is introduced*).
- **May** propose lines for the budget from confirmed cast and locked locations (*Bring in 3 cast and location lines*).
- **Never** add an element, a budget line or a cast decision without a person accepting it.
- **Never** judge a budget as too high or too low, or a location as better.
- **Never** move a fee into a place a wider role can read.

**Do:** *The script mentions: Zippo · Prop* with Add and Not needed.

**Don't:** Twenty props added to the sheet automatically because the model "found" them.

## Accessibility notes for this craft

- Category names appear in words wherever colour does; printed sheets carry the legend.
- Marking works from the keyboard.
- Money is right-aligned in tabular figures; the currency is in the heading, not every cell.

## Edge cases to test

- A line in the script is rewritten after it was marked: its marks disappear from the page and the sheet keeps the element with a note that the words are no longer in the scene, so nothing is lost silently.
- The same prop appears in 40 scenes: *Mark it in all 40 scenes that mention it* does it in one act, and undo removes all 40.
- A confirmed actor's fee changes in Cast & Crew: every budget line that follows it updates, and the top sheet shows the new total with the line's source named.
- Two candidates are locked for the same scripted place by two people at once: the later lock wins, the earlier returns to Shortlist, and both people are told in words.
- A paperwork item was last checked a year ago: the age shows in grey words, never in red, and no warning is raised by the app.
- A collaborator's access ends on a date: their role stops at midnight in the project's time zone, and their own private research stays theirs.

## Starter prompt

> You are building the breakdown and budget of a production office app on the Kwark Design System. Read https://kwark.space/designSystem/kits/production-office.md, /components/breakdown-page.md, /components/element-tag.md, /components/budget-top-sheet.md and /components/cast-board.md. Marking words on the read-only page must write the scene's sheet in the same act; offer marking every scene that mentions the same words. Budget lines may follow live rates from cast and locations and must say where a rate comes from. Paperwork records when it was last checked and never marks anything out of date by itself. Share by film role. Use only `--k-*` tokens. Report anything the system does not define.

## AI readiness test

**Task:** Bring confirmed cast and locked locations into the budget for Blank Pages.

**Give the agent:** Production office kit, Budget top sheet, Cast board, Location card, Decision 0022.

**Constraint:** Only the producer can see actors' fees.

**A reliable answer:**
- Offers "Bring in N lines" for confirmed cast and locked locations only
- Lines follow live rates with the source in words
- No fee copied where a wider role can read it
- Top sheet totals update
- Nothing added without the producer accepting
