Skip to content

Latest commit

 

History

24 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

pstack

A principle-driven skill pack for Droid with opinionated workflows for planning, shipping, and reviewing code, adapted from the pstack Cursor plugin.

Install

droid plugin marketplace add <this-repo>
droid plugin install pstack@pstack-droid --scope user

The first command registers this repository as a local marketplace. The second installs the plugin for your user account. This exact two-step lifecycle was executed during the ship milestone: install succeeded, the cache tree mirrored this repository, a headless session saw the skills and droids, and teardown left zero residue. The E2E validation re-runs the same lifecycle against the final tree.

Note that Droid keys a marketplace by the directory name of the added path. The id above assumes this repository is cloned as pstack-droid. If you add it under a different directory name, append that name to the install id instead, for example pstack@<marketplace> --scope user.

What it provides

The plugin bundles 48 skills, two droids, and a small script toolkit.

  • 44 skills ported from pstack: 21 principle-* skills you can steer by name, investigation and design workflows (how, why, architect, arena, swarm, interrogate, and more), and the poteto-mode operating system with its 23 playbooks and vendored script toolkit.
  • The four control skills deslop, control-cli, control-ui, and verify-this from Cursor's team-kit are bundled with this plugin, bringing the total to 48 skills.
  • Two droids package the specialized subagents used by those workflows: poteto-agent and comment-sicko.
  • A ten-chapter illustrated guide under docs explains each workflow in depth.

Get started

Two steps:

  1. Run /setup-pstack to map your configured models onto pstack's per-role defaults. Everything stays on the parent model with complexity tiers if you skip it.
  2. Use /poteto-mode whenever you're doing anything that requires rigor.

New here? The pstack guide walks you through a first real task, from setup and prompting through verification and overnight runs.

Prerequisites

Everything core works with a plain Droid install. A few features lean on optional tools:

  • gh: optional. The babysit playbook and the watch-pr scripts wrap the GitHub CLI at runtime. Tests for those scripts are hermetic fakes, so the bundled test suite passes without it.
  • tmux: optional. Used by the control-cli recipes for driving terminal apps.
  • bun or node: needed to run the script toolkit under skills/poteto-mode/scripts/.
  • Graphite gt: optional. Stack workflows (shipping, autopilot-stack) keep their upstream gt instructions as written.

Credits

pstack was created by Lauren Tan and is used here under the MIT License. The deslop, control-cli, control-ui, and verify-this skills bundled with this plugin originate from the team-kit project by Cursor. See NOTICE and PORTING.md for full attribution and the fidelity ledger.

Status

Shipped. All content is ported and adapted per the rulebook recorded in PORTING.md, which also carries provenance, fidelity accounting, and the complete drop list.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages