슈퍼파워즈(Superpowers)
AI 코딩 도우미가 바로 코드부터 쓰지 않고, 질문하고 계획하고 시험하고 확인하는 순서를 따르게 하는 스킬 모음입니다.
공식 저장소의 README, 이 Mac에 설치된 7.0.2 버전의 스킬·훅 파일, 소개 글과 영상 소개 페이지를 읽고 정리했습니다. 이 Mac에서는 플러그인 목록·상세·도움말 명령과, 계획 모드에서 할 일 목록 부탁 한 번을 실행했습니다(2026-11-16).
다섯 살에게 설명하면
로봇 친구에게 레고 성을 만들어 달라고 하면, 로봇은 바로 블록을 막 쌓아요. 그런데 내가 원한 건 분홍색 성이었어요!
슈퍼파워즈는 로봇에게 "먼저 물어봐"라고 가르쳐 주는 약속 카드예요.
그래서 로봇은 "무슨 색 성이 좋아?" 하고 먼저 묻고, 그림을 보여 주고, 한 층씩 쌓을 때마다 "이렇게 하는 거 맞아?" 하고 확인해요.
카드로 보기
옆으로 넘겨 보세요. 그림을 누르면 크게 보입니다.

읽기 전에
Claude Code는 Anthropic이 만든 AI 코딩 도구입니다. 글자로 명령을 입력하는 창(터미널)에서 AI와 대화하며 프로그램을 만듭니다. Claude Code를 처음 들으셨다면 → Claude Code 글
- 준비물: 컴퓨터, Claude 계정, Claude Code가 설치된 터미널. Claude Code를 쓸 수 있는 요금제와 요금은 결제 전에 Claude 공식 요금 페이지에서 확인하세요.
- 설치 명령은 한 줄입니다.
- 설치하면 이 도구가 내 컴퓨터의 파일을 읽고 고칠 수 있습니다.
쓰기 전과 후
부탁 하나로 비교합니다. "간단한 할 일 목록 웹페이지를 만들어 줘."
도구가 없으면 AI는 부탁을 듣자마자 만들기 시작합니다. 내가 원한 것을 짐작으로 채우고, 다 만든 뒤에야 보여 줍니다. 엉뚱하면 처음부터 다시 해야 합니다.
슈퍼파워즈를 쓰면 AI가 먼저 무엇을 왜 원하는지 묻습니다. 설계를 짧게 보여 주고 내 승인을 받은 뒤 일을 시작합니다. 느리지만 엇나갈 일이 줄어듭니다. 아래 그림의 두 칸 가운데 오른쪽이 슈퍼파워즈를 쓴 모습입니다. 두 칸의 모습은 공식 README가 설명하는 순서를 그린 것입니다.

설명을 위해 다시 그린 그림입니다.
한눈에 보기
| 질문 | 짧은 답 |
|---|---|
| 무엇인가요? | AI 코딩 도우미에게 일하는 순서를 가르치는 스킬(지시문) 모음입니다. |
| 믿을 만한가요? | 만든 사람은 Jesse Vincent(저장소 obra/superpowers)이고 Prime Radiant 팀이 함께합니다. 라이선스는 MIT(공개된 코드를 정해진 조건에서 자유롭게 쓰게 하는 조건)입니다. 별(GitHub에서 관심 표시를 한 사람 수)은 약 31.8만 개, 마지막 갱신은 2026-11-03입니다. 2026-11-16 조회. Anthropic 공식 플러그인 목록에도 올라 있습니다. 별이 많다고 안전이 보증되지는 않습니다. |
| 무엇이 달라지나요? | AI가 바로 코드를 쓰지 않고, 먼저 묻고, 계획을 세우고, 시험을 먼저 만들고, 끝나면 확인합니다. |
| 어디서 쓰나요? | Claude Code입니다. 공식 문서는 다른 AI 도구용 설치법도 안내합니다. |
| 직접 불러야 하나요? | 아닙니다. 해당하는 일이 생기면 AI가 알아서 불러옵니다. |
| 돈이 드나요? | 슈퍼파워즈 자체는 무료 오픈소스입니다. Claude Code 쪽 요금은 결제 전에 Claude 공식 요금 페이지를 확인하세요. |
이런 분께 맞아요 / 안 맞아요
맞는 분
- AI에게 프로그램 만들기를 맡겼다가 엉뚱한 결과를 받아 본 분.
- 한 번에 큰 일을 맡기고 싶은 분. 공식 README는 계획이 단단하면 AI가 몇 시간씩 혼자 일하는 일도 드물지 않다고 적습니다.
- 결과가 맞는지 증거를 보고 싶은 분.
안 맞는 분
- 한 줄 고치기나 일회용 작은 일만 하는 분. DataCamp 튜토리얼은 이런 일에는 과하다고 적었습니다.
- 처음에는 평소 Claude Code보다 느리게 느껴질 수 있습니다. 같은 튜토리얼에 나온 말입니다.
- 사용 정보가 밖으로 나가는 것이 싫은 분: 아래 "지우는 법과 내 자료가 저장되는 곳" 절을 보세요.
- 도구가 계속 바뀌는 점도 알아 두세요. 명령 이름이 바뀔 수 있으니 공식 저장소에서 확인하세요. 이 Mac의 캐시에는 7.0.0과 7.0.2가 함께 있었고 설치 기록은 7.0.2를 가리켰습니다 (직접 확인).
- AI가 하는 말에 낯선 기술 용어가 많을 수 있습니다. 모르는 말은 AI에게 쉽게 풀어 달라고 하면 됩니다.
바쁘신 분은 여기까지만 읽어도 이 도구가 무엇인지 아실 수 있습니다. 아래는 원리와 직접 써 볼 분을 위한 내용입니다.
어떻게 작동하나요
집을 짓는 일에 비유해 봅니다. 솜씨 좋은 목수는 벽돌부터 쌓지 않습니다. 먼저 어떤 집을 원하는지 묻습니다. 설계도를 보여 주고 "이대로 할까요" 하고 확인합니다. 그다음 일을 작게 나눈 순서표를 만들고, 한 칸씩 지어 가며 중간중간 점검합니다. 끝나면 문이 열리고 물이 나오는지 직접 확인합니다.
슈퍼파워즈는 AI에게 이 순서를 지키게 합니다.
스킬. 스킬(skill)은 AI가 읽고 따르는 지시문 한 묶음입니다. 파일 하나에 "이런 때는 이렇게 하라"가 적혀 있습니다. 슈퍼파워즈의 skills 폴더에는 스킬 15개가 들어 있습니다.
어떻게 시작되나요. 플러그인(기존 도구에 기능을 덧붙이는 부품)에는 훅(hook)이 들어 있습니다. 훅은 대화를 열 때 같은 때에 저절로 실행되는 작은 프로그램입니다. 설치된 hooks.json에는 대화를 시작하거나 비우거나 압축할 때 session-start가 실행된다고 적혀 있습니다. 이때 using-superpowers(시작 안내) 스킬이 전달됩니다. 이 스킬은 AI에게 "맞는 스킬이 있으면 일을 시작하기 전에 먼저 불러라"고 지시합니다. 그래서 사람이 따로 부르지 않아도 됩니다.
기본 순서. 공식 README가 설명하는 순서입니다. 각 단계의 스킬은 해당하는 때에 자동으로 실행됩니다.
| 순서 | 스킬 | 하는 일 |
|---|---|---|
| 1 | brainstorming(먼저 묻기) | 만들기 전에 무엇을 왜 원하는지 묻고, 이해한 내용을 되짚어 확인합니다. |
| 2 | using-git-worktrees(작업 공간 나누기) | 설계 승인 뒤, 본 작업과 분리된 작업 공간을 새 가지(branch, 코드 기록의 갈래)에 만듭니다. |
| 3 | writing-plans(계획 쓰기) | 일을 2~5분 크기의 작은 일로 나눈 계획서를 씁니다. |
| 4 | subagent-driven-development(보조 AI에게 맡기기) 또는 executing-plans(차례로 진행) | 작은 일마다 새 보조 AI(하위 에이전트)를 보내고 검토하거나, 한 대화 안에서 차례로 진행합니다. |
| 5 | test-driven-development(시험 먼저 쓰기) | 실패하는 시험을 먼저 쓰고, 통과할 만큼만 코드를 씁니다. |
| 6 | requesting-code-review(검토 요청) | 일 사이에 계획대로인지 검토하고 문제를 심각도별로 알립니다. |
| 7 | finishing-a-development-branch(마무리하기) | 시험을 확인하고 합치기, 검토 요청, 보관, 버리기 중 고르게 합니다. |
이 밖에 버그를 찾는 systematic-debugging(원인부터 찾기), 끝났다고 말하기 전에 확인하는 verification-before-completion(끝나기 전 확인)도 있습니다.
좋은 점
- 만들기 전에 묻습니다. 원하는 것을 먼저 맞춰 보므로 엉뚱한 것을 만들 위험이 줄어듭니다.
- 시험을 먼저 만듭니다.
test-driven-development스킬은 "실패하는 시험 없이는 제품 코드를 쓰지 않는다"를 규칙으로 둡니다. 시험이 실패하는 것을 직접 보라는 요구도 있습니다. - 버그를 추측으로 고치지 않습니다.
systematic-debugging은 원인을 찾기 전에는 고치지 말라는 규칙으로 시작하고, 원인 조사, 비슷한 사례 비교, 가설 시험, 고치기의 네 단계를 따릅니다. 고쳐도 세 번 실패하면 멈추고 구조부터 의심하게 합니다. - 끝났다는 말에 증거를 요구합니다.
verification-before-completion은 명령을 새로 실행해 출력을 읽기 전에는 "통과했다"고 말하지 못하게 합니다. - 사람이 따로 외울 것이 적습니다. 스킬이 자동으로 불려 옵니다.
사례
제작자 Jesse Vincent의 글. 제작자는 자기 블로그에서 사용 방식을 소개합니다. 글에 따르면 시작할 때 AI에게 스킬이 있다는 사실과 쓰는 방법을 알려 주는 지시문이 먼저 전달됩니다. 그는 새 스킬도 AI에게 원하는 행동을 말해 만들게 합니다. 스킬이 잘 지켜지는지는 급한 상황이나 이미 만든 코드를 버리기 아까운 상황 같은 시나리오에서 보조 AI로 시험했다고 합니다.
DataCamp 튜토리얼(Dario Radečić). 이 글은 brainstorming, 계획, 실행, 검토, 시험 먼저 쓰기, 디버깅(버그 찾기)을 차례로 보여 주고, 팀이 자기 규칙을 스킬로 만드는 방법도 다룹니다. 한계로는 학습 시간, 작은 일에 과함, 단계를 건너뛰면 약해짐, 명령이 바뀔 수 있음을 적었습니다.
한국어 영상. 위 영상은 "헤이제임스, 플랫폼 하나 만들어줘" 채널의 「Superpowers vs GSD vs gstack 비교, Claude 코딩 프레임워크 3종 선택 가이드」(2026-04-24)입니다. 영상 설명에 따르면 코드를 짜기 전에 순서를 지키게 하는 도구라는 점과 설치 명령을 다룹니다. 비슷한 도구 둘과 비교하는 영상이라, 그 둘은 이 글에서 다루지 않습니다.
직접 해 보기
직접 써 볼 분만 읽으셔도 됩니다. 명령은 한 번에 하나씩 입력합니다.
설치 방법
Claude Code 입력창에 아래 한 줄을 입력합니다. 마켓플레이스(플러그인을 모아 둔 곳)에 올라 있는 공식 버전입니다.
/plugin install superpowers@claude-plugins-official
- 이 명령은 공식 README에 적힌 명령입니다.
- 제작자의 마켓플레이스로 설치하는 다른 방법도 README에 있습니다. 한 가지만 하면 되므로 여기에는 적지 않습니다.
잘 됐을 때 보이는 화면
터미널에서 claude plugin list를 입력하면 설치된 플러그인이 나옵니다. 이 Mac에서 실제로 실행한 결과를 줄여서 다시 그렸습니다 (직접 확인).

설명을 위해 다시 그린 그림입니다.
대표 활용법
1. 새 기능을 부탁하기
설치 뒤에 새 대화를 열고, 만들고 싶은 것을 평소 말로 적습니다.
간단한 할 일 목록 웹페이지를 만들고 싶어요.
기대하는 모습은 AI가 코드를 쓰기 전에 무엇을 왜 원하는지 묻는 것입니다. brainstorming 스킬의 설명을 읽고 쓴 것입니다.
이 Mac에서 계획 모드(파일을 고치지 못하게 하는 모드)로 claude -p "간단한 할 일 목록 웹페이지를 만들고 싶어요."를 실행하면, AI는 바로 만들지 않고 계획을 보여 주며 승인을 물었습니다 (직접 확인). 계획 모드였으므로 이것은 만들기 전에 계획하는 모습이지, 먼저 묻는 질문을 본 것은 아닙니다.
2. 버그를 부탁하기
"이 버튼이 안 눌려요"처럼 증상을 적으면 systematic-debugging 스킬이 해당합니다. 기대하는 모습은 AI가 오류 메시지를 읽고, 같은 증상을 다시 만들어 보고, 최근 바뀐 것을 확인한 뒤에야 고치는 것입니다. 자세한 흐름은 버그를 추측 없이 고치기 글에 있습니다.
3. 스킬이 안 불릴 때
README의 "When Something Goes Wrong" 항목은 AI에게 "슈퍼파워즈에서 이 대화가 무엇이 잘못됐는지 찾아 줘"라고 말하라고 안내합니다. 그러면 diagnosing-superpowers(문제 진단) 스킬이 대화 기록을 읽고 증거와 함께 보고한다고 합니다.
자주 막히는 곳
- 설치 명령이 안 먹힐 때:
/plugin ...은 Claude Code 입력창에서 입력하는 명령입니다. 일반 터미널 입력줄에 치면 안 됩니다. 터미널용claude plugin install명령도 있다는 것은claude plugin --help에서 볼 수 있습니다 (직접 확인). - 스킬이 불리지 않는 것 같을 때: 새 대화를 열어 다시 부탁해 보고, 위 3번을 해 보세요.
- 작은 일에 너무 무거울 때: 한 줄 고치기에는 쓸 필요가 없다고 공식 자료들이 적습니다.
지우는 법과 내 자료가 저장되는 곳
- 지우는 법:
claude plugin uninstall superpowers가 있다는 것을claude plugin --help에서 볼 수 있습니다 (직접 확인). 지운 뒤 남는 파일은 지우기 전에 공식 문서를 확인하세요. - 플러그인 파일이 저장되는 곳: 설치 기록(
installed_plugins.json)이 가리키는 곳은 홈 폴더의.claude/plugins/cache/아래입니다. - 내 자료: 스킬 파일에 따르면 설계서와 계획서는 내가 일하는 프로젝트의
docs/superpowers/폴더에 파일로 저장됩니다. 이 파일은 내 프로젝트 폴더 안에 있으니, 지우기 전에 필요한 문서는 따로 복사해 두세요. - 사용 정보 전송: 공식 README의 "Visual companion telemetry" 항목에 따르면, brainstorming의 선택 기능인 시각 도우미 화면의 로고를 제작사 사이트에서 불러오며, 이때 슈퍼파워즈 버전이 전달됩니다. 프로젝트나 질문 내용은 포함되지 않는다고 적혀 있습니다. 끄려면 환경 변수(프로그램에 주는 설정값)
SUPERPOWERS_DISABLE_TELEMETRY를 켭니다.
잘 됐는지 확인하기
1. 같은 결과가 나왔나요? 터미널에서 claude plugin list를 입력했을 때 superpowers@claude-plugins-official이 보이고 상태가 사용 중입니까. 위 그림과 같으면 설치는 잘 된 것입니다.
2. 같은 결과가 나왔나요? 새 대화에서 "간단한 할 일 목록 웹페이지를 만들고 싶어요"라고 했을 때 AI가 코드를 쓰기 전에 질문부터 합니까.
3. 같은 결과가 나왔나요? "버튼이 안 눌려요"라고 했을 때 AI가 고치기 전에 오류 메시지를 읽고 원인부터 찾습니까.
2번과 3번이 아니라면 위 대표 활용법 3번을 해 보세요.
엮어 쓰기
같은 Claude Code 플러그인인 포니테일과 함께 쓸 수 있습니다. 슈퍼파워즈는 일하는 순서(묻기, 계획, 시험, 확인)를 정해 주고, 포니테일은 코드를 쓸 때 필요 없는 부분을 덜어 내게 합니다. 하나는 순서를, 하나는 분량을 맡는 셈입니다.
용어 정리
| 용어 | 뜻 |
|---|---|
| Claude Code | Anthropic이 만든 AI 코딩 도구입니다. 터미널에서 AI와 대화하며 프로그램을 만듭니다. |
| 터미널 | 글자로 명령을 입력하는 창입니다. |
| 스킬(skill) | AI가 읽고 따르는 지시문 한 묶음입니다. |
| 플러그인 | 기존 도구에 기능을 덧붙이는 부품입니다. |
| 마켓플레이스 | 플러그인 목록을 모아 둔 곳입니다. |
| 훅(hook) | 대화를 열 때 같은 때에 자동으로 실행되는 작은 프로그램입니다. |
| 하위 에이전트(subagent) | 큰 AI가 일부 작업을 맡기려고 따로 띄우는 보조 AI입니다. |
| 시험 먼저 쓰기(TDD) | 실패하는 시험을 먼저 만들고, 통과할 만큼만 코드를 쓰는 방식입니다. |
| 가지(branch) | 코드 기록의 갈래입니다. 본 코드를 건드리지 않고 작업할 때 씁니다. |
| 텔레메트리(telemetry) | 도구가 사용 정보를 제작사에 보내는 일입니다. |
| 환경 변수 | 프로그램에 주는 설정값입니다. |
| 오픈소스 | 코드를 공개하고 정해진 조건에서 쓰게 하는 방식입니다. |
| MIT 라이선스 | 오픈소스 조건의 하나입니다. 자유롭게 쓰고 고칠 수 있게 합니다. |
| 별(star) | GitHub에서 저장소에 관심을 표시한 사람 수입니다. 인기의 한 가지 잣대일 뿐입니다. |
이 글은 공식 자료를 읽고 정리했습니다. 이 Mac에서 직접 실행해 본 것은 "직접 확인" 표시를 달았습니다.