BlogTooling

pstack workflows in Cursor and Claude Code, and how a team adopts them

pstack is a plugin by Lauren Tan for Cursor and Claude Code that routes engineering tasks to playbooks, assigns models to roles and runs work and review in parallel. We describe its playbooks as of October 2026, how Claude Code differs from Cursor according to the plugin's documentation in November 2026, and how we would bring pstack into your team's repositories.

By Updated

What pstack is and where it comes from

pstack is a plugin for Cursor and Claude Code, published in the cursor/plugins repository on GitHub under the MIT licence. Its author, Lauren Tan (poteto), writes in the README that these are the skills used every day to ship code at Cursor, with the aim of writing less code of higher quality. On 10 October 2026 the manifest listed version 0.15.15.

In Cursor you install it with /add-plugin pstack in a chat or from the Customize view. In Claude Code you run /plugin marketplace add cursor/plugins and then /plugin install pstack@cursor-plugins. After that, /setup-pstack sets up the models for each role and /poteto-mode starts the work. Claude Code adds the plugin's prefix to both, as /pstack:setup-pstack and /pstack:poteto-mode, and this article writes commands in their Cursor form.

  • Skills such as poteto-mode, setup-pstack, how, why, architect, arena, swarm and interrogate
  • Playbooks inside poteto-mode, one per kind of task
  • Principle skills of one rule each
  • Two subagents: poteto-agent and Comment Sicko, a read-only comment reviewer
  • The dormant benny automation pack for Slack issue reports, which opens draft pull requests only and, like other Cursor automations, is skipped in Claude Code

The README calls poteto-mode the author's own style and invites readers to fork the plugin, and /automate-me drafts a personal mode from your chat history. For a team, most of the work is deciding how much of that style fits yours.

The pstack workflows: one mode and its playbooks

The entry point is poteto-mode. It matches the task to one of its playbooks, opens a to-do list that starts with that playbook's steps copied in verbatim, and calls other skills as the steps need them. Skipped steps stay on the list with a reason. Large or cross-cutting work goes to the figure-it-out skill, which designs a bespoke playbook and keeps a decision log.

In Cursor, Enter attaches poteto-mode to one message, while Option+Enter or Alt+Enter keeps it on as a Custom Mode. Every code playbook ends with Opening a PR: a git worktree, small ordered commits, a cleaned diff, a Conventional Commits title and a pull request opened ready for review.

  • Understanding: Investigation, Runtime forensics and Trace forensics, which change no code
  • Changing code: Bug fix, Feature, Refactoring, Perf issue, Hillclimb and Visual parity
  • Deciding: Prototype and Multi-phase plan
  • Merging and long runs: Babysit, Shipping, Autopilot-full, Autopilot-stack, Orchestrate and Autonomous run
  • Upkeep: Authoring a skill, Eval, Session pickup, Pause safely and Worktree cleanup

Bug fix, step by step

Bug fix shows the pattern the code playbooks share. The lead agent plans and reviews, while subagents investigate and implement.

  1. 1

    Reproduce

    Reproduce the defect where it occurs, through a control skill, and ask a person only with a stated reason.

  2. 2

    Find the cause

    Rule out hypotheses with runtime evidence until one survives, adding instrumentation where state is unclear.

  3. 3

    Delegate

    Run architect if the fix crosses a function boundary, then hand implementation to a subagent on the bug-fix model.

  4. 4

    Verify

    Rerun the original reproduction on the same surface. An inconclusive result is flagged and does not count as a pass.

  5. 5

    Order the commits

    Land the failing reproduction or test before the fix in history.

  6. 6

    Open the pull request

    Run Opening a PR and paste the failing and passing output.

Feature and refactoring

Feature runs how and then architect, which explores designs in parallel and goes straight on to implementation unless you ask for a checkpoint. When several shapes are valid, delegation through arena is mandatory. Refactoring first pins behaviour with a characterisation test, snapshot or equivalence harness, states that type checks and lint are not a pin, and reverts a change that does not make the code easier to read.

Where a person approves

Most code playbooks have no approval step before the pull request, so pull request review is where your team's judgement comes in. Hillclimb agrees the metric with you, Multi-phase plan waits for the operator's go, and Autopilot-stack hands over a verified stack for the operator to land.

Babysit drives a pull request to merge-ready and never merges. Shipping merges only when asked, after an agent that did not write the code has verified each pull request. Autopilot-full lets owner agents merge once the root agent's verification is clean, under a full-autonomy grant. The mode pauses for force-pushes to shared branches, deploys, data deletion and customer messages, but posts to team chat and updates tickets without asking.

The role rule: which model does what

pstack ships no rule file. /setup-pstack writes one. Its instructions tell it to detect the models a subagent can actually use in your session, ask for one of four reasoning budgets from medium to max effort and confirm each role with you before it writes the file. In Cursor the rule goes to ~/.cursor/rules/pstack-models.mdc and is always applied, and in Claude Code it goes to ~/.claude/rules/pstack-models.md. It applies to new chats and sessions.

The excerpt below shows the rule in its Cursor form with the defaults of 10 October 2026. Those defaults gave code delegates, explorers, investigators and swarm workers one model, and judgement, prose, the hardest changes and synthesis another. Defaults change between revisions, so read the excerpt as an example of the format. Each panel entry starts one subagent, and auto or inherit-parent runs a role on the chat's own model. In Claude Code, pstack's harness guide maps Cursor's model names, omits non-Claude models and runs those roles on the session model.

Excerpt of the role rule written by /setup-pstack, defaults on 10 October 2026
---
description: pstack per-role model choices (overrides skill defaults)
alwaysApply: true
---
# budget: large (xhigh)
feature, refactoring: grok-4.7-xhigh-fast
bug-fix: grok-4.7-xhigh-fast
judgment and prose: claude-opus-5-5-xhigh
hardest tasks: claude-opus-5-5-xhigh
interrogate reviewers: claude-opus-5-5-xhigh, grok-4.7-xhigh-fast
...

Each role is a subagent with its own context. Cursor's documentation puts it plainly: five parallel subagents use roughly five times the tokens of one agent, billed at the list price of each model. pstack's guide lists the levers, which are a smaller budget or cheaper models, auto for some roles, shorter panels, and poteto-mode only where the rigour is needed.

Shorter panels cost something too, because pstack reviews through model diversity. The interrogate skill gives one reviewer per configured model the same diff and treats findings that two models raise independently as the strongest signal, and Orchestrate puts each verifier on a different model family from its worker. A one-model panel saves tokens and loses that check. In Claude Code, non-Claude models drop out of these panels and those reviewers run on the session model, so review across model vendors is not available there.

For a team, two details matter. The file sits in each engineer's home directory and several skills read it from there, so one plugin revision can run different models on two laptops. The defaults also change between plugin revisions, and a rule written before a change keeps the old default, so earlier adopters keep the old models and panels.

Parallel agents in Cursor: how pstack fans out and checks work

Cursor runs subagents in parallel when the agent sends several Task calls at once. They share the parent's checkout unless each gets its own git worktree or cloud environment, and /in-cloud sends the next task to a cloud subagent. pstack's guide insists on that isolation, because agents in one worktree overwrite each other. Claude Code has no Cursor cloud agents, so what this section says about cloud agents applies to Cursor only.

The swarm skill fans N workers out over slices or a declared race, as cloud agents by default, and returns one report. The arena skill gives N candidates the same brief, has a read-only judge score them, then picks a base and grafts in the best parts of the rest. The architect skill runs arena over design sketches, and the read-only reviewers of interrogate sort findings into act on, consider, noted and dismissed without applying anything.

The heavier playbooks multiply this. Shipping verifies each pull request with its own cloud agent, Autopilot-full reruns a swarm after every push that changes the patch, and the Multi-phase plan template asks for ten live verification lanes per pull request. Orchestrate keeps about ten children in flight per sub-coordinator.

These are the plugin's defaults. Before the heavier playbooks run on your repositories, set your own limits:

  • Swarm workers and live lanes per pull request
  • Panel sizes for interrogate, arena and architect
  • Which playbooks may run, and which may merge
  • Reasoning budgets, time boxes and retry caps
  • One writer per worktree or branch
  • Which MCP servers cloud agents reach, with which credentials

What pstack expects from Cursor or Claude Code, other plugins and MCP servers

pstack relies on parts it does not ship. Some are named in the README, and the playbooks and scripts show the rest.

  • Host features: in Cursor, subagents, cloud subagents, Custom Modes, /loop and the built-in create-skill, and in Claude Code, the tools pstack's harness guide maps them to, without Cursor cloud agents, Automations or Bugbot
  • The cursor-team-kit plugin: /deslop before commits, control-cli and control-ui for live checks
  • MCP servers, which the why skill maps to seven evidence categories, reporting missing ones as gaps
  • The GitHub CLI or the Origin CLI, Bun for the watcher and orchestration scripts, and Graphite's gt for Orchestrate
  • A verification skill for your app, which /create-verification-skill generates and proves once
  • In Cursor, a plan with the models you assign and Teams or Enterprise for a team marketplace, and in Claude Code, access to the Claude models you assign

Two of these raise access questions. The why investigators run in agent mode, because read-only mode strips MCP access, and the skill only notes that they should not write. Cloud subagents take their MCP servers from your team's configuration in Cursor, so read-only credentials on those servers are the control that holds.

Forks need one more check. The autopilot playbooks re-read themselves from trunk every hour and the plan playbook runs a checker script, both through paths from the cursor/plugins layout. Those paths resolve in your repository only if the plugin sits at the same place.

Paths the playbooks assume, from the cursor/plugins layout
git show origin/main:pstack/skills/poteto-mode/playbooks/autopilot-full.md
git show origin/main:pstack/skills/poteto-mode/playbooks/autopilot-stack.md
node pstack/skills/poteto-mode/scripts/check-plan.mjs <plan.md>

Adopting pstack in a team

We treat pstack like any dependency that changes how code reaches your main branch. That comes down to five steps.

  1. 1

    Pin a revision in your own fork

    Fork the repository, as the README invites, and name an owner for local changes. Cursor's team marketplaces on Teams and Enterprise plans can import your fork, update when the tracked branch moves and mark the plugin Default Off, Default On or Required. Engineers who install it from there get a new revision only when you move that branch. In Claude Code, auto-update for third-party marketplaces is off by default, so agree when engineers update.

  2. 2

    Read the playbooks with your reviewers

    Note where each playbook acts without asking and decide what to leave out. Autopilot-full merges on an agent's verdict, for example, and poteto-mode posts to team chat and updates tickets without asking.

  3. 3

    Wire in your commands and approval points

    Swap generic checks for your build, test and CI commands, generate a verification skill and add stops where your process needs a person. Change conventions that differ from yours, such as ready-for-review pull requests and Conventional Commits titles.

  4. 4

    Choose models and limits from your own results

    Run a scoped set of changes your team has already merged under two or three candidate role rules and panel sizes. Compare correctness, review effort, retries and cost per accepted change, then give everyone the same rule file.

  5. 5

    Rerun the same tasks before every upgrade

    Diff the new revision, including the setup-pstack defaults, and rerun the task set before moving the tracked branch. Where defaults changed, delete stale role lines or rerun /setup-pstack.

What pstack does not enforce

Playbooks, principles and the role rule are text in the model's context. Cursor's documentation says applied rules sit at the start of that context and that AI guidance should not be your only security control. pstack's own principle on shared state agrees: instructions and conventions are not concurrency control.

The limits sit outside the plugin, in the agent's credentials, branch protection, required approvals and required CI checks. Autopilot-full says its root agent never grants or bypasses an approval your Git host enforces, which helps only if your Git host enforces one. Babysit says it never merges, and if the agent's token can merge without review, that sentence is all that stands in the way.

So check the controls before the playbooks: narrow token permissions, required reviews and status checks on protected branches, and no deploy credentials in agent environments. Whether pstack improves your team's results is something only a measurement on your own tasks can show.

How pstack compares with other packaged workflows

Superpowers, from Jesse Vincent and Prime Radiant, moves from brainstorming and a written plan to subagent-driven execution with test-driven development and code review. The compound engineering plugin runs brainstorm, plan, work, simplify and review, then records lessons in docs/solutions. GitHub's Spec Kit goes from a constitution through specification, plan and tasks to implementation. All three are MIT-licensed, and the first two list Cursor among their supported hosts.

pstack picks one of its playbooks by kind of task and has no planning skill. In the README, Lauren Tan writes of not believing in planning, calls code the best spec and notes that Cursor's plan mode works well with pstack. Its weight sits on evidence from the running app and on review by several models. In Cursor that review spans model families and relies on Cursor's subagents, Custom Modes and /loop, while in Claude Code it runs with Claude models only.

How we help teams adopt pstack

We read the pstack revision you intend to use, list what it expects and go through the playbooks with your reviewers. We wire in your commands and approval points, leave out what your controls do not support, and set model assignments and parallel limits from measured results and cost on your own tasks, which then serve as your upgrade check.

pstack workshops run as team sessions on your own repositories, remotely or on-site in Germany and Poland, in English, German or Polish. We do not run public courses or issue certificates.

Questions

Does pstack work outside Cursor?

The plugin documents Claude Code as a second route, with limits. There pstack installs from the cursor/plugins marketplace, and its commands carry the plugin prefix, as in /pstack:poteto-mode. Its Claude Code guide maps Cursor's tools, model names and paths and omits non-Claude models, so those roles run on the session model. It also skips the Cursor-only cloud agents, Automations and Bugbot. This article covers the documented Cursor and Claude Code routes.

Can pstack merge pull requests on its own?

Some playbooks can. Babysit stops at merge-ready, Shipping merges only when asked to land or ship, and Autopilot-full lets owner agents merge after a clean verification under a full-autonomy grant. Whether any of that is possible depends on the agent's credentials, branch protection and required approvals, which pstack does not control.

How much will pstack add to our Cursor or Claude Code costs?

It depends on panel sizes, worker counts, reasoning budgets and models, so we do not quote a figure. Each subagent uses its own tokens, and in Cursor it bills at the list price of its model. We measure cost per accepted change on your tasks before and after adoption.

Do we have to use all of its playbooks?

No. According to its help skill, installing pstack changes nothing until someone invokes a skill, and poteto-mode runs only the playbook that matches the task. In your own fork you can remove playbooks your team does not want.

Do you run pstack workshops or training?

Yes, as team sessions on your own repositories, remotely or on-site in Germany and Poland, in English, German or Polish. There are no public courses or certificates.

Talk to an engineer

Bring one piece of work you would like to improve. The call takes 30 minutes and needs no access to your systems or your data.

Booking runs on Google Calendar.

Mickey Graf

Mickey Graf

Founder and CEO of Cloudsail

Rated 4.9 out of 5 on Clutch

Prefer to write first? Leave your email and a few lines. Mickey reads every message himself and replies by email with times for a call.

The button prepares an email in your own email program, for you to send. Privacy policy (draft)