# Playbooks

> In short: A playbook is a ready-made way of making one kind of piece, such as a 30-second ad or a music video. It gives CODA the questions to ask and the order to work in, with a typical cost before you spend anything, and it never spends or approves for you.

Applies to: v0.13 · Last reviewed: 2026-10-15 · Canonical: https://docs.zymcos.com/product/playbooks/

Making a 30-second ad is the same kind of job every time: say what it is for, settle the look, write the script, collect the people and places, plan the shots, make pictures, then clips. A **playbook** writes that order down so you and CODA do not have to rediscover it.

A playbook is **guidance, not permission**. It tells CODA which questions to ask and which step comes next. It cannot spend money, accept a final, approve anything, skip a check or change a setting. Every card still needs your click, and every decision still needs your yes.

## The library

Seven playbooks come with Zymcos:

| Playbook | What it makes |
|---|---|
| **30-second ad** | A short commercial, from the brief to a finished 30-second master |
| **Music video** | Pictures and clips cut to a track you upload |
| **Product showcase** | A product shown from its angles, starting from your photos |
| **Vertical social short** | A 9:16 short for social, with the vertical size decided first |
| **Storyboard to animatic** | A frame per shot, then timed into a rough animatic |
| **Character sheet** | One character, kept consistent across views |
| **Explainer** | A narrated explainer, led by the script |

Each lists its stages in order. A stage that needs a feature Zymcos does not have yet (preparing a cut for delivery, for example) is shown as **arrives in v0.15.0**, so you can see the whole road without being sent down a stage that is not there.

## What it costs

Each playbook shows a **typical cost range** for the stages that make pictures, clips or speech, worked out from the current prices for your plan, at draft and at final quality. It is an estimate of a typical run, not a quote: the card for each take still shows its own price, and nothing is spent until you press its button. If a take cannot be priced on your plan it is named in the range, never counted as free.

## Starting one

On a new production's empty conversation CODA opens on **What are you making?**: the seven playbooks, each with its one line and a typical cost, then **Just make an image** (a quick take, no playbook) and **Something else** (plain CODA). Picking a playbook sends it as your own message and CODA starts asking its questions. Nothing is spent until you press a card.

At any time you can ask CODA by name: *"Start the 30-second ad playbook for our coffee brand."* CODA also suggests one when what you describe fits ("this sounds like a 30-second ad; I have a playbook for that"), and then waits: it starts a playbook when you ask for it or say yes to its suggestion, never on its own reading of what you meant. Or type a slash in the message box and choose the playbook from the menu, for example `/ad-30s`.

Once it is started CODA asks the playbook's **first questions**, one at a time, and the answers go into the production's [charter](https://docs.zymcos.com/product/decisions-and-charter/). From then on CODA knows which stage you are at and what usually comes next, and tells you the next step. A line above the conversation shows where you are (*30-second ad · Stage 3 of 9: Script*).

## Moving through the stages

Tell CODA when a stage is done ("the script is locked, what's next?") and it moves on, or press **Next stage** in the line above the conversation. You can skip back to any step by asking for it: nothing about a stage locks you out of the others. You can **leave** the playbook at any time (**Leave playbook**, or tell CODA); what it proposed and you accepted stays.

## Good to know

- One production follows one playbook at a time. Starting another replaces it.
- A playbook belongs to the production, not to you: everyone working on the production sees the same stage.
- Playbooks you write yourself, and your organisation's, arrive in a later release.
