Build a playbook
Building a playbook is an admin job in the Playbooks library. You give the agent a goal, break the work into tasks, pick which actions it may run and where it must pause for approval, and choose which space types can run it. Nothing runs from here — a playbook is a reusable definition that people start inside a space (see Run a playbook).
The library and editor are admin-only. Non-admins see “You need an admin role to manage playbooks.”
Create a draft
From Playbooks, click New playbook and give it a Name. That creates a draft and opens it in the editor, where you fill in the rest.
The editor
The header shows the playbook name and its status badge, plus three buttons:
- Activate — appears only for a draft. It’s disabled while there are unsaved changes or the playbook is invalid (it needs a name and a title on every task). Activation runs a server-side check; if anything fails, the editor shows “This playbook cannot be activated” with a bulleted list of issues to fix.
- Save — saves your changes.
- Archive — retires the playbook (hidden once it’s already archived).
The body of the editor has four sections, top to bottom.
Goal
A Name and a Description. The description is the agent’s brief — it’s Markdown describing the goal and context the agent is given. Write it the way you’d brief a capable teammate: what you’re trying to accomplish and anything it needs to know.
Tasks
The ordered outcomes the agent must complete (up to 30). Add one with Add task. Each task has:
- Title (required) — the outcome, in a few words.
- Instructions (optional) — extra guidance for completing it.
- blocked by — a dependency picker. A task can be set to start only after other tasks finish. Only upstream tasks are offered, so a task can’t depend on itself or on a task that runs later. Leave it as “Nothing — can start right away” for tasks that are ready from the start.
You can reorder and remove tasks as you build.
Actions
Check which of your installed actions the agent may run. For each action you turn on, you control where it pauses:
- Approve before running — a pre-approval gate. The run pauses and shows you what the agent proposes before it dispatches the action.
- Review output after running — a post-approval gate. The run pauses so you can review the action’s output before it’s committed.
- can only run after — task gates. Choose the tasks that must be completed before the agent may run this action.
See Approvals and steering for what these gates look like during a run.
Space types
Checkboxes for the space types that may run this playbook. Leave every option clear to make the playbook available in all space types.
User-triggered actions
Some actions are user-triggered — the agent can’t run them on its own because they need you (for example, a browser-fill action that fills a form in your own browser). In the Actions section these show a User-triggered badge and no approval toggles. You start that step yourself from the run page; the agent fills the form and you submit it. Approval gates don’t apply. See Run a playbook for how the step works during a run.
Activate it
When the playbook is valid and saved, click Activate. Its status becomes active and it appears in the run picker for every space type it’s bound to (or all space types, if you left them clear). Only active playbooks can be run.
Activation is gated on validity: the playbook needs a name and every task needs a title, and it must pass the server check. If activation fails, fix the listed issues and try again.