슈퍼파워스 퀵스타트: 설치, 워크플로 및 체험

Superpowers는 전체 스펙 주도(Spec-driven) 방법론을 설치 가능한 Claude Skills로 패키징하여, 브레인스토밍, 계획 수립, 서브에이전트 기반 구현, 그리고 엄격한 TDD를 강제합니다. 이러한 구조를 사용자가 스스로 결정하도록 맡기지 않습니다.

대부분의 Claude Code SDD(스펙 주도 개발) 세팅은 동일한 방식으로 실패합니다. 누군가 specify-plan-implement 스킬을 한 번 작성하고 일주일 동안 성실하게 사용하지만, 마감 기한이 다가오면 언제 그랬냐는 듯이 구조화되지 않은 프롬프팅으로 돌아가는 것입니다. 수작업으로 작성한 스킬에는 이를 막을 수 있는 장치가 전혀 없습니다. Superpowers는 바로 이 규율 문제를 해결하기 위한 직접적인 답변입니다. Jesse Vincent와 Prime Radiant 팀이 개발한 이 스킬 패키지는 브레인스토밍, 계획 수립, 서브에이전트 리뷰, 그리고 레드-그린-리팩터 TDD를 선택적으로 건너뛸 수 있는 제안이 아니라, 에이전트가 각 작업을 시작하기 전에 반드시 확인해야 하는 필수 단계로 취급합니다.

Superpowers를 각주로 언급하는 수준이 아니라 자세히 살펴볼 만한 가치가 있는 이유는 설치 방식에 있습니다. 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/ 폴더에 묶여 있는 것이 아니라 동일한 방법론이 다양한 하네스(Harness)를 따라다니게 됩니다. 이 가이드에서는 Superpowers가 실제로 무엇인지, 사용하는 에이전트에 어떻게 설치하고 검증하는지, 첫 번째 엔드투엔드 실행은 어떤 모습인지, 그리고 다른 스펙 주도 개발 도구들과 어떻게 비교되는지 다룹니다.

Superpowers란 무엇인가?

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

이 프로젝트의 문서에 따르면 그 철학은 다음과 같이 명확히 서술되어 있습니다:

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

실제로 이 철학은 서로에게 작업을 인계하는 스킬의 시퀀스로 나타납니다. Claude Skills and SKILL.md for Developers를 읽어보셨다면 그 메커니즘이 익숙하게 느껴질 것입니다. Superpowers는 스스로 작성하는 것이 아니라 설치 가능한 플러그인으로 배포되는, 정확히 그 종류의 SKILL.md 디렉터리에 대한 크고 의견이 분명한(Set of opinionated) 스킬 모음입니다.

코딩 에이전트 전반에 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"를 검색하여 설치할 수도 있습니다.

기타 에이전트

실제 작업을 수행하기 전에 몇 가지 설치 상세 사항을 알아두는 것이 좋습니다:

• Antigravity는 플러그인의 세션 시작 훅을 자동으로 실행하므로, 첫 번째 메시시부터 Superpowers가 활성화됩니다. 업데이트를 하려면 동일한 명령어로 재설치합니다.
• Pi는 using-superpowers 부트스트랩을 세션 시작 시 및 컨텍트 압축(context compaction) 후에 주입하는 작은 확장 프로그램을 통해 스킬을 로드합니다. Pi는 네이티브 스킬 지원이 있으므로 Pi의 호환성 Skill 도구가 필요하지 않습니다.
• Hermes Agent에는 압축 후 훅(post-compaction hook)이 없습니다. 첫 번째 턴을 넘어 긴 세션이 압축되면 부트스트랩이 손실될 수 있으므로, 스킬이 트리거되지 않으면 새 세션을 시작해야 합니다.
• OpenCode는 이미 사용 중인 다른 하네스와 완전히 별개의 설치 경로로 취급합니다. 같은 기계에서 사용하더라도 마찬가지입니다.

설치 검증

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

What skills are available?

Superpowers가 올바르게 설치되었다면, 에이전트는 결과에 brainstorming, writing-plans, test-driven-development, subagent-driven-development 등의 스킬을 나열해야 합니다. 이는 debugging Claude Skills that fail to trigger에서 권장하는 동일한 탐색 확인 절차입니다. 스킬은 존재하지만 활성화되지 않는다면, 문제의 원인은 모델이 아니라 라우팅 설명문(routing description)인 경우가 대부분입니다.

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

Superpowers는 “기본 워크플로"로 7가지 스킬을 문서화하고 있으며, 각각은 특정 시점에 활성화되어 다음 스킬로 인계합니다:

⬇

1. brainstorming은 코드가 작성되기 전에 활성화됩니다. 질문을 통해 거친 아이디어를 다듬고, 대안을 탐색하며, 하나의 긴 문서가 아니라 짧고 검토 가능한 조각으로 설계를 제시한 후 결과를 설계 산출물(design artifact)로 저장합니다.
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를 검토하고 심각도에 따라 문제를 보고합니다. 중요한(critical) 문제는 다음 작업으로의 진행을 차단합니다.
7. finishing-a-development-branch는 모든 작업이 완료되면 활성화됩니다. 테스트가 통과하는지 확인한 후 옵션을 제시합니다(병합, PR 생성, 브랜치 유지, 또는 폐기) 그리고 워크트리(worktree)를 정리합니다.

이는 Spec-Driven Development Workflow From Requirements to Code의 도구 중립적인 5단계 루프와 밀접하게 대응합니다. specify는 brainstorming이 되고, plan은 writing-plans가 되며, tasks와 implement는 subagent-driven-development으로 통합되고, validate는 TDD와 코드 리뷰로 나뉩니다. 차이는 강제성(enforcement)에 있습니다. Superpowers는 사용자가 각 단계를 호출하도록 의존하는 것이 아니라, 에이전트가 자동으로 이 스킬들을 확인하도록 구성되었습니다.

직접 해보기: 첫 번째 작업 워크스루

Superpowers를 처음 실행할 때 가장 중요한 기능에 바로 적용하지 마십시오. 실제로 존재하지만 범위가 제한적인 것을 선택하십시오 – 작은 엔드포인트, 집중된 버그 수정, 단일 모듈 리팩터링 등 – 그리고 TDD 강제성이 가장 잘 드러나는 테스트 스위트가 이미 있는 프로젝트에서 세션을 시작하십시오.

I want to add rate limiting to our public API endpoints.

Superpowers가 설치되어 있다면, 코드가 아니라 브레인스토밍 질문으로 세션이 시작되기를 기대해야 합니다. 어떤 엔드포인트에, 어떤 제한을, 사용자별인지 키별인지, 제한에 도달했을 때 어떻게 해야 하는지 등입니다. 이러한 마찰은 의도적인 것입니다. Spec-Driven Development Workflow From Requirements to Code에서 다루는 비목표(non-goals) 규율과 동일하지만, 사용자가 기억하도록 맡기는 것이 아니라 스킬이 강제합니다. 설계를 조각별로 승인하면, 파일 변경 전에 번호가 매겨진 작은 작업들로 이루어진 계획이 제시되고, 각 작업마다 서브에이전트가 디스패치되어 각 체크포인트에서 diff를 검토하게 됩니다.

첫 번째 실행 시 주목해야 할 두 가지 사항:

• TDD가 실제로 강제되는지 확인하십시오. 에이전트에게 하나의 작업을 구현하도록 요청하고, 구현 전에 실패하는 테스트가 나타나는지 확인하십시오. 코드가 먼저 배치된다면, 그 단계에서 스킬이 트리거되지 않은 것이며, 설치 섹션의 탐색 확인을 다시 실행해 볼 가치가 있습니다.
• 작업 세분화(task granularity)를 관찰하십시오. 2~5분 작업 크기 설정은 일부 코드베이스에 대해서는 공격적일 수 있습니다. 프로젝트에서 작업이 불필요하게 분AGMENT화되었다면,事後(사후)에 지적하기보다 writing-plans 리뷰 체크포인트에서 지적하는 것이 좋습니다.

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

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

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

Superpowers가 적합한 경우 (및 부적합한 경우)

적합한 경우:

• Spec-Driven Development vs Vibe Coding의 Claude Code 스킬 접근법을 좋아하지만, 리뷰 게이트를 강제하는 장치가 없어 구조화되지 않은 프롬프팅으로 돌아가는 경향이 있는 경우.
• 여러 코딩 에이전트를 넘나들며 작업하며, Claude Code 전용 스킬이 아닌 자신을 따라다니는 하나의 방법론을 원하는 경우.
• 강제 로직을 스스로 작성하지 않고 엄격한 TDD 강제성을 원하는 경우.
• 아키텍처 드리프트와 잊혀진 제약 조건이 실제 위험인 멀티 세션 기능의 경우 – Spec-Driven Development vs Vibe Coding에서 설명된 정확한 실패 모드입니다.

부적합한 경우:

• 빠른 스크립트, 일회용 프로토타입, 일회성 자동화 – 브레인스토밍과 계획 수립의 오버헤드는 실재하며, 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에서 확인할 수 있습니다.

문제 해결 및 알아야 할 사항

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

텔레메트리(Telemetry)는 기본적으로 켜져 있지만 비활성화하기 쉽습니다. brainstorming 스킬의 선택적 시각적 companian은 Prime Radiant 웹사이트에서 로고를 로드하며, 이는 Superpowers 버전을 포함하지만 프로젝트, 프롬프트, 클릭 데이터는 포함하지 않습니다. SUPERPOWERS_DISABLE_TELEMETRY를 어떤 true 값으로 설정하면 꺼집니다. Superpowers는 또한 Claude Code의 자체 DISABLE_TELEMETRY 및 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 옵트아웃을 존중합니다.

기여(Contributions)는 dev 브랜치가 필요합니다. 스킬을 수정하거나 추가하려면 저장소를 포크하고 dev로 전환한 후, 변경 사항을 생성 및 테스트하기 위해 writing-skills 스킬을 따르십시오. 새로운 스킬 기부는 일반적으로 수락되지 않으며, 모든 스킬은 지원되는 모든 에이전트에서 동일하게 작동해야 하기 때문입니다.

스킬이 트리거되지 않으면 다른 Claude Skill 문제와 마찬가지로 취급하십시오. “What skills are available?“을 물어봐서 탐색(discovery)을 확인하고, 현재 사용 중인 특정 에이전트에 대해 설치했는지(같은 기계의 다른 에이전트가 아닌) 확인하십시오. 그리고 Hermes 세션의 경우, 부트스트랩이 조용히 사라지면 긴 세션 압축 후 새 시작이 필요하다는 점을 기억하십시오.

결론

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

유용한 링크

• Superpowers repository – 모든 지원 에이전트를 위한 소스, 스킬, 플러그인 매니페스트
• Superpowers marketplace – Superpowers 및 관련 플러그인을 위한 Claude Code 마켓플레이스
• GitHub Spec Kit vs Kiro vs Claude Code SDD Workflows – 전체 도구 비교 및 의사결정 프레임워크
• Claude Skills and SKILL.md for Developers – Superpowers가 기반을 두는 근본적인 스킬 메커니즘
• Claude Code Subagents: Setup, Config, and When to Use Them – 격리 컨텍스트 리뷰, subagent-driven-development의 메커니즘
• Spec-Driven Development Workflow From Requirements to Code – Superpowers가 자동화하는 도구 중립적인 5단계 프로세스
• What Is Spec-Driven Development? The Spec as Source of Truth – 핵심 SDD 개념 및 용어
• Claude Code install and config for Ollama, llama.cpp, pricing – Superpowers를 추가하기 전에 Claude Code 자체를 설치하고 구성하기