슈퍼파워스 퀵스타트: 설치, 워크플로우, 및 시연

10개의 명령으로 강제되는 SDD 스킬

Page content

Superpowers는 뇌暴(brainstorming), 계획 수립, 서브에이전트 기반 구현, 엄격한 TDD(Test-Driven Development)를 강제하는 스펙 기반 개발 방법론 전체를 설치 가능한 Claude 스킬 패키지로 묶어 제공합니다.

대부분의 Claude Code SDD(Spec-Driven Development) 환경은 동일한 방식으로 실패합니다. 누군가 specify-plan-implement 스킬을 하나 만들어놓고 일주일 동안 성실하게 사용하지만, 기한이 다가오자마자 비구조화된 프롬프팅으로 조용히 돌아가 버립니다. 손으로 직접 만든 스킬에는 이를 실제로 막을 수 있는 장치가 없기 때문입니다. Superpowers는 바로 이 규율(dis) 문제를 해결하기 위한 직접적인 답변입니다. Jesse Vincent과 Prime Radiant 팀이 만든 이 스킬 패키지는 뇌暴(brainstorming), 계획 수립, 서브에이전트 리뷰, 레드-그린-리팩터링 TDD를 선택 사항이 아니라, 에이전트가 각 태스크 시작 전에 반드시 확인해야 하는 필수 단계로 간주합니다.

Superpowers skills framework installed across coding agents

이것이 단발성 언급이 아니라 집중적인 검토를 받을 가치가 있는 이유는 바로 설치 방식에 있습니다. Superpowers는 Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot CLI, Grok Build CLI, Kimi Code, OpenCode, Pi, Devin CLI, Factory Droid, Hermes Agent를 위한 플러그인 매니페스트를 함께 제공합니다. 따라서 특정 리포지토리의 .claude/skills/ 폴더에 머물지 않고, 동일한 방법론이 사용자가 다양한 하네스(개발 환경)를 오가며 따라다닙니다. 이 가이드에서는 Superpowers가 실제로 무엇인지, 사용 중인 에이전트에 설치하고 검증하는 방법, 첫 번째 끝에서 끝까지(end-to-end) 실행이 어떤 모습인지, 그리고 다른 스펙 기반 개발 도구와 함께 어떻게 위치하는지 다룹니다.

Superpowers란 무엇인가?

Superpowers는 스스로를 “구성 가능한 스킬 세트와, 에이전트가 이러한 스킬을 사용하도록 보장하는 초기 지침 위에 구축된 코딩 에이전트를 위한 완성형 소프트웨어 개발 방법론"이라고 설명합니다. 여기서 마지막 절이 핵심입니다. 스킬 컬렉션은 이미 많이 존재하지만, 여기의 차별점은 에이전트가 어떤 태스크를 시작하기 전에 관련 스킬을 확인하도록 강제하는 부트스트랩(초기화) 지침입니다. 이로 인해 워크플로우는 사용자가 슬래시 커맨드를 기억해야 할 필요 없이 자동으로 활성화됩니다.

그 이면의 철학은 프로젝트 문서에서 명확히 기술되어 있습니다.

  • 테스트 주도 개발(TDD) – 항상 테스트를 먼저 작성한다
  • 체계적이기 – 즉흥적 추정보다 프로세스를 우선한다
  • 복잡도 감소 – 단순성을 최우선 목표로 삼는다
  • 주장보다 증거 – 성공을 선언하기 전에 검증한다

실제 환경에서 이 철학은 서로 이어지는 스킬의 시퀀스로 나타납니다. 개발자를 위한 Claude Skills 및 SKILL.md를 읽어보셨다면 그 메커니즘은 익숙할 것입니다. Superpowers는 바로 그 종류의 SKILL.md 디렉터리가 담긴 크고 의견이 분명한(의견이 확고한) 스킬 모음집으로, 직접 작성하는 것이 아닌 설치 가능한 플러그인으로 배포됩니다.

코딩 에이전트 전반에 Superpowers 설치하기

설치는 하네스(에이전트)별로 다르며, 프로젝트는 사용자가 사용하는 각 에이전트에 대해 따로 설치해야 한다는 점을 명확히 하고 있습니다 – 단일 글로벌 설치 방법은 없습니다.

Claude Code

Superpowers는 Claude Code를 위한 두 가지 마켓플레이스를 통해 배포됩니다:

# 공식 Anthropic 플러그인 마켓플레이스
/plugin install superpowers@claude-plugins-official

또는 Superpowers 전용 마켓플레이스를 통해 설치할 수도 있으며, 여기에는 관련 플러그인 몇 가지도 함께 제공됩니다:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Cursor의 플러그인 마켓플레이스 UI에서 “superpowers"를 직접 검색하여 설치할 수도 있습니다.

기타 에이전트

에이전트 설치 명령어
Codex App 사이드바의 Plugins 섹션 -> Coding 섹션 -> Superpowers 설치
Codex CLI /plugins, superpowers 검색, Install Plugin 선택
Antigravity agy plugin install https://github.com/obra/superpowers
Devin CLI devin plugins install obra/superpowers
Factory Droid droid plugin marketplace add https://github.com/obra/superpowers 실행 후 droid plugin install superpowers@superpowers
Gemini CLI gemini extensions install https://github.com/obra/superpowers
GitHub Copilot CLI copilot plugin marketplace add obra/superpowers-marketplace 실행 후 copilot plugin install superpowers@superpowers-marketplace
Grok Build CLI grok plugin install superpowers@xai-official --trust
Kimi Code /plugins install https://github.com/obra/superpowers
OpenCode 리포지토리에서 .opencode/INSTALL.md를 가져와 따름 (기타 환경에서 이미 사용 중이라도 별도 설치 필요)
Pi pi install git:github.com/obra/superpowers
Hermes Agent hermes plugins install obra/superpowers --enable

실제 태스크를 실행하기 전에 주목해야 할 설치 세부 사항이 몇 가지 있습니다.

  • Antigravity는 플러그인의 세션 시작 훅을 자동으로 실행하므로 첫 메시지부터 Superpowers가 활성화됩니다. 동일한 명령으로 다시 설치하여 업데이트할 수 있습니다.
  • Pi는 스킬을 using-superpowers 부트스트랩을 세션 시작 시 및 컨텍트 압축(compaction) 후에 주입하는 작은 확장을 통해 로드합니다. Pi에는 네이티브 스킬 지원이 있으므로 Pi의 호환용 Skill 도구가 필요하지 않습니다.
  • Hermes Agent에는 포스트-컴팩션(압축) 후 훅이 없습니다 – 첫 턴을 넘어 압축되는 매우 긴 세션에서는 부트스트랩이 유실될 수 있으므로, 스킬이 더 이상 트리거되지 않으면 새 세션을 시작해야 합니다.
  • OpenCode는 동일한 기계라도 다른 어떤 하네스와도 완전히 분리된 설치 경로로 처리합니다.

설치 검증

설치 후, 침묵적인 성공 메시지에 의존하기보다 에이전트에게 직접 확인하세요:

사용 가능한 스킬이 무엇인가요?

Superpowers가 올바르게 설치되었다면, 에이전트는 결과에 brainstorming, writing-plans, test-driven-development, subagent-driven-development와 같은 스킬 목록을 제시해야 합니다. 이는 트리거되지 않는 Claude Skills 디버깅에 대해 권장되는 동일한 발견(Discovery) 체크입니다 – 스킬이 존재하지만 활성화되지 않는 경우, 문제의 원인은 모델이 아니라 라우팅 설명일 가능성이 거의 항상 높습니다.

Superpowers 워크플로우: 브레인스토밍부터 코드 배포까지

Superpowers는 7가지 스킬을 “기본 워크플로우"로 문서화하며, 각 스킬은 특정 시점에 활성화되어 다음 스킬로 넘어갑니다.

flowchart LR A[brainstorming] --> B[using-git-worktrees] --> C[writing-plans] --> D{subagent-driven-development
or executing-plans}

⬇

flowchart LR E[test-driven-development] --> F[requesting-code-review] --> G[finishing-a-development-branch]
  1. brainstorming은 어떤 코드가 작성되기 전에 활성화됩니다. 질문을 통해 대략적인 아이디어를 정제하고, 대안을 탐색하며, 긴 단일 문서 대신 짧은 검토 가능한 조각들로 설계를 제시합니다 – 그 후 결과를 설계 산출물로 저장합니다.
  2. using-git-worktrees는 사용자가 설계를 승인하면 활성화됩니다. 새 브랜치에서 격리된 워크스페이스를 생성하고, 프로젝트 설정을 실행하며, 구현 시작 전에 깨끗한 테스트 베이스라인을 검증합니다.
  3. writing-plans는 승인된 설계를 작은 작업 단위로 분해합니다 – Superpowers는 태스크당 2~5분의 작업을 목표로 합니다 – 정확한 파일 경로, 관련 시나리오의 완성된 코드, 명시적인 검증 단계를 포함하여 분해합니다.
  4. subagent-driven-development(빠른 반복) 또는 executing-plans(휴먼 체크포인트를 포함한 배치 실행)은 태스크별로 새 서브에이전트를 디스패치하며, 두 단계의 리뷰를 수행합니다: 먼저 스펙 준수 여부, 그 다음 코드 품질입니다.
  5. test-driven-development는 엄격한 레드-그린-리팩터링을 강제합니다 – 실패하는 테스트를 작성하고, 실패하는 것을 확인하고, 통과를 위한 최소한의 코드를 작성하고, 통과하는 것을 확인하고, 커밋합니다. 실패하는 테스트가 존재하기 전에 작성된 코드는 유지되지 않고 삭제됩니다.
  6. requesting-code-review는 태스크 사이에서 활성화되며, 계획에 대한 diff(차이점)를 검토하고 심각도별로 문제를 보고합니다. 중대한 문제는 다음 태스크로의 진행을 막습니다.
  7. finishing-a-development-branch는 모든 태스크가 완료되면 활성화됩니다. 테스트 통과를 검증한 후 옵션(병합, PR 오픈, 브랜치 유지, 폐기)을 제시하고 워크트리(워크스페이스)를 정리합니다.

이는 요구사항에서 코드까지의 스펙 기반 개발 워크플로우에 기술된 도구 중립적인 5단계 루프와 밀접하게 매핑됩니다. specify(명세화)는 brainstorming, plan(계획)은 writing-plans, tasks(태스크)와 implement(구현)은 subagent-driven-development으로 통합되며, validate(검증)는 TDD와 코드 리뷰로 나뉘어 수행됩니다. 차이는 강제력에 있습니다. Superpowers는 사용자가 각 단계를 호출하도록 의존하는 것이 아니라, 에이전트가 이러한 스킬을 자동으로 확인하도록 구축되어 있습니다.

직접 해보기: 첫 태스크 가이드

첫 실행에 Superpowers를 가장 중요한 기능에 사용하지 마세요. 실질적이지만 범위가 명확한 것 – 작은 엔드포인트, 집중된 버그 수정, 단일 모듈 리팩토링 – 을 선택하고, TDD 강제성이 가장 명확하게 드러나는 테스트 스위트가 이미 있는 프로젝트에서 세션을 시작하세요.

공개 API 엔드포인트에 레이트 리미팅을 추가하고 싶습니다.

Superpowers가 설치되어 있다면, 세션이 코드 대신 브레인스토밍 질문으로 시작될 것을 예상하세요: 어떤 엔드포인트인지, 어떤 제한인지, 사용자별인지 키별인지, 제한에 도달했을 때 어떻게 될 것인지 등. 이러한 마찰은 의도된 것입니다 – 이는 요구사항에서 코드까지의 스펙 기반 개발 워크플로우에서 다루는 동일한 비-목표(non-goals) 규율이지만, 사용자가 기억하기 맡기는 것이 아니라 스킬에 의해 강제됩니다. 사용자가 설계를 조각별로 승인하면, 파일 변경 전에 번호가 매겨진 작은 태스크들이 포함된 계획을 기대할 수 있으며, 각 체크포인트에서 리뷰하는 diff를 가진 태스크별 서브에이전트 디스패치를 기대할 수 있습니다.

첫 실행 시 두 가지를 주의 깊게 살펴보세요.

  • TDD가 실제로 강제되는지 확인하세요. 에이전트에게 태스크 하나를 구현하도록 요청하고, 구현 전에 실패하는 테스트가 나타나는지 확인하세요. 코드가 먼저 생성된다면, 해당 단계에서 스킬이 트리거되지 않은 것이며, 설치 섹션의 발견 체크를 재실행하는 것이 가치가 있습니다.
  • 태스크 세분도를 지켜보세요. 2~5분 태크 sizing은 일부 코드베이스에는 공격적일 수 있습니다. 태스크가 프로젝트에 대해 불필요하게 조각나 보인다면, 이는 사후 대응보다는 writing-plans 리뷰 체크포인트 중에 지적하는 것이 가치가 있습니다.

내부 구조: 스킬 라이브러리

7가지 워크플로우 스킬 외에도, Superpowers는 영역별로 그룹화된 보조 스킬을 함께 제공합니다.

카테고리 스킬
테스트 test-driven-development (테스트 안티패턴 레퍼런스 포함)
디버깅 systematic-debugging (4단계 근본 원인 프로세스, root-cause-tracing, defense-in-depth, condition-based-waiting 포함), verification-before-completion
협업 brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development
메타 writing-skills (테스트 방법론을 통한 새 스킬 생성), using-superpowers (부트스트랩 및 소개)

dispatching-parallel-agents는 별도로 언급할 가치가 있습니다. 이는 동시 서브에이전트 워크플로우를 다루며, Claude Code 서브에이전트와 동일한 영역입니다 – 격리된 컨텍스트, 독립적인 리뷰, 그리고 중간 출력이 세션을 범람시키지 않도록 메인 세션에 요약본만 보고하는 방식입니다.

Superpowers가 적합한 경우 (그리고 적합하지 않은 경우)

적합한 경우:

  • 스펙 기반 개발 vs 바이브 코딩에서 Claude Code 스킬 접근 방식을 이미 선호하지만, 리뷰 게이트를 강제할 장치가 없어 비구조화된 프롬프팅으로 계속 되돌아가는 경우.
  • 여러 코딩 에이전트를 오가며 작업하고, Claude Code 전용 스킬이 아니라 사용자를 따라다니는 하나의 방법론을 원하는 경우.
  • 강제 로직을 직접 작성하지 않고도 엄격한 TDD 강제성을 원하는 경우.
  • 아키텍처 드리프트와 잊혀진 제약 조건이 실제 리스크가 되는 멀티-세션 기능 – 스펙 기반 개발 vs 바이브 코딩에서 설명된 정확한 실패 모드.

적합하지 않은 경우:

  • 빠른 스크립트, 일회용 프로토타입, 일회성 자동화 – 브레인스토밍과 계획 수립의 오버헤드는 실제로 존재하며, 50줄의 변경 사항에 그 대가를 치르는 것은 가치가 없습니다.
  • 기존에 잘 조정된 프로젝트 전용 SDD 스킬이 있는 팀. Superpowers는 해당 커스터마이징을 대신하여 강제되고 의견이 확고한 의식(ceremony)을 교환합니다. 이미 작동하는 것을 유지하고 개별 스킬 아이디어만 차용하는 것이 더 나을 수 있습니다.
  • 엄격한 2~5분 태스크 세분도나 의무적인 TDD가 아직 변경할 준비가 되지 않은 기존 팀 프로세스와 충돌하는 환경.

Superpowers가 다른 SDD 도구와 다른 점

Superpowers는 통상적인 의미에서 GitHub Spec Kit이나 AWS Kiro의 경쟁자가 아닙니다 – 독립적인 CLI나 IDE가 아니라 Claude Code / 크로스 에이전트 스킬 레이어에서 작동합니다. Spec Kit은 이동 가능한 마크다운 산출물과 에이전트 독립성을 제공하고, Kiro는 가이드되는 통합 IDE 경험을 제공하며, 손으로 만든 Claude Code 스킬은 제로 강제성과 최대의 유연성을 제공합니다. Superpowers는 후자 두 가지 사이에 위치합니다. DIY Claude Code 워크플로우와 동일한 스킬 기반 메커니즘을 가지되, 의무적으로 느껴지는 강제성과 리포지토리 로컬 스킬이 제공하지 않는 크로스 에이전트 플러그인 배포를 갖추고 있습니다.

Spec Kit, Kiro, Claude Code 스킬, OpenSpec, BMAD-METHOD, Tessl에 걸친 이동 가능성, 설정 마찰, 리뷰 게이트, 그리고 록-인(lock-in)에 대한 전체적인 분석 – Superpowers가 비교 표와 의사결정 프레임워크에서 어디에 위치하는지 포함 – 은 GitHub Spec Kit vs Kiro vs Claude Code SDD 워크플로우에서 확인하세요. 더 적은 강제 의식과 브라운필드 코드베이스에서 반복할 더 많은 자유를 원한다면, OpenSpec 퀵스타트가 더 가벼운 변경 중심의 대안을 다룹니다. 그리고 누락된 역할이 Superpowers가 담당하지 않는 것(제품 리뷰, 브라우저 QA, 보안 감사, 릴리스 엔지니어링)이라면, gstack은 이를 가상 엔지니어링 팀으로 패키징하여 Superpowers와 결합할 수 있게 해줍니다. Superpowers는 구현 단계 안의 규율을 공급합니다.

문제 해결 및 알아두어야 할 사항

업데이트는 대부분 자동이지만 에이전트에 따라 다릅니다. 설치의 최신성 유지 여부는 하네스에 따라 다릅니다 – Antigravity는 재설치 시 세션 시작 훅을 재실행하고, npm 또는 Git 기반 설치에는 명시적인 업데이트 명령이 필요하며, 마켓플레이스 기반 설치에는 일반적으로 호스트 에이전트 자체의 플러그인 업데이트 플로우를 따릅니다.

텔레메트리는 기본적으로 켜져 있지만 쉽게 비활성화할 수 있습니다. 브레인스토밍 스킬의 선택형 비주얼 코뮐레이터는 Prime Radiant 웹사이트에서 로고를 로드하며, 이는 사용자의 Superpowers 버전을 포함하지만 프로젝트, 프롬프트, 클릭 데이터는 포함하지 않습니다. SUPERPOWERS_DISABLE_TELEMETRY를 true 값으로 설정하여 끄세요. Superpowers는 또한 Claude Code 자체의 DISABLE_TELEMETRY 및 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 옵트아웃을 준수합니다.

기여는 dev 분기 요구. 스킬을 수정하거나 추가하려면 리포지토리를 포크하고 dev로 전환한 후, 변경 사항을 생성 및 테스트하기 위해 writing-skills 스킬을 따르세요 – 특히 새로운 스킬 기여는 일반적으로 수용되지 않으며, 모든 스킬이 지원되는 모든 에이전트에서 동일하게 작동해야 하기 때문입니다.

스킬이 트리거되지 않으면, 다른 Claude 스킬 문제와 마찬가지로 처리하세요. “사용 가능한 스킬이 무엇인가요?“라고 물어보며 발견 여부를 확인하고, 현재 사용하는 특정 에이전트(같은 기계의 다른 에이전트가 아님을)에 대해 설치했는지 확인하세요. 그리고 부트스트랩이 조용히 유실된 경우, 긴 세션 압축 후 Hermes 세션은 새 시작을 필요로 한다는 점을 기억하세요.

결론

SDD 의도와 세션에서 실제로 일어나는 일 사이의 차이가 해결하고자 하는 문제라면, Superpowers는 설치할 가치가 있습니다. 새로운 specify-plan-implement 아이디어를 도입하는 것은 아닙니다 – 그 루프는 이미 스펙 기반 개발이란 무엇인가?에서 잘 다루고 있습니다. Superpowers는 기존 아이디어를 건너뛰기 어렵게 만들고, 리포지토리 로컬 스킬이 도달할 수 있는 범위보다 더 많은 에이전트에서 그렇게 합니다. 먼저 매일 사용하는 하나의 하네스에 설치하고, 브레인스토밍부터 마무리까지의 전체 사이클을 통해 작은 범위의 태스크를 실행해 본 후, 그 강제된 의식이 실제 업무량에서 그 대가를 치르는지 그 때부터 결정하세요.

유용한 링크

구독하기

시스템, 인프라, AI 엔지니어링에 관한 새 글을 받아보세요.