pstack-claude README

The project's README from github.com/michael-denyer/pstack-claude. As one markdown file: README.md.

pstack

Lauren Tan's pstack is an opinionated Cursor skill stack that improves agent outcomes. This is a port for Claude Code, Codex, Pi and other agent harnesses. It tracks upstream and also carries named policy forks, each declared in tools/forks.json.

Tell poteto-mode your goal and it will invoke the correct workflow for the task. It keeps your code concise, simple and verified.

For concurrency bugs and invariants that tests cannot reach, see the separate agent-formal-verify plugin, which adds TLA+ model checking and Lean proofs.

Install

Claude Code

Run in Claude Code:

/plugin marketplace add michael-denyer/pstack-claude
/plugin install pstack@pstack-claude

Codex

Run in your terminal:

codex plugin marketplace add michael-denyer/pstack-claude
codex plugin add pstack@pstack-claude

Pi

Run in your terminal:

pi install git:github.com/michael-denyer/pstack-claude

The package loads the skills and the pstack Pi extension, which adds the subagent, question, and wake-up tools the skills use, plus /loop and the routing instruction. Invoke a skill with /skill:<name>.

Run setup-pstack to change model defaults, set a reasoning effort per role (for example arena runners: opus @xhigh, fable @max, which Claude Code dispatches through the plugin's pstack:effort-<level> or pstack:poteto-agent-<level> agents; roles without a level keep the session's effort unless the sheet's default effort line names one), or turn automatic routing off. The plugin installs the routing hook on Claude Code and Codex; Codex asks you to trust it through /hooks before it runs. On Pi the extension injects the same routing instruction. In Claude Code, use /pstack:setup-pstack.

For Prime Agent, OpenCode, Gemini CLI, or skills-only installs for any harness, see shared installation.

Getting started

Use poteto-mode to fix the search filter resetting when I change pages.

For a bug, it reproduces the failure, uses how and why to investigate, delegates the fix, then reruns the failing case. If the fix crosses a function boundary, it brings in architect before implementation. You receive the fix and the failing and passing evidence.

Other playbooks cover planning, features, refactoring, performance issues, investigations, prototypes, PR maintenance, shipping, and longer projects.

A request enters poteto-mode. Playbook options include Plan, Bugs, Features, and Refactor. Planning can use architect, arena, or swarm; review and verification can use interrogate, tests, and measurements. Supporting skills include how, why, and unslop. The output is Finished work validated.

Details

Data handling

pstack has no server or telemetry. Anything its skills ask your agent to read, including session transcripts, goes to your model provider. Scripts run locally, and PR tools use your GitHub CLI login.

Contributing

Thanks for helping make this port better. Bug reports, documentation fixes, and runtime improvements are welcome. See CONTRIBUTING.md for the checks and where your change belongs. Report vulnerabilities privately as described in SECURITY.md.

License

This port, including its modifications and additions, is also MIT-licensed, © 2026 Michael Denyer. Original pstack © 2026 Lauren Tan; imported cursor-team-kit skills © 2026 Cursor. See LICENSE-cursor-team-kit and NOTICE.md.

pstack-claude (michael-denyer/pstack-claude)

Searching Database…

2.8K ·GitHub
Pstack-claude
这是什么？pstack 是 Lauren Tan（Poteto）那套主张鲜明、用于提升编码智能体效果的 Cursor 技能栈的移植版，已适配到 Claude Code、Codex、Pi、Copilot、OpenCode、Gemini CLI 和 Prime Agent 上运行。
这是独立应用，还是给我的编码智能体用的插件？它是一个安装到现有编码智能体框架（harness）中的技能/插件包，而不是独立应用；它会为你已经在用的框架添加技能、斜杠命令、子智能体/提问/唤醒工具以及一个路由钩子。
怎么把 pstack 安装到我的编码智能体里？在 Claude Code 中运行插件安装命令，或在终端运行 Codex 或 Pi 的等效命令；通用安装文档覆盖 Prime Agent、OpenCode、Gemini CLI，以及面向任何框架的纯技能安装方式。
pstack 支持哪些编码智能体？Claude Code、Codex、Copilot、Pi、OpenCode、Gemini CLI 和 Prime Agent。
安装上有什么需要留意的坑吗？路由钩子只有在 Claude Code 和 Codex 上才会自动安装，而且在 Codex 上你必须先通过 /hooks 明确批准它才会运行；在 Pi 上则是扩展注入相同的路由指令，而不是使用钩子。
pstack 会把我的代码或会话数据发送到别处吗？pstack 本身没有服务器，也没有遥测；它的技能让智能体读取的任何内容（包括会话记录）都会作为正常智能体使用的一部分发送给你的模型提供商，PR 相关工具则使用你本地的 GitHub CLI 登录。
poteto-mode 是什么？poteto-mode 是你向它告知目标的路由器；随后它会为这个任务调用正确的 pstack 剧本（修缺陷、做功能、重构、规划等）。
单独的 agent-formal-verify 插件增加了什么？它处理测试覆盖不到的并发缺陷和不变量，在 pstack 工作流之上增加了 TLA+ 模型检查和 Lean 证明。
pstack 是怎么处理一次典型缺陷修复的？它会复现故障、查明原因和机制、委派修复并重跑失败用例；如果修复跨越函数边界，会先引入架构师角色，最终你会拿到修复内容以及失败和通过的验证证据。
tools/forks.json 是做什么用的？pstack 在跟踪上游 Cursor 技能栈的同时，还携带多个具名策略分支（fork），每个都在 tools/forks.json 中声明，从而可以应用不同的行为配置。
What are similar projects?agents, pstack, open-steps, superpowers-zh, open-pstack, Orbital, orca, claude-plugins-official
Which topics is it in?codex-plugin, claude-plugin, codex-skills, claude-code-skills, subagents, codex-cli, claude-code-plugin, gemini-cli, code-review, harness, opencode, coding-agents
Creator
michael-denyer
Size
6.7 MB
Stars
2.8K
Updated
CommitOct 17Releasev0.9.92Oct 17
Age
4mo
Commits · 90 Days