obra/superpowers는 코딩 에이전트를 위한 소프트웨어 개발 방법론이자 스킬 모음입니다. Jesse Vincent와 Prime Radiant가 만들었고 MIT 라이선스입니다. 2026년 11월 7일 기준 깃허브 스타 313,611개이고, Claude 플러그인 마켓 페이지에 설치 수 1,009,371이 표시돼 있습니다.
Superpowers는 에이전트가 무언가를 만들 것 같으면 바로 코드를 쓰지 않게 합니다. 스킬이 상황에 맞춰 저절로 켜지니 따로 부를 필요가 없습니다.
설치
Claude Code는 공식 플러그인 마켓에서 한 줄입니다.
/plugin install superpowers@claude-plugins-officialCodex 앱과 CLI, Cursor, Gemini CLI, GitHub Copilot CLI, OpenCode 등도 README에 설치법이 있습니다. 여러 도구를 쓰면 도구마다 따로 설치합니다.
7단계 흐름
- brainstorming: 만들기 전에 켜집니다. 내가 진짜 원하는 것과 그 이유를 질문으로 끌어내고, 이해한 것을 되짚어 고치게 합니다. 작은 변경은 대화로 합의하고, 프로젝트는 설계 문서를 씁니다. 설계는 읽을 만한 길이의 조각으로 나눠 보여 줍니다.
- using-git-worktrees: 설계 승인 뒤 새 브랜치에 격리된 작업 공간을 만들고, 테스트가 깨끗한지 확인합니다.
- writing-plans: 일을 2~5분짜리 작업으로 쪼갭니다. 작업마다 정확한 파일 경로, 완성된 코드, 확인 단계가 들어갑니다.
- subagent-driven-development 또는 executing-plans: 작업마다 새 서브에이전트를 보내고 끝날 때마다 리뷰하거나(가장 꼼꼼), 지금 세션에서 다 구현한 뒤 브랜치 전체를 한 번 리뷰합니다(가장 저렴).
- test-driven-development: 실패하는 테스트를 쓰고, 실패를 보고, 최소한의 코드로 통과시키고, 커밋합니다. 테스트보다 먼저 쓴 코드는 지웁니다.
- requesting-code-review: 작업 사이에 계획과 대조해 문제를 심각도별로 보고합니다. 심각한 문제는 진행을 막습니다.
- finishing-a-development-branch: 테스트를 확인하고 병합, PR, 보관, 폐기 중에서 고르게 한 뒤 작업 공간을 치웁니다.
README는 에이전트가 계획에서 벗어나지 않고 두어 시간씩 혼자 일하는 일이 드물지 않다고 적었습니다.
그 밖의 스킬
| 묶음 | 스킬 |
|---|---|
| 디버깅 | systematic-debugging(4단계 원인 추적), verification-before-completion |
| 협업 | dispatching-parallel-agents, receiving-code-review |
| 메타 | writing-skills(새 스킬 만들기), using-superpowers |
| 문제 진단 | diagnosing-superpowers: 세션이 이상하게 굴면 “이 세션에서 superpowers가 뭘 잘못했는지 알아내”라고 하면 기록을 근거로 보고 |
텔레메트리
브레인스토밍의 선택 기능인 시각 도우미는 Prime Radiant 로고를 그들의 웹사이트에서 불러오고, 이때 쓰는 Superpowers 버전이 함께 전해집니다. 프로젝트나 프롬프트 내용은 보내지 않는다고 README가 밝힙니다. 끄려면 환경 변수 SUPERPOWERS_DISABLE_TELEMETRY를 참 값으로 설정합니다.
오늘 할 일
다음에 만들 기능 하나를 브레인스토밍부터 시작해 보세요. 질문에 답하다 보면 설계 문서와 2~5분 단위 계획이 먼저 나옵니다.
쇼츠로 보기
이 글은 비치콤버스 쇼츠 No.50의 짝 글입니다. 짧은 주소 beachcombers.co.kr/s/50.