워크플로우 추천도 ★★★★★ 심화·선택

Superpowers

계획·검증을 자동으로 씌우는 방법론

Jesse Vincent(obra)가 만든 스킬 묶음 + 작업 방법론. 설치하면 클로드 코드가 "코드부터 짜지" 않고 브레인스토밍 → 계획 → TDD → 리뷰의 규율 있는 흐름을 (거의) 자동으로 따릅니다.

🎯 이 장에서 배우는 것
Superpowers의 작동 원리·설치·사용법과, 언제 쓰고 언제 피해야 하는지.

한눈에

무엇인가

규율 있는 개발 워크플로우를 자동으로 유도하는 스킬 프레임워크

핵심 원리

세션 시작 시 <2k 토큰짜리 지침만 주입 → 필요할 때 각 스킬을 불러옴

설치 난이도

쉬움 (단, Windows는 Git Bash 필요)

사용자 추천도 (참고)

★★★★★ — 비트리비얼 작업에 특히 유용

만든이 · 라이선스

Jesse Vincent (obra) · MIT · v6.1.1(조사시점)

지원 호스트

Claude Code, Cursor, Copilot, Codex, Kimi, Pi 등

작동 원리 (자세히)

"무거운 규칙을 항상 물고 있는" 방식이 아니라, 얇은 안내문 하나만 항상 주입하고 실제 스킬은 필요할 때 꺼내 쓰는 구조라 토큰 낭비가 적습니다.

① 얇은 부트스트랩

세션 시작 때 using-superpowers 안내문(2k 토큰 미만)만 주입.

② 세션시작 훅

SessionStart 훅이 새 대화·/clear·압축 시 자동 실행되어 규칙을 심음.

③ 필요할 때 로딩

작업 성격에 맞는 스킬을 그때그때 불러와 적용.

자동으로 도는 작업 흐름
  1. 1
    브레인스토밍 — 코딩 전에 질문으로 요구사항을 명확히.
  2. 2
    작업공간 분리(git worktree) — 안전한 별도 작업 공간 마련.
  3. 3
    계획 작성 — 2~5분 단위의 작은 작업 + 검증 단계로 쪼갬.
  4. 4
    서브에이전트 구현(SDD) — 작업마다 별도 에이전트로 처리해 맥락을 깔끔히.
  5. 5
    테스트 우선(TDD) — 실패 테스트 먼저 → 통과 → 정리.
  6. 6
    코드 리뷰 요청 — "끝"이라 하기 전 근거로 검증.
  7. 7
    브랜치 마무리 — 병합/PR/정리 옵션 제시.

그 밖에 체계적 디버깅·완료 전 검증·병렬 에이전트·스킬 작성 등 총 14개 스킬이 서로 맞물립니다.

▸ 중요한 원칙: 사용자 지시가 스킬보다 우선합니다. "브레인스토밍 건너뛰고 바로 짜줘"라고 하면 그대로 따릅니다.

설치

방법 A — 공식 마켓(가장 간단)

Claude Code
/plugin install superpowers@claude-plugins-official

방법 B — obra 마켓 등록 후 설치

Claude Code
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
⚠️ 전제조건 · Windows 주의: gitbash 환경(Windows는 Git Bash)이 필요합니다. 세션시작 훅이 셸 스크립트라, Windows에서 bash.exe가 PATH에 없으면 훅이 멈추는 사례가 보고돼 있습니다(이슈 #414·#419·#420). 설치편에서 Git for Windows를 설치했다면 대개 문제없습니다.

사용법

대부분 자동

설치 후엔 평소처럼 요청만 하면 스킬이 알아서 발동합니다. 외울 명령이 없습니다.

의도로 조종

"X를 만들자"→브레인스토밍, "버그가 있어"→체계적 디버깅이 켜집니다.

필요하면 끄기

사용자 지시가 우선이라, 특정 단계를 건너뛰라고 하면 됩니다.

※ 전용 슬래시 명령은 없습니다(스킬+훅으로 구동). 설치된 스킬은 /plugin으로 확인·관리합니다.

예시

신기능 요청
> OAuth 로그인 기능을 추가하고 싶어
[자동] 코드부터 짜지 않고 먼저 질문 — 어떤 제공자? 세션은?
       → 계획 작성 → 작업별 구현·테스트 → 리뷰
버그
> 이 테스트가 가끔 실패해
[자동] 증상만 덮지 않고 근본 원인을 역추적 → 재현 → 실패 테스트 먼저

※ 대규모 구현은 서브에이전트를 많이 써서 토큰·비용이 커질 수 있습니다(한 사례 약 10만 토큰 규모).

장점 · 단점

👍 장점

요구사항 확인·계획을 강제 → 엉뚱한 방향 감소. 진짜 TDD·근거 검증. 토큰 효율(얇은 부트스트랩). 여러 호스트 지원. MIT·활발한 관리.

👎 단점

작은 작업엔 절차가 과함. 서브에이전트로 비용↑ 가능. Windows 훅 취약(bash 필요). 정해진 방법론이라 다른 워크플로우와 충돌 가능. 강제가 아닌 "강한 지침"이라 모델이 안 지킬 수도.

when

언제 쓰고, 언제 피하나

쓰기 좋을 때: 여러 단계가 필요한 비트리비얼 작업, 계획·검증을 규율 있게 하고 싶을 때.
피하거나 줄일 때: 한 줄 수정·일회성 스크립트, 토큰/비용이 빡빡할 때, Git Bash 준비가 안 된 Windows 환경.