슈퍼파워스 바로 시작: 설치, 워크플로우, 실습

하나의 명령어로 설치되는 강제 SDD 기능

Page content

Superpowers는 설치 가능한 Claude Skills로 전체 스펙 주도 개발 방법론을 패키징하여, 브레인스토밍, 계획 수립, 서브에이전트 기반 구현, 엄격한 TDD를 강제함으로써 해당 구조를 사용자가 자유롭게 선택하도록 두지 않습니다.

대부분의 Claude Code SDD 설정은 동일한 방식으로 실패합니다. 누군가가 견고한 specify-plan-implement 스킬을 작성하고 한 주 동안 성실하게 사용하다가, 기한이 다가오는 순간에 구조화되지 않은 프롬프팅으로 조용히 돌아가기 때문입니다. 수작업으로 작성된 스킬에는 이를 방지하는 어떤 장치도 없습니다. Superpowers는 바로 이러한 дисциплиن 문제를 해결하기 위한 직접적인 답변이며, Jesse Vincent과 Prime Radiant 팀이 개발한 스킬 패키지입니다. 이 패키지는 브레인스토밍, 계획 수립, 서브에이전트 리뷰, 레드-그린-리팩터링 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의 실질적 내용, 사용하는 에이전트에서의 설치 및 검증 방법, 첫 번째 엔드투엔드 실행 예시, 그리고 다른 스펙 주도 개발 도구 대비 위치를 다룹니다.

Superpowers란 무엇인가?

Superpowers는 “코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론으로, 구성 가능한 스킬 세트와 에이전트가 이들을 사용하도록 보장하는 초기 명령 위에 구축되었다"고 설명합니다. 여기서 중요한 것은 마지막 부분입니다. 다양한 스킬 컬렉션이 존재하지만, 여기의 차별점은 에이전트가 어떤 작업을 시작하기 전에 관련 스킬을 확인하도록 강제하는 부트스트랩 명령입니다. 이를 통해 워크플로우는 사용자가 슬래시 명령어를 기억할 필요 없이 자동으로 활성화됩니다.

그背后的 철학은 프로젝트 자체의 문서에 plainly 명시되어 있습니다:

  • 테스트 주도 개발 (Test-Driven Development) – 항상 테스트를 먼저 작성합니다
  • 체계적 접근을 우선시 – 추측이 아닌 프로세스를 중시합니다
  • 복잡성 축소 – 단순성을 최우선 목표로 삼습니다
  • 증거를 주장보다 중시 – 성공을 선언하기 전에 검증합니다

실제로 이 철학은 서로 핸드오프를 하는 스킬들의 시퀀스로 나타납니다. 개발자를 위한 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 부트스트랩을 주입하는 소형 확장을 통해 스킬을 로드합니다. Pi에는 네이티브 스킬 지원이 있으므로 Pi의 호환성 Skill 도구가 필요하지 않습니다.
  • Hermes Agent에는 컴팩션 후 후크가 없습니다 – 첫 턴 이후 장시간 세션에서 컴팩션이 발생하면 부트스트랩을 잃을 수 있으므로, 스킬이 트리거되지 않으면 새로운 세션을 시작해야 합니다.
  • OpenCode는 이미 사용하는 다른 하네스와 완전히 별개의 설치 경로로 취급됩니다. 동일한 머신에서도 마찬가지입니다.

설치 검증

설치가 완료되면 침묵적인 성공 메시지만을 믿기보다 에이전트에게 직접 질문하십시오:

사용 가능한 스킬이 무엇이 있습니까?

Superpowers가 올바르게 설치되었다면, 에이전트는 결과물에 brainstorming, writing-plans, test-driven-development, subagent-driven-development 등의 스킬을 나열해야 합니다. 이는 트리거되지 않는 Claude Skills 디버깅에 권장되는 동일한 발견 확인 절차입니다 – 스킬이 존재하지만 활성화되지 않는 경우, 거의 항상 모델의 문제가 아니라 라우팅 설명의 문제입니다.

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 (휴먼 체크포인트가 있는 배치 실행)은 작업마다 새로운 서브에이전트를 디스패치하며, 2단계 리뷰를 수행합니다: 먼저 스펙 준수 여부, 그다음 코드 품질.
  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) disciplina이지만, 사용자가 기억하는 것에 맡기기보다 스킬에 의해 강제됩니다. 사용자가 청크 단위로 설계를 승인하면, 파일 변경이 일어나기 전에 번호가 매겨진 작은 작업들로 구성된 계획을 예상하게 되고, 각 체크포인트에서 diff를 검토하는 서브에이전트가 작업마다 하나씩 디스패치됩니다.

첫 실행 시 주의해야 할 두 가지 사항:

  • TDD가 실제로 강제되는지 확인하십시오. 에이전트에게 작업 하나를 구현하도록 요청하고, 구현 전에 실패하는 테스트가 나타나는지 확인하십시오. 코드가 먼저 생성되면, 해당 단계에서 스킬이 트리거되지 않은 것이며, 설치 섹션의 발견 확인 절차를 다시 실행할 가치가 있습니다.
  • 작업의 세분화 정도를 관찰하십시오. 2~5분 작업 크기 설정은 일부 코드베이스에 대해 공격적일 수 있습니다. 프로젝트에 대해 작업이 불필요하게 파편화되었다고 느껴지면,事後 사후에 제언하기보다 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 Workflows를 참고하십시오. 더 적은 강제된 의식과 브라운필드 코드베이스에서 반복할 자유가 더 필요하시다면, OpenSpec 퀵스타트는 더 가벼운, 변경 중심의 대안을 다루고 있습니다.

문제 해결 및 알아둘 사항

업데이트는 대부분 자동이지만 에이전트에 의존합니다. 설치의 최신 상태는 하네스에 따라 달라집니다. 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 Skill 문제와 동일하게 취급하십시오. “사용 가능한 스킬이 무엇이 있습니까?“라고 질문하여 발견을 확인하고, 현재 사용하는 특정 에이전트(동일한 머신에 있는 다른 에이전트가 아닌)를 위해 설치했는지 확인하십시오. 또한 Hermes 세션은 부트스트랩이 조용히 떨어질 경우 장시간 세션 컴팩션 후 새로운 시작이 필요함을 기억하십시오.

결론

Superpowers는 SDD 의도와 세션에서 실제로 일어나는 것 사이의 간격이 해결하려는 문제일 때 설치할 가치가 있습니다. Superpowers는 새로운 specify-plan-implement 아이디어를 도입하는 것이 아닙니다. 그 루프는 이미 스펙 주도 개발이란 무엇인가?에서 충분히 다루어져 왔습니다. Superpowers는 기존 아이디어를 건너뛰기 어렵게 만들며, 저장소 로컬 스킬이 도달할 수 있는 에이전트보다 더 많은 에이전트에 걸쳐 그렇게 합니다. 매일 사용하는 하네스 하나에 먼저 설치하고, 작은 범위의 작업을 브레인스토밍부터 마무리까지의 전체 사이클을 통해 실행한 후, 실제 워크로드에서 강제된 의식이 그 가치를 증명하는지 판단하십시오.

유용한 링크

구독하기

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