Playbooks overview

What playbooks are, and the difference between a playbook and a run.
View as Markdown

A playbook is a reusable, step-by-step process you set up once and run over and over. Think of it as a checklist with brains: it lays out the tasks that make up a piece of work, the order they happen in, who owns each one, and which ones need a sign-off. People and Florent work through the tasks together.

You define the process once, then run it inside a project whenever that work comes up. One playbook can be run as many times as you need.

A playbook has two shapes

The same playbook shows up in two forms, and you will meet both. Keeping them straight is the key to everything else.

The definition (the blueprint)

The reusable design that lives in Building Blocks. Nobody does work here — you build the steps, set who owns them, and decide what needs approval. It has a status and a version number.

The run (the live work)

One live execution of that blueprint inside a single project. This is where work actually happens: tasks light up, Florent chimes in, files and records get produced, and approvals get granted.

The relationship in one line: a definition is the recipe; a run is one time you cook it. You write the recipe once and cook from it again and again. Each run is numbered (for example PT-001, PT-002) so you can tell them apart.

Editing a definition never disturbs runs already in flight. An active run finishes on the version it started with, so you can safely improve a playbook while older runs are still going.

Where playbooks live

Playbooks appear on three surfaces. The labels and what you can do differ on each.

SurfaceWhat it is
Playbooks libraryThe org-wide list of reusable definitions. You build and publish them here. Reach it from the Building Blocks sidebar group; the page reads “Reusable processes that any project can run.”
The playbook editorThe no-code authoring screen for one definition — where you add tasks, set the order, and publish.
A project’s Playbooks pageInside one project: the playbooks you can run here, plus past runs and the Ask Florent option.

Building and publishing playbooks is a Builder job. If you open the library and see “You don’t have access to playbooks,” ask an admin for the access you need.

The definition lifecycle

Every playbook definition carries a status, shown as a colored badge. A playbook moves through three states over its life.

1

Draft

Being built. Not yet usable in a project. You can edit it freely. A Draft playbook has no Run button in projects — it can’t be started until you publish it.

2

Published

Live and usable. Projects can run it, and a Run button appears next to it. You publish a Draft by clicking Activate in the editor.

3

Archived

Retired. Kept for history but no longer offered for new runs. Use this when a process is replaced or no longer needed.

Versions go up when you publish

Each time you publish changes, the version number increases — v1, v2, and so on. The current version is shown as a chip in the editor header.

This matters for one reason: active runs keep the version they started with. Improving a published playbook never changes a run that’s already underway. New runs use the newest version; in-flight runs finish on the version they began with.

You must publish a playbook before anyone can run it. A Draft playbook shows no Run button in a project. Publishing also validates the playbook first — if anything is wrong, it won’t publish and lists each issue by task name. Fix those, then publish again.

Once a run has started from a playbook, some edits lock down — for example, you can’t rename its internal identifier, and a project-attached playbook can’t be edited once a live run references it. This protects work in progress. Build and check a playbook before you put it to use.

When to build a playbook vs. ask Florent

You don’t always have to build a playbook from scratch. There are two ways to get work running.

Best for repeatable processes you’ll run again and again — the same intake, the same review, the same approvals every time. You design it once in the editor, publish it, and your team runs it the same way every time. This is the right choice when consistency, fixed approvals, and a known set of steps matter.

See Build a playbook for the no-code editor.

A good rule of thumb: if you’ll do this more than a few times, build a playbook so it’s consistent and reusable. If it’s a one-time job or you’re still figuring out the steps, ask Florent.

Where to go next