Claude Code Superpowers 플러그인 완벽 정리. Jesse Vincent의 14개 핵심 스킬로 brainstorm·plan·TDD·debugging을 강제. 설치 두 줄·워크플로·실전 활용·다른 플러그인 비교까지.
Claude Code를 한 달쯤 써본 분이라면 한 번은 "이놈이 또 테스트 안 쓰고 코드부터 갈겼네" 또는 "같은 설명을 세 번째 하고 있다" 같은 답답함을 겪어보셨을 거예요. 모델은 똑똑한데, 혼자 두면 시니어가 아니라 의욕 넘치는 주니어 가 되어 일을 그르치는 순간이 종종 옵니다.
오늘은 그 답답함을 시스템 차원에서 해결하는 플러그인 — Superpowers(슈퍼파워즈) 를 정리합니다. Jesse Vincent(@obra)가 만든 오픈소스 스킬 프레임워크로, 2025년 10월 출시 후 GitHub 53,000 stars, 공식 마켓플레이스 5만 회 이상 설치된, 현재 Claude Code에서 가장 널리 쓰이는 플러그인이에요. 작성 시점(2026-05-15) 기준 최신 버전 4.3.0, MIT 라이선스 완전 무료.
1. Superpowers가 뭔가 — 한 줄 정의
Superpowers — Claude Code(및 Codex·Gemini CLI·Cursor 등)에 "시니어 개발 방법론" 을 강제 주입하는 스킬 프레임워크. 14개 핵심 스킬과 SessionStart 훅으로 구성되어 있고, 한 번 설치하면 모든 세션에 자동으로 "브레인스토밍 → 계획 → TDD 실행 → 코드 리뷰" 흐름을 박아넣습니다.
핵심 차이를 한 줄로 — "AI에게 좋은 설계 방법을 매번 말로 설명하던 작업을, 마크다운 한 묶음으로 한 번에 끝낸다". 스킬은 모두 텍스트 파일(SKILL.md)이라 누구나 읽고 수정할 수 있어요.
2. 왜 만들어졌나 — Claude Code의 빈 자리
Claude Code는 강력하지만, 방법론은 본인이 직접 박아 넣어야 합니다. 다음 패턴이 익숙하시면 Superpowers의 가치가 손에 들어옵니다.
- "테스트 먼저 쓰라고 했는데, 또 구현 코드부터 갈긴다"
- "기능 큰 거 하나 만들다가 컨텍스트 윈도가 터진다"
- "버그를 고친다더니 또 다른 곳을 망가뜨린다"
- "같은 컨벤션·코딩 스타일을 매 세션 처음부터 설명해야 한다"
- "기능 설명만 던졌더니 바로 코드부터 시작해서 설계 단계를 건너뛴다"
Superpowers는 이 문제들을 스킬 한 묶음 + 강제 게이트(hard gate) 로 푸는 방식이에요. "테스트 없이 구현 코드를 작성하면 그 코드를 삭제하고 처음부터 다시 시작한다" 같은 규칙을 스킬 자체에 박아 넣어, 모델이 "이번 한 번만…" 으로 빠져나가지 못하게 합니다.
3. 설치 — Claude Code 두 줄
설치는 Claude Code 2.0.13 이상에서 두 줄이면 끝입니다.
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
또는 Anthropic 공식 마켓플레이스(2026-01-15 등재)에서도 가능 — 별도 마켓플레이스 등록 없이 한 줄:
/plugin install superpowers@claude-plugins-official
설치 후 Claude Code를 재시작하고 /help 를 치면 새로 들어온 슬래시 명령어 3개가 보입니다:
/superpowers:brainstorm— 디자인 브레인스토밍 시작/superpowers:write-plan— 구현 계획 작성/superpowers:execute-plan— 계획 실행
설정은 따로 없어요. SessionStart 훅 이 매 세션 시작 시 자동으로 using-superpowers 메타 스킬을 컨텍스트에 주입합니다.
다른 도구에도 설치 가능 — Codex CLI, Codex App, Factory Droid, Gemini CLI, OpenCode, Cursor, GitHub Copilot CLI까지 지원. 단, 각 도구에 따로 설치해야 합니다 (Codex 쓰면 Codex에도, Cursor 쓰면 Cursor에도).
4. 기본 워크플로 — brainstorm → plan → execute
Superpowers의 철학은 단순해요. 큰 기능은 세 단계로 잘라 진행한다 — 브레인스토밍 → 계획 → 실행. 각 단계마다 별도 스킬이 발동하고, 단계를 건너뛰려 하면 하드 게이트 가 막습니다.
4-1. Brainstorming — 소크라테스식 설계 정제
기능 아이디어를 던지면 코드부터 짜는 게 아니라 클로드가 거꾸로 질문을 합니다:
- "이 기능을 사용하는 사용자는 누구인가요?"
- "실패하면 어떻게 처리해야 하나요?"
- "이미 비슷한 기능이 코드베이스에 있나요?"
질문을 통해 요구사항을 한 덩어리씩 정리한 뒤, 설계안을 짧은 단락으로 나눠 한 단락씩 검토받습니다. 사용자가 "이 부분은 이렇게" 라고 한 줄 수정하면 그 다음 단락으로 넘어가는 식.
버전 4.3.0에서 하드 게이트 가 추가되어, 설계 승인 전에는 구현 코드 한 줄도 못 짜게 막힙니다. "이 정도는 그냥 짜도 되겠지" 라며 빠져나가던 통로가 막혔어요.
4-2. Writing Plans — 2~5분 단위로 작업 쪼개기
설계가 확정되면 2~5분 안에 끝낼 수 있는 단위 작업으로 쪼갠 계획 문서 가 생성됩니다. 각 작업에는:
- 정확한 파일 경로
- 작성할 코드 또는 변경 diff
- 검증 방법 (어떤 테스트를 어떻게 통과시켜야 하는가)
- 수락 조건
이렇게 작성되어, "context-poor한 주니어 엔지니어도 따라갈 수 있을 정도로 명확한" 수준이 목표예요. 사람이 검토 후 "go" 를 하면 실행 단계로 넘어갑니다.
4-3. Subagent-Driven Execution — 작업당 신선한 서브에이전트
이게 Superpowers의 가장 큰 차별점입니다. 큰 기능을 하나의 대화 세션이 다 들고 있으면 컨텍스트가 터지지만, 각 작업을 신선한 서브에이전트에 넘기면 메인 세션은 계획·진행 상태·완료 보고 만 들고 있으면 됩니다.
흐름:
- 메인 세션이 작업 1을 서브에이전트에 위임 (계획·테스트 코드만 들고 시작)
- 서브에이전트가 RED-GREEN-REFACTOR로 작업 완수
- 메인 세션이 spec compliance + code quality 2단계 리뷰
- 통과하면 작업 2로, 실패하면 수정 후 재시도
- 작업 사이마다 진행 상태를 마크다운으로 디스크에 저장
큰 기능 하나에 2~3시간 자율 작동도 흔합니다. 사람은 옆에서 다른 일을 하다가 "음 이 부분은 이렇게 바꿔" 한 줄로 방향 수정할 수 있어요.
5. 14개 스킬 — 한 묶음 정리
Superpowers는 14개 핵심 스킬을 4개 카테고리로 묶어 제공합니다.
5-1. Testing
| 스킬 | 역할 |
|---|---|
| test-driven-development | RED-GREEN-REFACTOR 강제. "테스트 먼저" 가 "좋은 권고" 가 아니라 "강제 규칙" — 위반 시 코드 삭제 후 재시작 |
TDD 스킬에는 흥미로운 강제 항목이 박혀 있어요. "이번 한 번만", "너무 단순해서 테스트 안 해도 됨", "수동으로 이미 테스트했음" 같은 합리화를 명시적으로 차단합니다.
5-2. Debugging
| 스킬 | 역할 |
|---|---|
| systematic-debugging | 4단계 근본 원인 추적 — 증상 관찰 → 가설 → 검증 → 해결 |
| verification-before-completion | "고쳤다" 선언 전 실제 검증 강제 |
systematic-debugging은 "증상 가린 채 빠르게 패치하기" 대신 root-cause-tracing, defense-in-depth, condition-based-waiting 기법을 단계적으로 적용합니다.
5-3. Collaboration (작업 흐름)
| 스킬 | 역할 |
|---|---|
| brainstorming | 소크라테스식 설계 정제, 단락별 검토 |
| writing-plans | 2~5분 단위 구현 계획 작성 |
| executing-plans | 배치 실행 + 사람 체크포인트 |
| subagent-driven-development | 작업당 신선한 서브에이전트 + 2단계 리뷰 |
| dispatching-parallel-agents | 독립 작업 2개 이상을 병렬 서브에이전트로 |
| requesting-code-review | 코드 리뷰 요청 전 자가 체크리스트 |
| receiving-code-review | 리뷰 피드백 받을 때 기술적 엄밀함 유지 |
| using-git-worktrees | 격리 작업 공간(워크트리)에서 병렬 개발 |
| finishing-a-development-branch | 브랜치 완료 시 merge / PR / discard 결정 |
5-4. Meta
| 스킬 | 역할 |
|---|---|
| using-superpowers | 스킬 시스템 소개·작동 방식 |
| writing-skills | 사용자 본인 스킬 만들기 (커스터마이징) |
6. SessionStart 훅 — 어떻게 자동으로 작동하나
Superpowers의 마법은 대부분 SessionStart 훅 에 들어 있어요. Claude Code 세션이 시작·재개·clear·compact 될 때마다 자동으로 발동하는 셸 스크립트입니다.
훅의 작동:
using-superpowers메타 스킬 파일을 읽음- "이 1% 확률이라도 스킬이 적용되면 반드시 호출하라" 는 규칙(THE RULE)을 시스템 프롬프트에 주입
<system-reminder>태그로 래핑해 컨텍스트 맨 앞에 박음
그래서 어떤 작업을 시작하든 클로드가 먼저 "이 작업에 맞는 스킬이 있나" 부터 점검하게 됩니다. 사용자가 "brainstorm 해줘" 라고 명시적으로 부르지 않아도, 새 기능 요청만 던지면 brainstorming 스킬이 알아서 발동해요.
훅 동작 확인 — Claude Code에서 /clear 친 뒤 새 세션을 시작했을 때 "Superpowers 사용 중" 같은 컨텍스트 주입이 보이면 정상.
7. 실전 예시 — 큰 기능 한 번 끝까지
블로그에서 자주 인용되는 실제 사용 패턴 한 가지:
사용자: 사용자 로그인에 2단계 인증(2FA) 기능 추가해 줘
→ [brainstorming 자동 발동]
클로드: 몇 가지 확인할게요.
- TOTP(Google Authenticator 같은)와 SMS 중 어느 쪽?
- 백업 코드는 몇 개 발급?
- 기존 사용자에게는 강제 적용? 옵션?
...
사용자: TOTP만, 백업 코드 10개, 옵션 적용
→ [브레인스토밍 디자인 단락별 제시 → 사용자 승인]
→ [using-git-worktrees: 격리 브랜치 생성]
→ [writing-plans: 2~5분 단위 작업 15개로 분해]
→ [사용자 "go"]
→ [subagent-driven-development: 작업 1부터 순차 실행]
- 작업 1: 2fa_secret 테이블 마이그레이션 (TDD)
- 작업 2: TOTP 생성 함수 (테스트 먼저 → 구현 → 통과 확인 → 커밋)
- ...
- 각 작업 사이에 spec compliance + code quality 2단계 리뷰
→ [finishing-a-development-branch: 모든 테스트 통과 확인 → PR 생성 옵션 제시]
이 흐름이 2시간 정도 자율 진행됩니다. 사람은 처음 30분 브레인스토밍과 중간 한두 번 "이건 이렇게" 수정만 하면 돼요. 결과물은 — 테스트 커버리지 빵빵하고, 컨벤션 일관되고, 마이그레이션·롤백 모두 작동하는 PR 한 개.
8. 다른 플러그인과의 비교
Superpowers 외에도 비슷한 결의 플러그인이 있습니다. 가장 자주 비교되는 둘:
| 항목 | Superpowers | Compound Engineering |
|---|---|---|
| 제작자 | Jesse Vincent (@obra) | Compound Eng 팀 |
| 스킬 수 | 14개 (집중) | 36개 + 50 에이전트 |
| 라이선스 | MIT (오픈소스) | MIT (오픈소스) |
| 강조점 | 시니어 개발 방법론·강제 게이트 | "각 사이클이 다음 사이클을 더 싸게 만든다" — 누적 학습 |
| GitHub stars | ~53,000 | (Superpowers의 약 30%) |
| 진입 난이도 | 두 줄 설치 | 두 줄 설치 |
| 적합 작업 | 중·대형 기능 | 모든 크기, 특히 반복형 |
쉽게 정리하면 — 빠르게 깊게 들어가는 게 Superpowers, 천천히 누적되는 게 Compound Engineering. 둘 다 설치해 보고 본인 워크플로에 맞는 쪽으로 가도 됩니다. 충돌 없이 공존 가능해요.
기본 Claude Code 내장 스킬(/simplify, /batch, /debug 등)과도 차이가 있습니다 — 내장은 한 번에 하나씩 호출하는 단발 도구라면, Superpowers는 워크플로 전체를 강제하는 프레임워크예요.
9. 언제 켜고 언제 끄나 — 짚어야 할 트레이드오프
만능 도구가 아닙니다. 다음 두 가지는 분명히 짚고 가야 해요.
켜는 게 좋은 경우
- 중·대형 기능 개발 — 다파일 변경·새 모듈·기능 한 묶음
- 테스트 커버리지가 중요한 코드 — 프로덕션 비즈니스 로직
- 자율 작동 시간이 필요한 작업 — 회의 들어가 있어도 코드가 알아서 진행되길 원할 때
- 여러 사람이 함께 보는 코드 — 일관된 컨벤션·리뷰가 필요한 팀 작업
끄는 게 나은 경우
- 5분짜리 작은 수정 — 오타 고치기, 한 줄 변경 — brainstorm·plan 단계가 오버헤드
- 탐색적·실험적 코드 — 디자인 단계가 아직 안 잡혔는데 일단 돌려보는 단계
- 이미 명확한 일회성 스크립트 — "이 CSV 파싱해서 그래프 그려 줘" 같은 단발성 작업
블로그·리뷰에서 공통적으로 보이는 평 — "작은 작업에는 과잉, 큰 작업에는 게임체인저". 둘 다 인정하고 선택적으로 켜는 게 정답이에요.
일시 비활성화 방법 — /plugin disable superpowers 한 줄로 끄고, 다시 켤 때 /plugin enable superpowers. 또는 특정 세션만 끄려면 "이번 세션은 Superpowers 건너뛰고 그냥 갈게" 라고 명시하면 됩니다 (단, 훅이 다음 세션에 다시 발동).
10. 같은 마켓플레이스의 다른 플러그인 3종
Jesse Vincent의 obra/superpowers-marketplace 에는 Superpowers 외에 세 가지 플러그인이 더 있어요. 같은 흐름으로 함께 쓸 만합니다.
- Elements of Style — 1918년 Strunk Jr.의 영어 글쓰기 18원칙 을 스킬로. 영문 README·문서 작성 시 톤 잡기에 좋음
- Superpowers: Developing for Claude Code — Claude Code 플러그인·스킬·MCP 서버 직접 만들 때 참고용. Anthropic 공식 문서 42개 포함
- Private Journal MCP — 작업 일지를 의미 검색 가능한 형태로 로컬 저장. 프로젝트별·전역 분리
설치는 같은 마켓플레이스라 한 줄로:
/plugin install elements-of-style@superpowers-marketplace
/plugin install superpowers-developing-for-claude-code@superpowers-marketplace
/plugin install private-journal-mcp@superpowers-marketplace
11. 한 줄 정리
Superpowers = Claude Code에 시니어 개발 방법론을 강제하는 오픈소스 스킬 프레임워크. Jesse Vincent의 14개 스킬이 brainstorm → plan → TDD execute → review 흐름을 자동으로 박아 넣고, "테스트 없이 코드 짜기" 같은 우회로를 하드 게이트로 차단합니다.
설치는 두 줄, 가격은 무료(MIT), 적합 영역은 중·대형 기능 개발. 작은 수정엔 과잉이지만, 두 시간짜리 기능 작업에선 게임체인저. "AI에게 좋은 개발 방법을 매번 말로 설명하던 일" 이 마크다운 한 묶음으로 끝납니다.
Claude 사용법이 익숙해진 분이라면 — 다음 단계로 가장 권장하는 한 가지 가 Superpowers 설치예요. 두 줄 설치하고 다음 큰 기능 하나에서 "브레인스토밍 자동 발동" 한 번만 경험해 보면, 왜 5만 명이 깔았는지 가 손에 들어옵니다.
참고 자료
- obra/superpowers — GitHub 공식 리포지토리
- Superpowers Marketplace — 마켓플레이스 리포
- Anthropic 공식 플러그인 페이지
- 공식 설치 문서 — Claude Code 가이드
- Claude Code Docs — 플러그인 마켓플레이스 발견·설치
- ddewhurst — Superpowers Claude Code's workflow plugin
- Richard Porter — Superpowers로 큰 기능 출시한 후기
- Marc Nuri — Superpowers Skills Framework as Markdown
- andrew.ooo — Superpowers Review (53K stars)
- MindStudio — How to Use the Superpowers Plugin
본 글은 일반 정보 정리용이며, Superpowers 버전·기능은 빠르게 갱신됩니다. 최신 사양은 공식 GitHub 리포(obra/superpowers)와 RELEASE-NOTES에서 직접 확인하세요.