Superpowers 설치 및 사용법

저는 현재 개발을 위해 Claude Code에 Superpowers 플러그인을 추가하여 사용하고 있습니다. Superpowers 플러그인을 활용하면 brainstorm → plan → implement로 이어지는 체계적인 개발 워크플로우, TDD 강제, 서브에이전트 기반 구현 등 한층 강력한 기능을 사용할 수 있습니다.

제가 개발하면서 기존에 사용하던 여러 플러그인과 비교해서 Superpowers를 활용할 때 제일 완성도 높은 코드를 구현한다고 생각하고 있습니다.

 

Superpowers란?

Superpowers는 Jesse Vincent와 Prime Radiant 팀이 만든 에이전트용 스킬 프레임워크이자 소프트웨어 개발 방법론입니다. 코딩 에이전트가 곧바로 코드를 작성하는 대신, 사용자가 정말로 만들고 싶은 것이 무엇인지 먼저 질문하고, 대화에서 스펙을 끌어낸 뒤 읽고 소화할 만한 크기로 나눠 보여줍니다. 사용자가 설계를 승인하면 "판단력도 프로젝트 맥락도 없고 테스트를 싫어하는 의욕만 넘치는 주니어 엔지니어"가 따라갈 수 있을 만큼 명확한 구현 계획을 만들고, "go" 신호가 떨어지면 서브에이전트들이 각 태스크를 진행, 검토, 진척시키는 방식으로 동작합니다.

 

GitHub: https://github.com/obra/superpowers

GitHub - obra/superpowers: An agentic skills framework & software development methodology that works.

주요 기능

• brainstorm → write-plan → execute-plan 워크플로우: 설계 정제, 구현 계획, 일괄 실행으로 이어지는 3단계 파이프라인
• TDD 강제: test-driven-development 스킬이 구현 시 자동 활성화
• DRY 원칙 내장: 과한 추상화와 중복 코드를 자동으로 견제
• 서브에이전트 기반 개발(subagent-driven-development): 2단계 리뷰(스펙 준수 → 코드 품질)로 빠른 반복
• 자동 활성화 스킬: systematic-debugging은 디버깅 시, verification-before-completion은 완료 선언 직전에 자동으로 동작
• 멀티 에이전트 지원: Claude Code, Codex CLI, Codex App, Factory Droid, Gemini CLI, OpenCode, Cursor, GitHub Copilot CLI에서 동작

Superpowers 설치하기

Claude Code에서 다음 명령어를 실행합니다:

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

 

설치 후 Claude Code를 종료하고 다시 실행하면 session-start-hook이 주입됩니다. 이 훅이 부트스트랩 역할을 하면서 Claude에게 다음 사실을 가르칩니다:

"너에게는 스킬이 있고, 그것이 너의 superpower다. 스크립트로 스킬을 검색하고, 스킬을 사용할 때는 SKILL.md를 읽고 그대로 따라라. 어떤 작업에 해당하는 스킬이 있다면 반드시 그 스킬을 써야 한다."

 

Codex, Opencode 등 다른 AI 툴에서도 설치하여 활용할 수 있습니다. 깃허브의 설치 가이드라인을 살펴보세요.

사용법

기본 워크플로우 설계

• 브레인스토밍: /superpowers:brainstorm 거친 아이디어를 질문으로 다듬고, 대안을 탐색하고, 설계를 섹션 단위로 검증합니다.
• 구현 계획 작성: /superpowers:write-plan 설계가 승인되면 명확한 구현 계획을 만듭니다.
• 계획 실행: /superpowers:execute-plan 서브에이전트들이 일괄 단위로 태스크를 처리합니다. 마지막에는 GitHub Pull Request 생성, worktree를 원래 브랜치로 머지, 혹은 그냥 중단할지 선택할 수 있습니다.

자동 활성화되는 스킬 스킬은 명령어로 부를 필요 없이 상황에 맞게 자동으로 동작합니다.

 

스킬을 직접 만들기

Superpowers의 핵심은 스킬 자체보다 "스킬을 만드는 스킬"에 있습니다. 예를 들어 git worktree 워크플로우를 추가하고 싶다면, 원하는 동작을 설명만 해도 Claude가 기존 스킬에 필요한 메모를 덧붙여 미래의 Claude가 worktree를 사용하도록 만들 수 있습니다. 프로그래밍 책을 읽혀서 "읽기 전에는 명확하지 않았던 재사용 가능한 스킬"을 뽑아내게 하는 워크플로우도 가능합니다.