AI 혼자 일 다 하는 superpowers 가이드
하루 6시간 만에AI 기초부터 나만의
서비스까지 완성
역할: superpowers 플러그인의 설치와 동작 검증을 맡는 담당 맥락: 이 컴퓨터의 클로드 코드에 superpowers가 아직 설치되지 않았을 수 있고, 지금은 어떤 스킬이 어떤 상황에서 걸리는지 확인할 방법이 없는 상태입니다 입력: <운영체제와 셸, 예: macOS zsh>, <경험, 예: 터미널만 쓸 수 있음>, <목표 한 줄, 예: 시키면 검증까지 알아서 하게 만들고 싶다> 작업: 아래 네 단계를 순서대로 진행하세요. 1. 설치 여부 확인: `claude plugin list --json` 으로 이미 있는지 보고하세요. 있으면 다시 설치하지 말고 버전과 구성요소 수만 알려주세요. 2. 마켓플레이스 확인 후 설치: `claude plugin marketplace list` 로 등록된 마켓을 먼저 보고, 저장소 README 에서 현재 배포 마켓과 정확한 플러그인 ID 를 확인한 뒤 설치하세요. 마켓 이름을 추측하지 말고 확인한 값을 쓰세요. 3. 연결 검증: 세션을 새로 연 뒤 `claude plugin details <플러그인 ID>` 로 스킬 수를 세고, 그중 brainstorming 이 어떤 조건에서 걸리는지 그 스킬 문서의 선언을 그대로 인용하세요. 4. 마지막에 이 플러그인이 무엇을 강제하고 무엇은 못 하는지, 개발을 처음 하는 사람도 이해할 수 있는 말로 다섯 줄 이내로 설명하세요. 제약: 추측으로 스킬 개수나 마켓 이름을 말하지 마세요. 실제로 확인한 값만 쓰세요. 설치 전후로 세션을 새로 열어야 한다는 점을 빠뜨리지 마세요. 비밀키와 자격 증명 파일을 읽거나 출력하지 마세요. 출력: 확인한 설치 상태, 실행한 명령, 등록된 마켓과 설치한 플러그인 ID, 잡힌 스킬 개수, brainstorming 의 발동 조건 원문, 남은 문제를 정리해 주세요. 검증: `claude plugin list --json` 에 해당 ID 가 `enabled: true` 로 보여야 하고, `claude plugin details` 에 Skills 가 최소 14개로 표시되어야 합니다. 하나라도 실패하면 완료로 보고하지 말고 실패 지점과 다음 조치를 알려주세요.
이걸 깔면 무엇이 달라지나
혼자 일을 맡길 때 문제는 실력이 아니라 순서입니다. 사람이라면 신입이라도 "먼저 물어보고, 계획을 세우고, 만들고, 확인한다"를 압니다. AI는 그걸 모른 채 바로 코드부터 씁니다.
superpowers는 그 순서를 통째로 붙입니다. 일곱 단계가 상황에 맞춰 자동으로 걸립니다.
| 단계 | 하는 일 | |
|---|---|---|
| 1 | 되묻기 | 만들기 전에 질문으로 스펙을 뽑고, 읽을 만한 크기로 잘라 보여준다 |
| 2 | 작업공간 분리 | 승인되면 지금 것을 안 망가뜨리는 자리에 따로 판다 |
| 3 | 계획 쪼개기 | 2~5분짜리 작업으로 나눈다. 파일 경로와 확인 방법까지 적는다 |
| 4 | 나눠서 실행 | 작업마다 새 일꾼을 붙이고 2단으로 검토한다 |
| 5 | 테스트 먼저 | 실패하는 테스트를 먼저 쓴다. 테스트 전에 쓴 코드는 지운다 |
| 6 | 중간 리뷰 | 작업 사이마다 검토한다. 심각한 문제는 진행을 막는다 |
| 7 | 마무리 | 테스트를 확인하고 합칠지 말지 정한다 |
만든 사람이 저장소에 적은 결말은 이렇습니다.
> 몇 시간씩 자율로 작업하면서도 함께 세운 계획에서 벗어나지 않는 일이 드물지 않습니다.
시켜놓고 옆에 안 붙어 있어도 된다는 뜻입니다. 되묻기 하나가 좋아서가 아니라, 일곱 개가 이어져 돌기 때문입니다.
개발을 모를수록 효과가 큽니다
개발자는 결과를 열어 보고 "이거 안 되는데요"라고 되받을 수 있습니다. 코드를 못 읽으면 그 말을 못 합니다. "다 됐습니다"를 믿는 수밖에 없습니다.
| 지금 이런 일이 있다면 | 깔고 나면 |
|---|---|
| 대충 말했더니 엉뚱한 걸 만들어 왔다 | 만들기 전에 되물어서 같은 그림을 보고 시작합니다 |
| "다 됐습니다" 하는데 열어보면 안 된다 | 끝났다고 말하기 전에 직접 돌려보고, 안 되면 안 됐다고 말합니다 |
| 고쳤다는데 조금 뒤 똑같은 게 또 난다 | 눈에 보이는 것만 덮지 않고 원인을 찾아 고칩니다 |
| 한참 두면 엉뚱한 데로 새어 있다 | 계획을 쪼개 두고 작업마다 검토해서 안 새어 나갑니다 |
부르는 게 아니라는 점이 중요합니다. 명령어를 외울 필요가 없습니다. 한 번 깔고 세션만 새로 열면 조건이 맞을 때 알아서 걸립니다.
Quick Start
공식 저장소: superpowers 공식 GitHub · MIT 무료
저장소 README 기준으로 공식 마켓플레이스에 등재돼 있습니다. 클로드 코드 대화창에서 한 줄이면 됩니다.
/plugin install superpowers@claude-plugins-official
/plugin 목록에 superpowers가 나타납니다.not found가 나오면 제작자가 운영하는 마켓을 먼저 등록합니다. 공식 마켓의 수록 목록은 바뀌기 때문입니다.
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace
설치가 됐는지 화면에서 확인합니다.
claude plugin list --json claude plugin details superpowers@claude-plugins-official
superpowers 6.2.0 과 Skills (14) 가 보이면 설치가 끝난 것입니다.설치가 끝나면 세션을 새로 여세요. 이 한 줄을 빠뜨려서 "설치했는데 아무 일도 안 일어난다"고 넘어가는 경우가 가장 많습니다.
진짜 걸리는지 확인
설치됐는지가 아니라 실제로 일곱 단계가 도는지를 봐야 합니다. 새 세션에서 아래를 붙여넣으세요.
작은 할 일 관리 앱을 만들고 싶습니다. 아직 파일은 수정하지 마세요. 제가 원하는 결과를 질문으로 확인하고, 선택지와 검증 기준이 있는 설계만 보여주세요.
STEP 1 · 3분무엇을 설치하는 건지 먼저 알기
이 단계에서는 명령어를 치기 전에 이게 뭔지부터 잡습니다. 프롬프트 모음으로 착각하면 쓰는 방법을 틀리기 때문입니다.
superpowers는 코딩 에이전트에 개발 방법론을 통째로 얹는 플러그인입니다. 사람이 "이렇게 해줘"라고 매번 지시하는 대신, 상황이 오면 에이전트가 규칙을 스스로 꺼내 씁니다.
숫자부터 봅니다. 아래는 2026년 8월 24일에 깃허브 API에서 직접 읽은 값입니다.
| 항목 | 값 |
|---|---|
| 깃허브 스타 | 276,548 |
| 포크 | 24,736 |
| 공개 | 2025-10-09 — 약 10개월 |
| 라이선스 | MIT · 무료 |
| 스킬 | 14개 |
| 훅 | 4개 |
| 공식 마켓플레이스 | 286종 중 등재됨 |
지원 대상도 클로드 코드만이 아닙니다. Codex · Devin · Droid · Gemini · Copilot · Grok · Hermes · pi 까지 아홉 곳에 같은 것을 깔 수 있습니다.
STEP 2 · 2분설치하고 세션 새로 열기
이 단계에서는 실제로 깝니다. 명령은 한 줄이고, 그 뒤 한 동작이 중요합니다.
claude plugin marketplace add obra/superpowers-marketplace --scope user claude plugin install superpowers@superpowers-marketplace --scope user claude plugin list --json
enabled: true 로 보입니다.설치 직후에는 아직 아무 일도 일어나지 않습니다. 세션을 새로 여세요.
이유는 이렇습니다. 이 플러그인은 세션이 시작될 때 using-superpowers라는 안내문을 대화 맨 앞에 밀어 넣습니다. 그게 있어야 에이전트가 "일을 시작하기 전에 스킬부터 훑는다"는 동작을 합니다. 이미 열려 있던 세션에는 그 안내문이 안 들어가 있으니 아무것도 안 걸립니다.
다른 도구에 깔 때는 아래를 씁니다.
gemini extensions install https://github.com/obra/superpowers devin plugins install obra/superpowers droid plugin marketplace add https://github.com/obra/superpowers copilot plugin marketplace add obra/superpowers-marketplace grok plugin install superpowers@xai-official --trust hermes plugins install obra/superpowers --enable pi install git:github.com/obra/superpowers
STEP 3 · 4분스킬 14개가 각각 언제 뜨는지
이 단계에서는 열네 개가 각각 언제 튀어나오는지 확인합니다. 이름을 외우는 것보다 상황을 아는 쪽이 실제로 쓰이기 때문입니다. 스킬은 부르는 게 아니라 조건이 맞으면 알아서 걸리기 때문에, 어떤 조건인지 알아야 쓸 수 있습니다.
아래 "언제 뜨나"는 각 스킬이 저장소에서 스스로 선언한 발동 조건입니다. 제가 요약한 게 아니라 원문을 옮긴 것입니다. 일이 굴러가는 순서대로 묶었습니다.
일을 시작할 때 · 3개
| 스킬 | 언제 뜨나 |
|---|---|
using-superpowers | 대화를 시작할 때. 어떤 스킬이 있는지 먼저 훑고 답하게 만든다 |
brainstorming | 기능·컴포넌트를 새로 만들기 전. 창작 작업 앞에서는 반드시 먼저 걸린다 |
writing-plans | 스펙이나 요구사항이 있고 여러 단계로 나뉘는 일 — 코드를 건드리기 전 |
일을 굴릴 때 · 5개
| 스킬 | 언제 뜨나 |
|---|---|
executing-plans | 작성된 계획을 별도 세션에서 검토 지점을 두고 실행할 때 |
subagent-driven-development | 현재 세션에서 독립적인 작업들을 계획대로 굴릴 때 |
dispatching-parallel-agents | 상태를 공유하지 않는 독립 작업이 2개 이상일 때 |
using-git-worktrees | 지금 것을 망가뜨리지 않고 따로 떼어 작업해야 할 때 |
test-driven-development | 무언가를 만들거나 고칠 때 — 만들기 전에 합격 기준부터 정한다 |
막혔을 때 · 1개
| 스킬 | 언제 뜨나 |
|---|---|
systematic-debugging | 안 되거나 이상하게 동작할 때 — 고치자고 제안하기 전. 증상을 덮지 않고 원인을 찾는다 |
끝낼 때 · 4개
| 스킬 | 언제 뜨나 |
|---|---|
verification-before-completion | "다 됐다"고 말하려 할 때. 저장하기 전에 실제로 돌려보게 만든다 |
requesting-code-review | 작업을 마쳤거나 큰 기능을 넣었을 때 — 합치기 전에 스스로 리뷰를 요청한다 |
receiving-code-review | 리뷰 피드백을 받았을 때 — 반영하기 전, 특히 지적이 모호할 때 |
finishing-a-development-branch | 다 만들고 검사도 통과해서, 이걸 본체에 어떻게 합칠지 정해야 할 때 |
스킬을 만들 때 · 1개
| 스킬 | 언제 뜨나 |
|---|---|
writing-skills | 스킬을 새로 만들거나 고치거나, 배포 전에 동작을 확인할 때 |
STEP 4 · 3분브레인스토밍이 실제로 하는 일
이 단계에서는 가장 자주 걸리고 체감이 큰 스킬 하나를 뜯어봅니다. 엉뚱한 걸 만들어 오는 일이 여기서 대부분 사라집니다.
"만들어줘"라고 하면 바로 코드를 짜는 대신 되묻습니다. 막연한 한 문장이 답변 몇 번 만에 스펙 문서가 됩니다.
나 쇼핑몰 하나 만들어줘
에이전트 1. 누가 무엇을 사는 곳인가요?
2. 결제는 무엇으로 받나요?
3. 재고는 어디서 관리하나요?
4. 실패하면 어떻게 되나요?
→ SPEC.md 로 굳은 뒤에 코드로 넘어간다핵심은 순서입니다. 캐묻기 → 스펙 → 계획 → 구현 → 검증. 이 순서를 사람이 매번 지시하지 않아도 굴러가게 만드는 것이 이 플러그인이 파는 것입니다.
STEP 5 · 2분훅 4개가 왜 있나
이 단계에서는 스킬만 있는 다른 도구들과 갈리는 지점을 봅니다.
스킬은 "이럴 땐 이렇게 하라"는 설명서입니다. 설명서만 있으면 대화가 길어질수록 조용히 무시됩니다. 훅은 그걸 막는 강제 장치입니다.
세션이 시작될 때, 그리고 대화가 길어져 컨텍스트가 압축된 뒤에 안내문을 다시 밀어 넣습니다. 그래서 한 시간 넘게 이어진 대화에서도 검증 스킬이 계속 걸립니다.
이게 없으면 처음 열 번은 잘 되다가 어느 순간부터 안 되고, 왜 안 되는지도 모르게 됩니다.
STEP 6 · 2분대화마다 드는 고정 비용
이 단계에서는 설치가 대화를 얼마나 무겁게 만드는지 숫자로 확인합니다. 규칙을 항상 얹는 방식이라 공짜가 아니기 때문입니다.
claude plugin details superpowers@superpowers-marketplace
같은 계열 플러그인을 나란히 재면 차이가 큽니다.
| 플러그인 | always-on 토큰 |
|---|---|
| superpowers | 584 |
| ecc | 24,048 |
| andrej-karpathy-skills | 66 |
| unit-testing | 111 |
superpowers는 584토큰으로 가벼운 편입니다. 다만 작업 흐름이 겹치는 플러그인을 함께 켜면 매 대화마다 두 배로 붙습니다. 처음에는 하나만 켜고 결과를 보세요.
자주 막히는 곳
| 증상 | 원인 | 해결 |
|---|---|---|
| 설치했는데 스킬이 안 걸린다 | 부트스트랩은 세션 시작 때 주입된다 | 세션을 새로 연다 |
| 잘 되다가 갑자기 안 걸린다 | 컨텍스트 압축으로 안내문이 날아갔다 | 새 세션을 연다 |
| 어떤 스킬이 있는지 모르겠다 | 목록을 훑는 스킬이 따로 있다 | 대화 첫머리에서 스킬 목록을 물어본다 |
| 동작이 이상하게 겹친다 | superpowers-dev가 같이 깔려 있으면 충돌한다 | 하나만 남긴다 |
| 공식 마켓에서 안 보인다 | 마켓 버전 차이 | 저장소 마켓을 추가해 설치한다 |
FAQ
공식 마켓에서 설치했는데 not found가 떠요
공식 마켓의 수록 목록은 바뀝니다. 저장소 README에는 공식 마켓 경로가 적혀 있지만, 시점에 따라 빠져 있을 수 있습니다. 제작자가 운영하는 마켓을 먼저 등록한 뒤 설치하세요.
/plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace
설치했는데 지금 대화에서 안 보입니다
이 플러그인은 세션이 시작될 때 안내문을 대화 맨 앞에 밀어 넣습니다. 이미 열려 있던 세션에는 그게 안 들어가 있으니 아무것도 안 걸립니다. 세션을 새로 여세요. 그래도 안 되면 아래로 다시 불러옵니다.
/reload-plugins
ChatGPT에도 같은 명령을 붙여넣을 수 있나요
아닙니다. 위 명령은 클로드 코드 전용입니다. 다만 이 플러그인은 Codex · Devin · Droid · Gemini · Copilot · Grok · Hermes · pi에도 각각 따로 설치할 수 있습니다. 도구마다 명령이 다르니 저장소 README의 해당 절을 보세요.
별이 27만 개면 안전한가요
아닙니다. 별은 관심도 신호일 뿐 코드 안전성이나 내 환경과의 호환을 보장하지 않습니다. 설치 전에 저장소 소유자, 최근 커밋, 구성요소, 훅과 외부 연결을 확인하세요. 이 플러그인은 훅 4개로 세션 시작과 컨텍스트 압축 시점에 개입합니다.
설치 뒤 답이 오히려 복잡해졌습니다
작업 흐름이 겹치는 플러그인을 함께 켰을 가능성이 큽니다. 활성 목록을 보고 하나만 남긴 뒤 새 세션에서 다시 시험하세요.
claude plugin list --json claude plugin details <플러그인 ID>
업데이트는 어떻게 하나요
claude plugin update superpowers@claude-plugins-official claude plugin details superpowers@claude-plugins-official
내 작업에 맞는 규칙을 더 넣고 싶습니다
제작자가 저장소에 "새 스킬 기여는 일반적으로 받지 않는다"고 적어 두었습니다. 대신 writing-skills 스킬이 들어 있으니 그걸로 직접 만드는 쪽이 맞습니다. 확장 스킬 저장소(superpowers-skills)에 31개가 따로 있고, 설치본에 들어오는 14개와는 별개입니다.
알아 둘 한계
스킬이 걸렸는지는 대화를 봐야 압니다. 몇 번 걸렸는지 세어 주는 계기판은 없습니다.
강제력은 안내문의 세기까지입니다. 훅이 안내문을 다시 넣어 주긴 하지만, 모델이 그걸 무시할 여지가 완전히 없어지는 건 아닙니다.
스킬 목록은 저장소가 정합니다. 만든 사람이 문서에 "새 스킬 기여는 일반적으로 받지 않는다"고 적어 두었으니, 내 작업에 맞는 규칙이 필요하면 writing-skills로 직접 만드는 쪽이 맞습니다.
확장 스킬 저장소(superpowers-skills)에 31개가 따로 있습니다. 설치본에 들어오는 14개와는 별개입니다.
공식 자료
- 저장소 — github.com/obra/superpowers
- 마켓플레이스 — superpowers-marketplace · 플러그인 10종
- 확장 스킬 — superpowers-skills · 31개