Playbooks
A playbook is the fixed set of steps for one kind of task. You describe the task; it picks one and follows it.
An analogy
Like hospital triage. You describe the symptoms, the nurse sends you to the right department, and each department has its own routine.
In pstack
/pstack:poteto-mode has 23 playbooks. You don't name one: describe the task and it picks. If nothing fits, it uses /pstack:figure-it-out to design one on the spot.
A few phrases change its choice. "Don't change code yet": investigate only. "New task": treat it as something new and pick again. "I'm going to bed": keep working on its own for a long stretch.
The 23 playbooks (some grouped)
| Playbook | What it's for |
|---|---|
| Investigation | Look, don't touch; learn how it works |
| Bug fix | Repro, find the cause, fix, verify |
| Perf issue | Start from a measured slowdown; compare |
| Hillclimb | Push one metric up, step by step |
| Runtime forensics / Trace forensics | Find the cause from live symptoms; no fix |
| Feature | New feature; settle the data shape first |
| Refactoring | Change structure; behavior stays the same |
| Prototype | Build a few drafts; decide on results |
| Visual parity | Make two versions match pixel for pixel |
| Write a skill / Eval | Write or edit a skill; test the change |
| Babysit | Watch a PR until it can merge |
| Shipping | Verify each PR, then merge in order |
| Autonomous / Orchestrate | Run a long task to the end; run big projects |
| Autopilot-full / Autopilot-stack | Run PRs to merge, or verify and wait for you |
| Take over / Safe pause | Pick up unfinished work; stop cleanly |
| Multi-phase plan | Plan first for multi-phase, multi-PR work |
| Clean up worktrees | Delete unused worktrees to free disk |
| Open a PR | Wrap up: tidy commits, write the description |
Common misconceptions
- "I have to learn all 23 first": no. You describe the task; picking the playbook is its job. This table just helps you read the to-do list.
- "Every step in the playbook runs": not always. Steps it doesn't need stay on the list, marked
skip:with a reason.
Try it: Not sure which skill to use
Related: /pstack:poteto-mode, The to-do list and skip