Superpowers

Superpowers
Superpowers는 코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론으로, 조합 가능한 스킬 세트와 에이전트가 이를 사용하도록 보장하는 초기 지침 위에 구축됩니다.

목차

작동 방식
상용 서비스
시작하기

Claude Code
Antigravity
Codex App
Codex CLI
Cursor
Devin CLI
Factory Droid
Gemini CLI
GitHub Copilot CLI
Grok Build CLI
Kimi Code
OpenCode
Pi
Qwen Code
Hermes Agent
Muse

기본 워크플로
문제가 발생했을 때
커뮤니티
포함된 내용
철학
기여하기
업데이트
라이선스
비주얼 컴패니언 텔레메트리

작동 방식
코딩 에이전트를 실행하는 순간부터 시작됩니다. 에이전트는 여러분이 무언가를 만들고 있다는 것을 확인하자마자 곧바로 코드를 작성하려 들지 않습니다. 대신 한 걸음 물러나 여러분이 진짜로 무엇을 하려는지 묻습니다.

대화에서 스펙을 끌어낸 뒤에는 실제로 읽고 소화할 수 있을 만큼 짧은 단위로 나누어 보여줍니다.

설계에 승인을 하면, 에이전트는 열정적이지만 취향이 나쁘고 판단력도 없고 프로젝트 맥락도 없으며 테스트를 혐오하는 주니어 엔지니어도 따라할 수 있을 만큼 명확한 구현 계획을 작성합니다. 이 계획은 진정한 red/green TDD, YAGNI(You Aren't Gonna Need It), DRY를 강조합니다.

다음으로 "go"라고 말하면, 서브에이전트 주도 개발 프로세스를 시작하여 에이전트들이 각 엔지니어링 작업을 진행하고, 그 작업을 검사하고 리뷰하며, 계속 나아가게 합니다. 에이전트가 여러분이 세운 계획에서 벗어나지 않고 한 번에 몇 시간씩 자율적으로 작업하는 것은 드문 일이 아닙니다.

더 많은 내용이 있지만, 이것이 시스템의 핵심입니다. 그리고 스킬이 자동으로 트리거되기 때문에 특별히 할 일은 없습니다. 여러분의 코딩 에이전트는 그저 Superpowers를 갖게 됩니다.

상용 서비스
엔터프라이즈에서 Superpowers를 사용 중이며 상용 지원, 추가 툴링 또는 관리형 지출의 혜택을 받고 싶다면 주저하지 말고 [email protected] 으로 연락해 주세요.

설치
설치는 하네스마다 다릅니다. 둘 이상을 사용한다면 각각에 대해 Superpowers를 별도로 설치하세요.

Claude Code
Superpowers는 공식 Claude 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

공식 마켓플레이스

Anthropic의 공식 마켓플레이스에서 플러그인을 설치하세요:

/plugin install superpowers@claude-plugins-official

Superpowers 마켓플레이스
Superpowers 마켓플레이스는 Claude Code용 Superpowers와 몇 가지 관련 플러그인을 제공합니다.

마켓플레이스를 등록하세요:

/plugin marketplace add obra/superpowers-marketplace

이 마켓플레이스에서 플러그인을 설치하세요:

/plugin install superpowers@superpowers-marketplace

Antigravity
이 저장소에서 플러그인으로 Superpowers를 설치하세요:

agy plugin install https://github.com/obra/superpowers
Antigravity는 설치된 각 스킬의 설명을 나열하며,
using-superpowers 스킬의 설명은 대화 시작 시 모델이 해당 스킬을
로드하도록 유도합니다. 업데이트하려면 같은 명령으로 재설치하세요.

Codex App
Superpowers는 공식 Codex 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

Codex 앱에서 사이드바의 Plugins를 클릭하세요.
Coding 섹션에서 Superpowers를 볼 수 있습니다.
Superpowers 옆의 +를 클릭하고 안내를 따르세요.

Codex CLI
Superpowers는 공식 Codex 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

플러그인 검색 인터페이스를 여세요:

/plugins

Superpowers를 검색하세요:

superpowers

Install Plugin 을 선택하세요.

Cursor

Cursor Agent 채팅에서 마켓플레이스로 설치하세요:

/add-plugin superpowers

또는 플러그인 마켓플레이스에서 "superpowers"를 검색하세요.

Devin CLI

이 저장소에서 플러그인을 설치하세요:

devin plugins install obra/superpowers

최신 버전으로 업데이트하려면:

devin plugins update 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

나중에 업데이트하려면:

gemini extensions update superpowers

GitHub Copilot CLI

마켓플레이스를 등록하세요:

copilot plugin marketplace add obra/superpowers-marketplace

플러그인을 설치하세요:

copilot plugin install superpowers@superpowers-marketplace

Grok Build CLI
Superpowers는 공식 Grok 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

xAI의 공식 마켓플레이스에서 플러그인을 설치하세요:

grok plugin install superpowers@xai-official --trust

또는 TUI에서 마켓플레이스를 열고 Superpowers를 검색한 뒤 설치하세요:

/marketplace

Kimi Code
Superpowers는 Kimi Code의 플러그인 마켓플레이스에서 사용할 수 있습니다.

Kimi Code의 플러그인 관리자를 여세요:

/plugins

Marketplace > Superpowers로 이동하여 설치하세요.

또는 이 저장소에서 직접 설치하세요:

/plugins install https://github.com/obra/superpowers

자세한 문서: docs/README.kimi.md

OpenCode
OpenCode는 자체 플러그인 설치 방식을 사용합니다. 다른 하네스에서 이미
Superpowers를 사용 중이더라도 별도로 설치하세요.

OpenCode에 다음을 알려주세요:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

자세한 문서: docs/README.opencode.md

Pi
이 저장소에서 Pi 패키지로 Superpowers를 설치하세요:

pi install git:github.com/obra/superpowers
로컬 개발의 경우, 이 체크아웃을 임시 패키지로 로드하여 Pi를 실행하세요:

pi -e /path/to/superpowers
Pi 패키지는 Superpowers 스킬과, 세션 시작 시 그리고 압축 후에 using-superpowers 부트스트랩을 주입하는 작은 확장을 로드합니다. Pi는 네이티브 스킬을 지원하므로 호환성 Skill 도구가 필요하지 않습니다. 서브에이전트 및 작업 목록 도구는 선택적인 Pi 컴패니언 패키지로 남아 있습니다.

Qwen Code
Qwen Code는 Claude Code 마켓플레이스에서 직접 플러그인을 설치합니다.

이 저장소에서 플러그인을 설치하고, 프롬프트가 나오면 superpowers를 선택하세요:

qwen extensions install obra/superpowers

나중에 업데이트하려면:

qwen extensions update superpowers

Hermes Agent
이 저장소에서 Hermes 플러그인으로 Superpowers를 설치하세요:

hermes plugins install obra/superpowers --enable
설치 후 활성화된 Hermes 세션을 재시작하세요. 참고: Hermes에는
압축 후 훅이 없으므로, 첫 턴에서 압축이 일어나는 매우 긴 세션은
부트스트랩을 잃게 됩니다 — 스킬이 트리거되지 않으면 새 세션을 시작하세요.

Muse
Superpowers는 네이티브 Muse 플러그인으로 사용할 수 있습니다 — 같은 저장소, 같은 스킬, 모든 하네스. using-superpowers 부트스트랩은 Claude Code, Codex, Cursor, Gemini, Pi 등과 함께 네이티브 SessionStart 훅을 통해 주입됩니다 — 세션별 옵트인이 필요 없습니다.

로컬 체크아웃에서 설치하세요:

muse plugins install ./
muse plugins approve superpowers
또는 클론하여 설치하세요:

git clone https://github.com/obra/superpowers.git
muse plugins install ./superpowers
muse plugins approve superpowers

나중에 업데이트하려면:

muse plugins update superpowers

SessionStart 훅이 적용되도록 설치 후 활성화된 Muse 세션을 재시작하세요 — 스킬은 즉시 활성화되지만, 훅은 첫 설치 시 승인이 필요합니다. 확인하려면 새 세션을 시작하고 Let's make a react todo list 를 보내세요 — 정상적으로 설치되었다면 코드를 작성하기 전에 brainstorming이 자동으로 트리거됩니다. 버전은 .version-bump.json에 추적되므로 scripts/bump-version.sh가 이를 동기화 상태로 유지합니다.

기본 워크플로

brainstorming - 무언가를 만들기 전에 활성화됩니다. 질문을 통해 여러분이 실제로 무엇을, 왜 원하는지 끌어내어 설명하게 하고, 그 이해를 다시 들려주어 교정받습니다. 작은 변경은 채팅에서 합의되고, 프로젝트는 빌더가 계획을 세울 수 있는 서면 설계 문서가 됩니다.

using-git-worktrees - 설계 승인 후 활성화됩니다. 새 브랜치에 격리된 워크스페이스를 만들고, 프로젝트 설정을 실행하며, 깨끗한 테스트 기준선을 검증합니다.

writing-plans - 승인된 설계와 함께 활성화됩니다. 작업을 작은 단위(각 2-5분)로 나눕니다. 모든 작업에는 정확한 파일 경로, 완전한 코드, 검증 단계가 포함됩니다.

subagent-driven-development 또는 executing-plans - 계획과 함께 활성화됩니다. 각 작업마다 새 서브에이전트를 파견하고 매번 리뷰하는 방식(가장 철저함) 또는 현재 세션에서 모든 작업을 인라인으로 구현하고 마지막에 전체 브랜치를 한 번 새로 리뷰하는 방식(가장 저렴함) 중 하나입니다.

test-driven-development - 구현 중에 활성화됩니다. RED-GREEN-REFACTOR를 강제합니다: 실패하는 테스트를 작성하고, 실패하는 것을 확인하고, 최소한의 코드를 작성하고, 통과하는 것을 확인하고, 커밋합니다. 테스트 전에 작성된 코드는 삭제합니다.

requesting-code-review - 작업 사이에 활성화됩니다. 계획에 대조하여 리뷰하고, 심각도별로 문제를 보고합니다. 심각한 문제는 진행을 차단합니다.

finishing-a-development-branch - 작업이 완료되면 활성화됩니다. 테스트를 검증하고, 옵션(merge/PR/keep/discard)을 제시하고, 워크트리를 정리합니다.

에이전트는 모든 작업 전에 관련 스킬을 확인합니다. 권장 사항이 아닌 필수 워크플로입니다.

문제가 발생했을 때
때때로 세션이 잘못 작동합니다: 스킬이 작동해서는 안 될 때 작동하거나, 작동해야 할 때 조용히 있거나, 에이전트가 계획을 무시하거나, 작업을 반복하거나, 예상보다 많은 토큰을 소모합니다. 코딩 에이전트에게 "이 세션에서 superpowers에 무슨 문제가 있었는지 파악해줘"라고 요청하면 diagnosing-superpowers 스킬을 호출합니다. 이전 세션을 검사하려면 이름을 지정하세요: "세션 <id> 에서 superpowers에 무슨 문제가 있었는지 파악해줘".

이 스킬은 세션 트랜스크립트를 읽고, 무슨 일이 있었는지 줄 단위 증거와 함께 보고하며, 원한다면 버그 리포트용으로 정제된 번들을 패키징합니다.

커뮤니티
Superpowers는 Jesse Vincent와 Prime Radiant의 다른 분들이 만들었습니다.

Discord : 커뮤니티 지원, 질문, Superpowers로 만드는 것 공유를 위해 참여하세요
Issues : https://github.com/obra/superpowers/issues
릴리스 공지 : 새 버전 알림을 받으려면 가입하세요

포함된 내용
스킬 라이브러리
테스팅

test-driven-development - RED-GREEN-REFACTOR 사이클 (테스팅 안티패턴 참조 포함)

디버깅

systematic-debugging - 4단계 근본 원인 프로세스 (root-cause-tracing, defense-in-depth, condition-based-waiting 기법 포함)
verification-before-completion - 실제로 수정되었는지 확인
diagnosing-superpowers - 세션에서 무슨 문제가 있었는지 증거와 함께 파악하고, 정제된 번들을 내보내거나 이슈를 제출

협업

brainstorming - 만들기 전에 의도 끌어내기
writing-plans - 상세한 구현 계획
executing-plans - 인라인 계획 실행: 하나의 컨텍스트, 한 번의 최종 리뷰
dispatching-parallel-agents - 동시 서브에이전트 워크플로
requesting-code-review - 사전 리뷰 체크리스트
receiving-code-review - 피드백에 응답하기
using-git-worktrees - 병렬 개발 브랜치
finishing-a-development-branch - Merge/PR 결정 워크플로
subagent-driven-development - 2단계 리뷰(스펙 준수, 그다음 코드 품질)를 통한 빠른 반복

메타

writing-skills - 모범 사례에 따라 새 스킬 만들기 (테스팅 방법론 포함)
using-superpowers - 스킬 시스템 소개

철학

Test-Driven Development - 항상 테스트를 먼저 작성
체계성 우선, 임기응변보다 - 추측보다 프로세스
복잡성 감소 - 단순함을 최우선 목표로
주장보다 증거 - 성공을 선언하기 전에 검증

원본 릴리스 공지를 읽어보세요.

기여하기
Superpowers의 일반적인 기여 프로세스는 아래와 같습니다. 우리는 일반적으로 새 스킬에 대한 기여를 받지 않으며, 스킬에 대한 모든 업데이트는 우리가 지원하는 모든 코딩 에이전트에서 작동해야 한다는 점을 명심하세요. 또한 다른 사람이 제출한 이슈를 수정하는 에이전트 작성 PR은 유지관리자가 요청하지 않는 한 받지 않습니다. 같은 문제를 겪더라도 마찬가지입니다. 대신 기존 이슈에 보고를 추가하세요.

저장소를 포크하세요
'dev' 브랜치로 전환하세요
작업을 위한 브랜치를 만드세요
새 스킬과 수정된 스킬을 만들고 테스트하려면 writing-skills 스킬을 따르세요
PR을 제출하고, 사람이 자신의 말로 작성한 요약을 포함하여 풀 리퀘스트 템플릿의 모든 섹션을 채우세요.

스킬 동작 테스트는 superpowers-evals 의 drill eval 하네스를 사용하며, evals/ 에 클론됩니다 — 설정은 evals/README.md를 참조하세요. 플러그인 인프라 테스트는 tests/ 에 있으며 관련 run-*.sh 또는 npm test 로 실행됩니다.

완전한 내용은 skills/writing-skills/SKILL.md를 참조하세요…