Skip to content

About

Portable Agent Plugins 1.0 port of pstack with Kiro support

Resources

Stars

1 star

Watchers

0 watching

Forks

Latest commit

 

History

114 Commits

Folders and files

Repository files navigation

pstack Agent Plugin

pstack is Lauren Tan's collection of rigorous engineering workflows for writing less, higher-quality code and parallelizing work with verifiable boundaries. This repository is a standalone Agent Plugins 1.0 port of the original cursor/plugins/pstack package, with a Kiro runtime adapter.

What is portable

The root package follows Agent Plugins 1.0:

pstack-agent-plugin/
├── plugin.json
├── skills/
├── dev.kiro/
├── agent-sops/
└── docs/

Agent Plugins standardizes the manifest, Agent Skills, and optional MCP configuration. pstack ships skills and skill-local scripts; it does not ship an MCP server.

Install in Kiro

If a same-name pstack Power or native skill already exists, inspect its source before installing. Preserve an official installation and all conflicting skill targets. Do not silently replace it, rerun an installer to force discovery, or select a copy by version alone. A replacement or a new admission path needs the user's explicit scoped decision. The steps below apply to a new installation, not automatic reconciliation of an existing one.

  1. In Kiro IDE, open Powers and choose Add Custom Power.
  2. Import this repository from GitHub or select the local repository root.
  3. Start Kiro CLI v3 and run /powers to confirm pstack is installed.
  4. Ask Kiro to use poteto-mode, or install the optional pstack-poteto agent profile from dev.kiro/README.md.
  5. Run the setup-pstack skill if you want explicit Kiro model, named-agent, or reasoning-effort routing.

Kiro agent profile installation, validation commands, runtime mappings, and unsupported hosted automation behavior are documented in dev.kiro/README.md.

Main workflow

Use the poteto-mode skill for non-trivial engineering work. It selects a playbook, applies the relevant principle skills, delegates bounded work when useful, and verifies the real artifact before reporting completion.

Representative skills include:

  • how for code and architecture walkthroughs.
  • poteto-help for installation, setup, and choosing the right skill or playbook.
  • ketchup for an evidence-backed plain-language catch-up and complete decision brief.
  • ketchup-video for the same catch-up as locally rendered subtitled slides when an authorized renderer and media channel are available.
  • why for evidence-backed design history.
  • architect and arena for competing designs.
  • swarm for partitioned parallel work.
  • interrogate for adversarial review.
  • pstack-tdd, blast-radius, and no-comments for implementation quality.
  • benchmark-checklist and principle-explain-the-number for validating measured performance results.
  • correct for turning repeated agent mistakes into architecture, type, lint, CI, or test enforcement.
  • create-formal-verification-skill and maintain-formal-verification-skill for bounded, code-linked properties and verification drift.
  • statechart for TLA+ rule checks, Mermaid state graphs, and shortest bug paths. Its optional dependencies and runtime outputs stay in authorized scratch; missing tools do not trigger an implicit installation.
  • make-bot-ui for a bounded authenticated event UI using an actually configured external runner, with private-by-default exposure and explicit delivery proof.
  • technical-writing and unslop for prose.
  • comment-sicko for independent comment review.
  • triage-issue-reports and reproduce-and-fix-issues for the portable Benny workflow contracts.
  • sync-pstack-upstream for reviewing and porting parent changes without overwriting portable or Kiro adaptations.

The full guide remains under docs/guide/. Client-specific examples in the upstream guide should be interpreted through the Kiro runtime mapping. The pinned source and extraction history are recorded in docs/upstream.md.

Compatibility boundaries

Agent Plugins 1.0 does not standardize custom agents, model routing, transcript storage, hooks, hosted automations, or durable schedulers. The Kiro adapter provides optional custom-agent templates and explicit fallback rules. See docs/compatibility.md.

Cursor Routines, Cursor Automations, /loop, /goal, nested cloud workers, and cursor-team-kit are not represented as portable capabilities. pstack reports those capabilities as unavailable or uses a bounded Kiro fallback instead of claiming parity.

Independent changes branch from trunk. Only genuine dependencies form stacks. Verification distinguishes finished code, major behavior changes, smaller fixes, and exact-head required checks. A worker's report or green check alone is not a complete acceptance receipt. Whole-port review, accepted provenance, publication, promotion and installed delivery are separate gates.

The optional Kiro template uses a parent-supplied exact skill path before approved host discovery. It never silently selects the highest-version copy or replaces a same-name official Power. The source template does not create a Crew identity, private memory store, skill admission rule, permission grant, or schedule. Existing source and installation configuration remain under the user's control.

Porting workflow

agent-sops/port-cursor-plugin-to-agent-plugin.sop.md defines the repeatable workflow used for this port. It covers history extraction, manifest conversion, skill normalization, client-extension isolation, Kiro adaptation, and validation.

Development and validation

Run:

node scripts/validate-plugin.mjs
kiro-cli agent validate --path dev.kiro/agents/pstack-poteto.json
kiro-cli agent validate --path dev.kiro/agents/pstack-comment-sicko.json

The Bun tools under skills/poteto-mode/scripts/ retain their existing tests and typecheck commands.

Attribution and license

The original pstack content is by Lauren Tan and is distributed under the MIT license in LICENSE. This standalone port preserves the extracted pstack git history.

About

Portable Agent Plugins 1.0 port of pstack with Kiro support

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages