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…

Что это?pstack — перенос набора навыков (skill stack) Лорен Тан (Poteto) для Cursor со своим авторским мнением, который улучшает результаты кодинг-агентов; адаптирован для работы на Claude Code, Codex, Pi, Copilot, OpenCode, Gemini CLI и Prime Agent.
Это отдельное приложение или плагин для моего кодинг-агента?Это набор навыков/плагин, который устанавливается в уже имеющуюся оболочку кодинг-агента (harness), а не отдельное приложение; он добавляет навыки, слэш-команды, инструменты для субагентов/вопросов/пробуждения и routing-хук в ту оболочку, которой вы уже пользуетесь.
Как установить pstack в мой кодинг-агент?Вы выполняете команду установки плагина внутри Claude Code или эквивалентную команду в терминале для Codex или Pi; общая документация по установке охватывает Prime Agent, OpenCode, Gemini CLI, а также установку только навыков для любой агентной оболочки.
Какие кодинг-агенты поддерживает pstack?Claude Code, Codex, Copilot, Pi, OpenCode, Gemini CLI и Prime Agent.
Есть ли подводные камни при установке, о которых стоит знать?Routing-хук устанавливается автоматически только на Claude Code и Codex, причём на Codex его нужно явно одобрить через /hooks перед запуском; на Pi расширение вместо хука внедряет ту же инструкцию маршрутизации.
pstack отправляет мой код или данные сессии куда-либо?У самого pstack нет ни сервера, ни телеметрии; всё, что его навыки просят вашего агента прочитать, включая транскрипты сессий, уходит вашему провайдеру модели в рамках обычной работы агента, а инструменты, связанные с PR, используют ваш локальный вход в GitHub CLI.
Что такое poteto-mode?poteto-mode — это маршрутизатор, которому вы сообщаете свою цель; он затем вызывает нужный плейбук pstack (исправление бага, фича, рефакторинг, планирование и т.д.) для задачи.
Что добавляет отдельный плагин agent-formal-verify?Он берёт на себя баги конкурентности и инварианты, до которых тестам не добраться, добавляя проверку моделей TLA+ и доказательства Lean поверх процессов pstack.
Как pstack подходит к типовому исправлению бага?Он воспроизводит сбой, разбирается, как и почему тот возникает, делегирует исправление и повторно запускает падающий кейс; если исправление пересекает границу функции, сначала привлекается роль архитектора, а в конце вы получаете исправление вместе с доказательствами того, что кейс падал и что теперь проходит.
Для чего нужен tools/forks.json?pstack следит за апстрим-набором навыков Cursor и одновременно содержит именованные ответвления политик, каждое из которых объявлено в tools/forks.json, чтобы можно было применять альтернативные наборы поведения.
Size
6.7 MB
Stars
2.8K
Age
4mo
Commits · 90 Days