Files
cursor__plugins/pstack/docs/guide/01-setup.md
T
lauren 5bf2b1544d feat(pstack): setup-pstack budget ask (max/xhigh/high/medium) (#366)
* feat(pstack): setup-pstack budget ask (max/xhigh/high/medium)

Step 3 of /setup-pstack asks for a budget first (unlimited, large,
medium, small), rewrites the effort token of every real slug in the
working table to the budget's target, clamps to the detected set within
the same family, and then shows the roles for confirmation. Step 2 reads
the recorded budget line and step 5 writes it. No version bump.

Co-authored-by: lauren <poteto@users.noreply.github.com>

* docs(pstack): mention the setup-pstack budget in README and setup guide

Co-authored-by: lauren <poteto@users.noreply.github.com>

* refactor(pstack): tighten setup-pstack step 3 to three short parts

Drop the four-by-four example table, the repeated family and fast
explanations, and the re-run essay. Keep the four budget labels, one
remap rule with a one-line example, the confirm paragraph, and the
budget line in the written rule.

Co-authored-by: lauren <poteto@users.noreply.github.com>

* fix(pstack): setup-pstack step 3 rebuilds before the budget, keeps aliases, records the chosen budget

Bugbot on #366. The working table is built from the defaults first, on
every run, so unlimited on a re-run restores the default efforts. The
carry-over set names alias roles. Step 5 says the budget line holds the
chosen label and target effort.

Co-authored-by: lauren <poteto@users.noreply.github.com>

---------

Co-authored-by: Cursor Agent <cursoragent@cursor.com>
2026-09-12 20:38:59 -07:00

2.7 KiB

Set up pstack

In this page you install the plugin, pick which models pstack uses, and run your first task. Setup is one command plus a short conversation.

Install the plugin

In a Cursor chat, run:

/add-plugin pstack

Cursor confirms the plugin is installed.

Pick your models

Run:

/setup-pstack

/setup-pstack detects the models you have access to, asks for a reasoning budget, shows you each role (code delegates, judgment, the review panels), and asks what you want. Answer the questions. It writes ~/.cursor/rules/pstack-models.mdc, a small rule every pstack skill reads.

You only override what you care about. A role with no line in the rule keeps the skill's default. To restore a default later, delete that role's line, or just run /setup-pstack again.

You might be wondering what happens if you use Auto. Set a role to inherit-parent or auto and pstack omits the subagent model field, so the subagent inherits your parent chat model. Both values mean the same thing, and neither is a model slug. For a panel role the value is a list, and one subagent runs per entry, so the list length sets the panel size. Setup also configures swarm workers, the default model for every /swarm worker unless a race names a model for each arm.

Accept the verification offer, or don't

At the end of setup, /setup-pstack looks for a way to prove app behavior in your project, either a verify-* skill or an existing harness. If it finds neither, it offers once to generate one with /create-verification-skill.

Say yes and it writes .cursor/skills/verify-<app>/, a project-local skill that teaches agents to drive your app the way a user does. It proves the skill works once before handing it over. Say no and setup moves on. You can run /create-verification-skill yourself any time. Verify and ship covers when it earns its place.

After setup, start a new chat. The model rule applies to new sessions.

Run your first task

Pick something real but small, and describe it the way you'd describe it to a colleague:

/poteto-mode add a --json flag to this command. text output stays byte-identical. verify both.

Watch the todo list. Its first items are the matched playbook's steps copied in, the Feature playbook for this prompt. If /poteto-mode skips a step, the step stays in the list with skip: <reason>, so you can see what it chose not to do.

From here you can type normal follow-ups. /poteto-mode is sticky. It stays on for the conversation until you opt out by saying so.

Next: Route work through /poteto-mode.