이 가이드로 하는 것 클로드 코드에 Superpowers를 설치하고, "코드부터 짜는" 대신 질문 → 설계서 승인 → 계획 → 테스트 먼저 구현 순서로 일하게 만듭니다. 걸리는 시간은 설치 5분, 첫 시험 15분 안팎입니다.
기준 (2026-10-11): 이 가이드의 명령과 동작 설명은 공식 README(https://github.com/obra/superpowers)를 기준으로 합니다. 막히면 README를 확인하세요. 설치 방법은 도구마다 다르고, 아래는 클로드 코드 기준입니다.
0. 시작 전에
- 클로드 코드가 설치되어 있고 터미널에서 실행할 수 있어야 합니다
- 만들어 볼 작은 프로젝트 하나 (예: 할 일 목록 앱) — 처음엔 작은 것으로 시험하세요
- 인터넷 연결
용어 3개만
- 스킬: 클로드 코드가 특정 상황에서 따르는 작업 지침 묶음입니다.
- 플러그인: 스킬 등을 한 번에 설치해 주는 확장 묶음입니다.
- 서브에이전트: 작업 하나만 맡아서 처리하는 별도의 에이전트입니다.
1. Superpowers가 무엇인가 (README 요약)
README는 Superpowers를 "코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론"이라고 소개합니다. 핵심 흐름은 이렇습니다.
- 무언가를 만든다는 걸 알아채면 바로 코드를 쓰지 않고, 무엇을 하려는 건지 먼저 묻습니다.
- 대화에서 스펙을 뽑아내서 읽고 소화할 수 있는 짧은 조각으로 보여 줍니다.
- 설계를 승인하면 구현 계획을 만듭니다. 테스트 먼저(RED/GREEN TDD), YAGNI, DRY를 강조합니다.
- "go"라고 하면 서브에이전트가 작업을 하나씩 처리하고 검토하며 계속 진행합니다.
스킬은 자동으로 발동하므로 특별히 할 일이 없다고 README는 설명합니다. 라이선스는 MIT입니다.
2. 설치 (클로드 코드)
방법 A — 공식 마켓플레이스 (README 첫 번째 방법)
클로드 코드 안에서 입력합니다.
/plugin install superpowers@claude-plugins-official
방법 B — Superpowers 마켓플레이스
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
둘 중 하나만 하면 됩니다.
설치가 됐는지 확인
README는 새 세션을 시작해서 아래처럼 보내 보라고 안내합니다(README의 다른 도구 설명에 적힌 방법이며, 정상 설치면 코드를 쓰기 전에 brainstorming이 먼저 발동한다고 합니다).
Let's make a react todo list
코드를 바로 쓰지 않고 질문부터 한다면 잘 설치된 것입니다.
3. 기본 워크플로우 7단계 (README)
| 순서 | 스킬 | 하는 일 |
|---|---|---|
| 1 | brainstorming | 만들기 전에 발동. 질문으로 의도를 끌어내고 이해한 내용을 되돌려 말해 줍니다. 작은 변경은 대화로 합의하고, 프로젝트는 설계 문서를 씁니다. |
| 2 | using-git-worktrees | 설계 승인 뒤 새 브랜치에 격리된 작업 공간을 만들고, 테스트 기준선이 깨끗한지 확인합니다. |
| 3 | writing-plans | 일을 2~5분짜리 작은 작업으로 나눕니다. 작업마다 정확한 파일 경로, 완전한 코드, 검증 단계가 있습니다. |
| 4 | subagent-driven-development 또는 executing-plans | 전자는 작업마다 새 서브에이전트를 보내고 매번 검토합니다(꼼꼼한 쪽). 후자는 현재 세션에서 모두 구현하고 마지막에 한 번 검토합니다(비용이 덜 드는 쪽). |
| 5 | test-driven-development | 구현 중 발동. 실패하는 테스트를 쓰고 → 실패를 확인하고 → 최소한의 코드를 쓰고 → 통과를 확인하고 → 커밋합니다. 테스트보다 먼저 쓴 코드는 지웁니다. |
| 6 | requesting-code-review | 작업 사이마다 계획 대비 검토하고 심각도별로 보고합니다. 심각한 문제는 진행을 막습니다. |
| 7 | finishing-a-development-branch | 작업이 끝나면 테스트를 확인하고 병합/PR/유지/폐기 중에서 고르게 한 뒤 작업 공간을 정리합니다. |
README는 "에이전트는 어떤 작업이든 시작 전에 관련 스킬이 있는지 확인한다. 제안이 아니라 필수 워크플로우"라고 적고 있습니다.
4. 처음 써 보기 (15분)
아래는 README의 설명을 바탕으로 한 사용 예시입니다. 실제 질문 문구와 순서는 달라질 수 있습니다.
1) 작은 요청을 그대로 보냅니다.
할 일 목록 앱을 만들고 싶어
2) 코드를 바로 쓰지 않고 질문이 오는지 봅니다. 누가 쓰는지, 무엇이 필요한지 같은 질문에 편하게 답하세요. 답이 막연해도 괜찮습니다. 질문으로 좁혀 가는 것이 목적입니다.
3) 설계서 조각을 읽고 승인합니다. 길지 않은 조각으로 나뉘어 옵니다. 틀린 부분은 이 단계에서 고치세요. 승인하기 전에는 구현으로 넘어가지 않는 것이 이 방법의 핵심입니다.
4) 계획을 확인합니다. 작업이 2~5분 크기로 쪼개지고 파일 경로와 검증 방법이 적혀 있는지 훑어보세요. 마음에 들면 진행하라고 말하면 됩니다.
5) 구현을 지켜봅니다. 작업이 끝날 때마다 검토가 들어가고, 테스트가 먼저 만들어지는지 확인하세요.
5. 복붙 프롬프트 5종
프롬프트는 예시이며 모델에 따라 결과가 조금 다를 수 있습니다.
프롬프트 1 — 작게 시작하기
작은 기능 하나로 시험해 보고 싶어. 코드를 쓰기 전에 먼저 질문으로 내 의도를 확인해 줘.
프롬프트 2 — 설계서 고치기
설계서 2번 조각에서 '사용자 로그인' 부분은 이번 범위에서 빼 줘. 나머지는 유지하고 설계서를 다시 보여 줘.
프롬프트 3 — 계획 점검
계획의 각 작업에 파일 경로와 검증 방법이 모두 있는지 표로 정리해 줘. 빠진 게 있으면 알려 줘.
프롬프트 4 — 구현 방식 고르기
이 계획을 작업마다 새 서브에이전트가 구현하고 검토하는 방식과, 한 세션에서 구현하고 마지막에 한 번 검토하는 방식 중 어느 쪽이 이 규모에 맞는지 이유와 함께 추천해 줘.
프롬프트 5 — 뭔가 이상할 때 (README 안내)
figure out what went wrong with superpowers in this session
6. 문제가 생겼을 때
스킬이 발동하지 않거나, 엉뚱할 때 발동해요
README는 세션이 잘못 동작하면 "figure out what went wrong with superpowers in this session"이라고 요청하라고 안내합니다. 그러면 diagnosing-superpowers 스킬이 세션 기록을 읽고 무슨 일이 있었는지 근거와 함께 보고합니다. 원하면 개인정보를 지운 번들을 만들어 버그 리포트에 쓸 수도 있습니다.
설치 명령이 안 먹혀요
설치 방법은 도구마다 다릅니다. 위 명령은 클로드 코드 기준입니다. 다른 도구(Codex, Cursor, Gemini CLI 등)는 README의 해당 항목을 따르세요. 클로드 코드에서 안 되면 방법 A 대신 방법 B를 시도해 보세요.
사용 기록이 전송되나요?
README의 "Visual companion telemetry" 항목에 따르면, brainstorming의 선택 기능인 시각 도우미가 로고를 자사 웹사이트에서 불러오며 이때 Superpowers 버전이 포함됩니다. 프로젝트나 프롬프트 내용은 포함되지 않는다고 합니다. 끄려면 환경변수 SUPERPOWERS_DISABLE_TELEMETRY를 참 값으로 설정하세요. 클로드 코드의 DISABLE_TELEMETRY와 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 설정도 따른다고 합니다.
토큰이 많이 드는 것 같아요
README는 작업마다 서브에이전트를 쓰는 방식이 더 꼼꼼하고, 한 세션에서 구현하는 방식(executing-plans)은 비용이 덜 든다고 설명합니다. 비용이 부담되면 작은 프로젝트부터 시험하고 프롬프트 4로 방식을 골라 보세요.
업데이트는 어떻게 하나요
README는 업데이트가 사용하는 도구에 따라 다르고 대개 자동이라고 설명합니다.
7. 마무리
이제 클로드 코드에 먼저 묻고, 승인받고, 계획한 뒤 테스트부터 일하게 하는 순서를 시험해 보실 수 있습니다. 작은 프로젝트로 한 번 돌려 보시고, 잘 안 맞는 부분은 알려 주세요.
이 가이드가 도움이 됐다면 AI비즈메이커 채널 구독으로 알려 주세요. 다음 가이드도 이어서 올리겠습니다.
출처: Superpowers 공식 README https://github.com/obra/superpowers (MIT, 제작 Jesse Vincent · Prime Radiant), 2026-10-11 확인.
