What a Playbook actually is
A Playbook is the method an expert captures, written down as a document the runtime follows. What goes in it, what a Play is, and what stays yours.
On this page
Most experts who sell the same outcome twice already have a method. It is in a checklist, a saved prompt, a folder of past work, or nowhere except their head. The method is what the customer is actually paying for, and it is the one part of the work that never gets written down.
A Playbook is that method, written down as a document the YAMO runtime follows.
It is a document, not a configuration
This matters more than it sounds. A Playbook is authored text with structure in it, so you can read the whole thing in one sitting and see exactly what will happen. There is no hidden state, and nothing about it is inferred from how you clicked through a screen.
A Play is one step
Inside a Playbook, the ordered steps are Plays. A Play is a single named job: what it reads, what it does, and what it hands to the step after it.1
Splitting a method into Plays is most of the writing. The useful test is whether you could hand one Play to somebody competent who has never done the work, and get back something the next Play can use. If not, it is two Plays.
If you cannot say what one step hands to the next, you have not finished describing the step.The rule of thumb
What sits around the Plays
A Playbook also declares the things a run needs in order to happen at all:
| Declaration | What it answers |
|---|---|
| Trigger | What starts a run |
| Intake | What the run asks for before it begins |
| Artifact | What it produces |
| Delivery | How the result arrives |
Those four are also what a customer sees before they buy, which is the subject of the next post in this series.
It stays yours
Copying a template out of the Playbook Library gives you the document, not a subscription to somebody else's version of it. You edit the Plays, change the declarations and rewrite the wording, and what you end up with is your method rather than a starting point you are stuck inside.
Notes
- 1The vocabulary is fixed and worth learning once: a Playbook contains Plays, and the builder calls one Play a Step where it is showing you a list of them. ↩
More in this series
Read next
From Playbook to published Service
Publishing turns a Playbook into a Service that other people can pay to run. What the public contract says, and what a customer gets when they buy.The method is the asset
An expert who has delivered the same outcome enough times owns a method. Doing the work again by hand for every customer is what that method costs them.Connectors and Connections are not the same
A Connector is the tool a Playbook says it needs. A Connection is the authorisation that lets a run reach it. Two words, and the difference matters.What one run includes
A run is one execution of a Playbook, from the trigger that started it to the artifact it returns. It is also the unit that gets metered and receipted.Pricing
How YAMO charges: you pay for the runs you make, and nothing for the ones you do not. What a run is, what it includes, and what publishing costs.Who it's for
The six kinds of expert YAMO is built for, and what changes when the method you already follow becomes a Service that somebody else can run.
Read a Playbook that does this
Every template in the library publishes its contract and a real example output.