
Claude Code 플러그인 큐레이션 시리즈 · 3편 Superpowers
이 글에서 다루는 내용
Superpowers는 obra가 만들고 Anthropic 공식 마켓플레이스에 등재된 Claude Code 플러그인입니다. 다른 플러그인들이 명령이나 에이전트를 더하는 데 집중한다면 Superpowers는 한 단계 다르게 들어갑니다. 일하는 방식 자체 - TDD, 시스템 디버깅, 서브에이전트를 동원한 코드 리뷰 - 를 14개 스킬 묶음으로 강제합니다. 이 글은 설치 명령, 14 스킬 중 핵심 5종, 실전 활용 시나리오, 다른 시리즈 회차와의 차이까지 정리합니다. 라이선스는 오픈소스이고 기준 시점은 2026년 4월입니다.
1. Superpowers의 자리
공식 README는 Superpowers를 다음과 같이 소개합니다.
"An agentic skills framework & software development methodology that works."
핵심은 두 단어 - "skills framework"와 "methodology"입니다. 도구를 늘리는 게 아니라 방법론을 코드로 박아 두는 도구라는 뜻입니다. 사용자가 "이 컴포넌트 만들어 줘"라고만 했을 때, Superpowers가 깔려 있는 환경에선 Claude가 먼저 brainstorming 스킬을 발동시켜 설계 단계를 검증받고, 그다음 git worktree를 이용해 격리된 브랜치에서 작업을 시작합니다. 사람이 매번 "먼저 설계부터 보여 줘"를 입력하지 않아도 됩니다.
2. 설치
2-1. 공식 마켓플레이스에서 설치
Superpowers는 Anthropic 공식 플러그인 마켓플레이스에 등록되어 있어 한 줄로 설치됩니다.
/plugin install superpowers@claude-plugins-official
"공식 마켓플레이스" 자체는 기본 등록되어 있어 /plugin marketplace add 단계가 필요 없습니다. 1편 OMC, 2편 ECC와 비교했을 때 가장 간단한 설치 흐름입니다.
2-2. 직접 마켓플레이스 등록도 가능
실험판 스킬까지 보고 싶다면 obra의 마켓플레이스를 직접 등록해 설치할 수도 있습니다.
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
ℹ️ 운영용으로 안정적인 흐름을 원한다면 첫 번째 명령(공식 마켓플레이스)만 쓰는 편이 안전합니다. 두 번째 경로는 실험적 스킬 풀을 함께 보고 싶을 때만 선택합니다.
3. 14개 스킬 중 가장 자주 쓰이는 다섯
14개 전부를 외울 필요는 없습니다. 자동으로 트리거되는 구조라 사용자는 작업 요청만 하면 됩니다. 다만 어떤 스킬이 깔리는지를 알아 두면 결과를 해석하는 데 도움이 됩니다.
| 스킬 | 언제 발동되는가 | 하는 일 |
|---|---|---|
brainstorming |
코드 작성 직전 | 아이디어를 구체화해 설계안을 섹션별로 보여 주고 사용자 승인을 받는다 |
using-git-worktrees |
설계 승인 후 | 새 브랜치에 격리된 작업 공간을 만들고, 시작 전 테스트가 클린한지 확인 |
tdd |
구현 단계 | 테스트를 먼저 작성하고 실패를 확인한 뒤 구현, 통과까지 반복 |
systematic-debugging |
버그 추적 시 | 증상→가설→실험 사이클을 명시적으로 돌리고 매 단계의 증거를 기록 |
dispatching-parallel-agents |
큰 작업을 쪼갤 때 | 서브에이전트를 병렬로 띄워 코드 리뷰까지 한 번에 처리 |
나머지 9개 스킬도 비슷한 결입니다. 새 스킬을 직접 만드는 메타 스킬도 포함되어 있어, 본인의 반복 패턴이 보이면 그걸 그대로 스킬화해서 추가할 수 있습니다.
4. 활용 시나리오 세 가지
4-1. 새 기능을 "TDD로" 한 사이클
요청을 짧게 던져도 Superpowers가 brainstorming → using-git-worktrees → tdd 흐름을 자동으로 깔아 줍니다.
> 사용자 비밀번호 재설정 흐름을 추가해 줘. 설계 먼저 검토받고, TDD로 구현해 줘.
brainstorming 단계에서 사용자에게 한 번 멈춰 묻는 흐름이 들어가 있어, 큰 방향이 어긋나는 사고를 줄여 줍니다.
4-2. 디버깅 - "왜 깨지는지 모르겠다"
증상만 던지고 systematic-debugging 흐름에 맡깁니다.
> CI에서만 결제 모듈 단위 테스트가 가끔 실패한다. 로컬에선 재현 안 됨. systematic-debugging으로 가설부터 정리하고 증거를 모아 줘.
4-3. 큰 리팩터를 병렬로
여러 모듈을 동시에 손대야 하는 상황이라면 dispatching-parallel-agents를 명시적으로 호출합니다.
> 결제·구독·환불 모듈을 한 번에 새 SDK로 교체해 줘. dispatching-parallel-agents 스킬로 모듈별 작업을 분배하고 각각 코드 리뷰까지 끝낸 뒤 통합 보고해 줘.
5. OMC·ECC와의 차이
| 관점 | OMC | ECC | Superpowers |
|---|---|---|---|
| 지향점 | 학습 곡선 제거 | 하네스 성능 최적화 | 방법론 강제 |
| 규모 | 29 에이전트 | 30 에이전트 + 135 스킬 | 14 스킬 (집약적) |
| 잘 맞는 사용처 | 사이드 프로젝트 | 사내 도구·운영 진입 | "진지한" 코드베이스, 테스트 문화 정착 |
Superpowers는 14개라는 작아 보이는 수가 오히려 강점입니다. 각 스킬이 한 가지 책임만 잘 수행하도록 설계되어 있어, 동작이 예측 가능합니다.
트러블슈팅
문제 1: 스킬이 자동으로 트리거되지 않는다
스킬은 모델이 "필요하다"고 판단해야 발동되는 구조라, 프롬프트가 짧고 모호하면 발동이 늦거나 누락될 수 있습니다. 다음처럼 호출을 명시하면 거의 해결됩니다.
brainstorming 스킬로 먼저 설계를 검토받고, 승인 후 tdd 스킬로 구현해 줘.
문제 2: OMC·ECC와 함께 깔았더니 동작이 어긋난다
같은 작업 흐름 영역에 한 번에 두 플러그인을 두면 hook이 겹쳐 같은 단계가 두 번 처리될 수 있습니다. 한 환경에선 한 가지 강화 플러그인만 메인으로 두는 쪽이 안전합니다. 시리즈 인덱스 글의 "함께 쓸 때 주의 사항" 섹션과 같은 원칙입니다.
문제 3: TDD가 너무 느리다
tdd 스킬은 테스트를 먼저 쓰고 실패를 확인한 뒤 구현하는 사이클을 강제하므로 단발 작업보다 느립니다. 빠르게 가설만 시험하고 싶은 단계라면 명시적으로 "tdd 스킬은 건너뛰고" 한 줄을 붙입니다.
문제 4: dispatching-parallel-agents가 도중에 멈춘다
병렬 서브에이전트는 일일 토큰 한도나 rate limit에 먼저 닿습니다. 같은 작업을 단계별로 쪼개 보내거나, 모델 라우팅을 점검합니다(OpenRouter 연결이 도움이 됩니다).
마무리
Superpowers의 의의는 새 기능이 아니라 일하는 방식을 코드로 박아 두는 것에 있습니다. brainstorming → 설계 승인 → 격리 브랜치 → TDD → 코드 리뷰의 흐름은 좋은 엔지니어링 팀이 이미 알고 있는 방법론이지만, 이걸 매번 사람이 챙기는 건 피곤한 일입니다. Superpowers를 깐다는 건 그 챙김을 도구가 대신해 주게 만든다는 것입니다.
다음 편에서는 같은 "작업 방법론" 카테고리에서 결이 다른 도구, Ralph Loop를 다룹니다. Superpowers가 한 사이클을 깔끔하게 만든다면, Ralph Loop는 "완료될 때까지 도는 자동 반복"으로 다른 가치를 잡는 도구입니다.
- Superpowers GitHub: github.com/obra/superpowers
- Anthropic 공식 플러그인 페이지: claude.com/plugins/superpowers
- 이전 편: 2편 ECC
- 다음 편: 4편 Ralph Loop
- 시리즈 인덱스: Claude Code 플러그인 큐레이션 시리즈
'AI & LLM' 카테고리의 다른 글
| Claude-Mem - 세션이 닫혀도 컨텍스트가 끊기지 않게 만드는 메모리 플러그인 (0) | 2026.05.04 |
|---|---|
| Ralph Loop - Claude Code가 완료될 때까지 자동으로 도는 루프 (0) | 2026.05.03 |
| ECC(Everything Claude Code) - 30 에이전트와 보안 스캐너까지 한 번에 (0) | 2026.05.02 |
| OMC(oh-my-claudecode) - Claude Code를 자연어로 다루는 다중 에이전트 플러그인 (0) | 2026.05.01 |
| Claude Code 플러그인 큐레이션 시리즈 - 카테고리별로 정리한 6가지 필수템 (0) | 2026.05.01 |