pstack-claude

pstack

Lauren Tan의 pstack은 에이전트 결과물을 개선하는 의견이 반영된 Cursor 스킬 스택입니다. 이는 Claude Code, Codex, Pi, GitHub Copilot, Muse 및 기타 에이전트 하네스를 위한 포트입니다. 업스트림을 추적하며, 각각 tools/forks.json 에 선언된 명명된 정책 포크도 함께 제공합니다.

poteto-mode에 목표를 알려주면 해당 작업에 맞는 올바른 워크플로를 호출합니다. 코드를 간결하고 단순하며 검증된 상태로 유지합니다.

테스트로 도달할 수 없는 동시성 버그와 불변식의 경우, /create-formal-verification-skill 이 코드에서 가장 위험한 속성을 선택하고, 적합한 도구로 검증한 뒤, 다음 에이전트가 다시 실행할 프로젝트 스킬을 남깁니다. 별도의 agent-formal-verify 플러그인은 안내된 TLA+ 모델 검사, Lean 증명, Rust용 Kani를 통해 방법론을 더 깊이 다룹니다.

Claude Code를 위해 제작됨
이 포트는 설치 전에 업스트림의 Cursor 스킬을 Claude Code용으로 변환합니다. 업스트림의 Claude Code 설치 방식은 에이전트에게 런타임에 Cursor 이름을 변환하도록 요청하여 추가 토큰을 사용하고, 매핑을 올바르게 적용하는 것을 에이전트에 의존합니다. 이 포트는 또한 작업을 poteto-mode로 라우팅하는 SessionStart 훅을 추가합니다.

설치

Claude Code
Claude Code 2.1.292 이상에서 실행하세요:

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

Claude Code는 타사 마켓플레이스에 대해 자동 업데이트를 꺼두므로, pstack은 설치한 버전에 머무릅니다. 켜려면 /plugin 을 실행하고 Marketplaces 탭을 열어 pstack-claude 를 선택한 뒤 Enable auto-update 를 선택하세요. 한 번 수동으로 업데이트하려면 claude plugin update pstack@pstack-claude 를 실행하세요.

Codex
터미널에서 실행하세요:

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

Pi
터미널에서 실행하세요:

pi install git:github.com/michael-denyer/pstack-claude
이 패키지는 스킬과 pstack Pi 확장을 로드하며, 확장은 스킬이 사용하는 subagent, question, wake-up 도구와 /loop 및 라우팅 지침을 추가합니다. 스킬은 /skill:<name> 으로 호출하세요.

GitHub Copilot
터미널에서 실행하세요:

copilot plugin marketplace add michael-denyer/pstack-claude
copilot plugin install pstack@pstack-claude
이는 ~/.copilot 을 공유하는 Copilot CLI와 GitHub Copilot 앱에 pstack을 설치합니다. 이후 새 세션을 시작하세요. Copilot은 기본 pstack 모델을 제공하지 않으므로, 모델이 필요한 첫 스킬이 setup-pstack 을 실행하여 계정에 나열된 모델 중에서 선택하고, 이후 세션은 그 선택을 재사용합니다.

Copilot 빌드는 Copilot CLI 1.0.87부터 1.0.92에서 테스트되었습니다. 해당 버전에서는 라우팅 훅의 컨텍스트가 다른 플러그인의 세션 시작 컨텍스트와 함께 세션에 도달합니다. 이후 버전에서 하나의 플러그인 컨텍스트만 유지하는 경우, setup-pstack 은 대신 ~/.copilot/copilot-instructions.md 에 대한 상시 지침을 제공합니다. 1.0.92에서는 CLI가 computer-use 실험 할당을 캐시한 후, copilot -p 세션은 플러그인 스킬을 나열하지 않고 스킬 호출은 "Skill not found"를 반환합니다. 대화형 세션, 훅, 에이전트는 영향을 받지 않습니다.

Muse
터미널에서 실행하세요:

git clone https://github.com/michael-denyer/pstack-claude
cd pstack-claude
muse plugins install ./plugins/pstack
muse plugins approve pstack
첫 번째 명령은 네이티브 Muse 플러그인 번들을 설치합니다. 두 번째 명령은 SessionStart 훅과 에이전트 정의를 승인하며, Muse는 승인 후에만 이를 실행합니다. 이후 새 세션을 시작하세요. 스킬은 /<name> (예: /poteto-mode )으로 호출하며, Muse는 각 사용자 호출 가능 스킬에 대해 이를 나열합니다.

기타 하네스
OpenCode(CLI 및 데스크톱 앱), Gemini CLI, Prime Agent, 스킬 전용 Codex 설치에서는 ~/.agents/skills/ 에서 스킬을 읽습니다. 터미널에서 실행하세요:

git clone https://github.com/michael-denyer/pstack-claude
cd pstack-claude
mkdir -p ~ /.agents/skills
for s in plugins/pstack/skills/ * / ; do
target= ~ /.agents/skills/ " $( basename " $s " ) "
test -e " $target " || test -L " $target " || ln -s " $( pwd ) / $s " " $target "
done
업데이트하려면 클론에서 git pull 을 실행한 뒤, 마지막 실행 이후 추가된 스킬을 링크하기 위해 for 루프를 다시 실행하세요. 이러한 설치에는 라우팅 훅이 없으므로 poteto-mode를 이름으로 요청하거나 하네스의 지침 파일에 상시 지침을 추가하세요. 하네스별 참고 사항과 제거 방법은 공유 설치를 참조하세요.

구성
pstack은 작업을 poteto-mode로 자동 라우팅합니다. 세션 시작 시 훅이 에이전트를 이를 가리키는 지침을 주입합니다: Claude Code, Codex, GitHub Copilot, Muse에서는 플러그인의 훅이, Pi에서는 pstack 확장이 담당합니다. Codex는 /hooks 를 통해 신뢰한 후에만 훅을 실행하고, Muse는 muse plugins approve pstack 이후에만 실행합니다. 다른 하네스에는 훅이 없습니다.

setup-pstack 을 실행하여 자동 라우팅을 켜거나 끄고, 모델 기본값을 변경하거나, 역할별 추론 노력을 설정하세요( arena runners: opus @xhigh, fable @max ).

시작하기
poteto-mode를 사용하여 페이지를 변경할 때 검색 필터가 초기화되는 문제를 수정하세요.

버그의 경우, 실패를 재현하고, how 와 why 를 사용하여 조사하고, 수정을 위임한 뒤, 실패한 케이스를 다시 실행합니다. 수정이 함수 경계를 넘는 경우, 구현 전에 architect 를 불러옵니다. 수정 사항과 실패 및 통과 증거를 받게 됩니다.

다른 플레이북은 계획, 기능, 리팩터링, 성능 문제, 조사, 프로토타입, PR 유지 관리, 배포, 장기 프로젝트를 다룹니다.

세부 정보

스킬 및 슬래시 명령
런타임 설정
모델 및 종속성
유지 관리 및 포트 범위

데이터 처리
pstack에는 서버나 텔레메트리가 없습니다. 세션 트랜스크립트를 포함하여 스킬이 에이전트에게 읽도록 요청하는 모든 것은 모델 제공자에게 전송됩니다. 스크립트는 로컬에서 실행되며, PR 도구는 GitHub CLI 로그인을 사용합니다.

기여
이 포트를 더 좋게 만드는 데 도움을 주셔서 감사합니다. 버그 보고, 문서 수정, 런타임 개선을 환영합니다. 검사 항목과 변경 사항이 속할 위치는 CONTRIBUTING.md 를 참조하세요. 취약점은 SECURITY.md 에 설명된 대로 비공개로 보고하세요.

이 포트의 유지 관리를 지원하려면 관리자에게 커피를 사주세요.

라이선스
이 포트는 수정 및 추가 사항을 포함하여 MIT 라이선스 이며, © 2026 Michael Denyer입니다. 원본 pstack © 2026 Lauren Tan; 가져온 cursor-team-kit 및 thermos 스킬 © 2026 Cursor. LICENSE-cursor-team-kit , LICENSE-thermos , NOTICE.md 를 참조하세요.