Skip to content
  1. Wiki
  2. How pstack works
  3. Playbooks

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)

PlaybookWhat it's for
InvestigationLook, don't touch; learn how it works
Bug fixRepro, find the cause, fix, verify
Perf issueStart from a measured slowdown; compare
HillclimbPush one metric up, step by step
Runtime forensics / Trace forensicsFind the cause from live symptoms; no fix
FeatureNew feature; settle the data shape first
RefactoringChange structure; behavior stays the same
PrototypeBuild a few drafts; decide on results
Visual parityMake two versions match pixel for pixel
Write a skill / EvalWrite or edit a skill; test the change
BabysitWatch a PR until it can merge
ShippingVerify each PR, then merge in order
Autonomous / OrchestrateRun a long task to the end; run big projects
Autopilot-full / Autopilot-stackRun PRs to merge, or verify and wait for you
Take over / Safe pausePick up unfinished work; stop cleanly
Multi-phase planPlan first for multi-phase, multi-PR work
Clean up worktreesDelete unused worktrees to free disk
Open a PRWrap 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

An unofficial beginner's guide to pstack, not its official docs. pstack is made by poteto; the official repo is the source of truth for commands and behavior. The original guide source is on GitHub.

Hosted by airali. Adapted from Xiaoxiaodong's MIT-licensed guide.