요즘 자꾸 뜨는 pstack 어설프게 말고 제대로 파헤쳐 보기

한 줄 핵심

pstack은 단순한 유행성 스킬 묶음이 아니라, Claude Code에서 코딩 장인의 작업 습관과 검증 절차를 강제하는 SKILL.md 기반 하네스이며, 특히 검증 스킬이 실전 품질을 좌우한다.

시간별 요약

1. 0:00
   오프닝 최근 자주 언급되는 pstack이 정확히 무엇인지, 무엇을 위해 쓰는지, 그리고 왜 본질을 봐야 하는지를 끝까지 파헤치겠다는 문제의식이 제시된다.
2. 0:26
   Lauren Tan(@poteto)은 누구인가 Lauren Tan은 Meta, Netflix, Cursor를 거친 뒤 SpaceX AI 팀에서 일하는 인물로 소개되며, 공개한 스킬이 Cursor에서 많이 쓰이고 실제 서비스 배포에도 활용된다는 점이 화제가 된다.
3. 1:29
   pstack, 또 유행인가? 처음에는 또 하나의 스택 유행처럼 보이지만, 내부를 보면 에이전틱 엔지니어링과 하네스의 규칙이 촘촘하게 들어 있어 단순한 유행으로 치부하기 어렵다.
4. 2:41
   먼저 gstack: 회사를 흉내 내는 스킬 gstack은 AI에게 CEO, 엔지니어링 매니저, 디자이너, QA 리드, 보안 책임자 같은 페르소나를 씌워 회사 구조를 흉내 내는 방식이며, pstack은 이를 비틀되 더 실전적인 방향으로 확장한 것으로 비교된다.
5. 4:33
   pstack의 본질: 결국 SKILL.md pstack의 본질은 모델을 바꾸는 기능이 아니라 SKILL.md들로 구성된 작업 매뉴얼이며, 로렌 Tan의 일하는 습관을 AI가 따라 하도록 길을 잡아 주는 안내서라는 점이 강조된다.
6. 6:05
   원래는 Grok용이었다 pstack은 원래 Cursor와 Grok 중심으로 설계됐지만, 현재는 Claude Code 설치 경로도 추가되었고, 역할별로 다른 모델을 지정해 쓰는 구조가 기본 전제임이 설명된다.
7. 6:45
   Claude Code에 설치하고 설정하기 Claude Code에서는 pstack 관련 명령을 붙여 설치하고, 코드 작성·판단·리뷰 역할별 모델을 지정해 설정하며, 설정값은 pstack 모델 MD에 저장되어 새 세션에서 자동으로 읽힌다.
8. 7:46
   실전: 투두앱으로 0~7단계 pstack은 처음부터 앱을 만들어 주는 도구가 아니라, 이미 돌아가는 앱을 1에서 n으로 키우고 고치고 다듬는 데 쓰는 도구라는 성격이 실제 투두앱 예제로 제시된다.
9. 8:18
   1단계 디자인 정하기 (프로토타입) 초기 시안 단계에서는 실제 소스와 분리된 임시 폴더에 HTML로 빠르게 만들어 비교하고, 테스트는 하지 않으며, 목적이 결정인 만큼 코드 품질보다 빠른 검증을 우선한다.
10. 9:33
    2단계 검증 스킬부터 만들기 기능 추가보다 먼저 create-verification-skill을 만들어 AI가 앱을 직접 띄우고 눌러 보고 증거를 남기게 해야 하며, 이것이 없으면 빌드 성공에서 멈추기 쉽다.
11. 10:04
    3단계 기능 추가 (기능) 기능 추가 시에는 상태를 참거짓 여러 개로 흩뿌리기보다 구조로 표현하고, 병렬 작업이 가능한지 판단한 뒤 검증 스킬로 브라우저에서 실제 동작과 스크린샷까지 확인하며 PR을 정리한다.
12. 11:27
    4단계 버그 수정 (버그 수정) 버그 수정은 먼저 직접 재현하고, 저장 문제인지 읽기 문제인지 가설을 좁혀 원인을 특정한 뒤 딱 한 군데만 고치며, 추측성 방어 코드를 덧붙이지 않는 것이 핵심이다.
13. 12:51
    5단계 구조 정리 (리팩토링) 리팩토링은 동작을 바꾸지 않은 채 구조를 정리하는 일이며, 불필요한 코드를 먼저 덜어내고 작은 단위로 옮기면서 테스트가 유지되는지 확인해 읽기 쉬워졌는지를 최종 기준으로 삼는다.
14. 13:31
    6단계 스킬 하나만 꺼내 쓰기 전체 플레이북을 돌리지 않아도 blast radius처럼 영향 범위를 좁혀 보는 식으로 필요한 스킬만 꺼내 쓸 수 있으며, 작은 변경이 어디까지 영향을 주는지 실제 코드로 증명한다.
15. 13:48
    7단계 자는 동안 맡기기 밤새 맡기는 모드에서는 태그 기능과 검색 기능처럼 독립적인 작업을 서브 에이전트에게 분담하고, 결정 기록을 남기며, 되돌릴 수 없는 일만 멈추는 식으로 자율 실행의 경계를 둔다.
16. 14:25
    pstack을 쓰지 말아야 할 때 버튼 색 하나 바꾸는 수준의 단순 작업이나 개인의 작은 작업에는 과도하게 느릴 수 있고, 엄격한 검증이 필요한 프로덕션 성격의 팀 작업이나 큰 코드베이스에서 더 효과적이다.
17. 15:23
    pstack의 작동원리: poteto-mode 해부 poteto-mode는 긴 MD 파일 속 라우터, 규칙, 답변 규칙으로 구성되며, 요청을 23개 플레이북 중 하나로 분기하고 모든 주장에 측정·추론·추측을 구분하게 만들어 AI의 즉흥적 추측을 억제한다.
18. 18:15
    정직하게 덧붙일 점 모델이 좋아질수록 pstack의 차별점은 줄 수 있고, 검증을 강제하는 대신 시간이 더 들 수도 있으며, 많은 규칙은 코드 강제보다 문장 수준의 가이드라는 한계가 함께 언급된다.
19. 19:14
    이건 꼭 쓰세요: create-verification-skill 검증 스킬은 앱을 어떻게 켜고 어떻게 눌러 보고 무엇을 캡처할지 AI가 직접 문서화하고 실행하게 만드는 가장 중요한 스킬이며, 실제 실행과 증거 수집이 있어야 결과물로 인정된다고 본다.
20. 21:14
    pstack에 숨은 하네스의 규칙 AI를 통제하는 규칙은 코드베이스, 린트, 리뷰봇, 스킬, 스타일 가이드처럼 강한 층에 둘수록 효과가 크며, 코드에 보이는 나쁜 패턴을 아예 못 쓰게 만드는 것이 핵심이다.
21. 22:52
    자동화는 맨 마지막에 슬랙 연동으로 버그를 자동 수정하게 하는 식의 자동화는 멋져 보여도 저장소가 성숙하기 전에는 슬롭 PR을 증폭시킬 수 있으므로, 가장 마지막에 붙여야 한다.
22. 23:17
    정리 pstack은 결국 장인의 작업 습관을 담은 스킬 MD 묶음이며, 핵심은 검증 스킬로 실제로 고쳤다는 증거를 남기게 만드는 데 있고, 원리를 이해하면 자신만의 하네스를 만들 수 있다는 결론으로 마무리된다.

실무 인사이트

• 검증을 코드 품질의 부가 요소가 아니라 작업 완료 조건으로 바꾸면, AI가 만든 결과물의 신뢰도가 눈에 띄게 올라간다.
• 작업 지시를 역할 중심이 아니라 과업 유형 중심으로 구조화하면, 같은 모델이라도 더 일관된 행동을 유도할 수 있다.
• 가장 강력한 AI 통제는 프롬프트 한 줄보다 코드베이스·린트·규칙 파일처럼 더 아래층에 나쁜 패턴을 못 쓰게 박아 두는 것이다.