Superpowers 설치부터 사용까지: AI 코딩 에이전트에 개발 습관을 심는 완벽 가이드 | DAKER 커뮤니티

Superpowers 설치부터 사용까지: AI 코딩 에이전트에 개발 습관을 심는 완벽 가이드

AI 코딩 도구를 쓰다 보면 가장 위험한 순간은 에이전트가 너무 빨리 코드를 쓰기 시작할 때입니다. 요구사항을 제대로 묻지 않고, 기존 구조를 덜 읽고, 테스트 없이 "완료"라고 말하는 흐름은 처음에는 빨라 보이지만 결국 되돌리는 시간이 커집니다.

Superpowers는 이 문제를 프롬프트 한두 줄로 해결하려는 도구가 아닙니다. Jesse Vincent와 Prime Radiant 쪽에서 공개한 에이전트용 스킬 프레임워크이자 소프트웨어 개발 방법론입니다. 핵심은 간단합니다. 코딩 에이전트가 작업을 시작할 때 관련 스킬을 먼저 확인하고, 설계, 계획, 테스트, 리뷰, 검증 절차를 더 일관되게 따르도록 만드는 것입니다.

이 글은 DAKER 커뮤니티 독자를 위해 Superpowers 설치, 확인, 실전 요청법, 팀 적용 팁을 한 번에 정리한 실무 가이드입니다.

Superpowers가 해결하려는 문제

AI 코딩에서 생산성을 떨어뜨리는 원인은 대부분 코드 생성 속도가 아닙니다. 문제는 잘못된 방향으로 빠르게 가는 것입니다.

대표적인 실패 패턴은 이렇습니다.

- 요구사항이 흐릿한데 바로 구현한다.
- 변경 범위가 넓은데 한 번에 수정한다.
- 기존 테스트와 프로젝트 규칙을 확인하지 않는다.
- 작업 완료를 말로만 선언하고 증거를 남기지 않는다.

Superpowers는 이런 실패 패턴을 막기 위해 에이전트에게 "작업 전 스킬 확인"이라는 습관을 넣습니다. 예를 들어 새 기능이면 brainstorming이 요구사항을 묻고, writing-plans가 작업을 쪼개고, test-driven-development가 RED-GREEN-REFACTOR 순서를 강제합니다.

쉽게 말하면 Superpowers는 에이전트에게 붙이는 개발 팀의 작업 규칙입니다. 지금 쓰는 에이전트가 덜 즉흥적으로 움직이게 만드는 레이어에 가깝습니다.

설치 전에 알아둘 것

Superpowers는 하나의 앱에 한 번 설치하면 모든 도구에서 자동으로 공유되는 방식이 아닙니다. 공식 README 기준으로 Claude Code, Codex CLI, Codex App, Gemini CLI, OpenCode, Cursor, GitHub Copilot CLI, Factory Droid 등 각 하네스마다 설치 방식이 다릅니다.

여기서 하네스란 에이전트가 실행되는 껍데기입니다. 같은 Superpowers라도 Claude Code에서 쓰는 플러그인 설치와 Codex App에서 쓰는 플러그인 설치는 별개입니다. 여러 도구를 쓰는 사람이라면 각 도구에 따로 설치해야 합니다.

또 하나 중요한 점은 업데이트입니다. 2026년 5월 7일 기준 공식 저장소와 릴리즈 노트에서는 v5.1.0 계열 흐름이 기준이며, 예전 slash command 일부가 제거되었습니다. 오래된 글의 명령이 안 맞으면 공식 README와 RELEASE-NOTES를 먼저 확인하세요.

Codex App에 설치하기

Codex App을 쓰는 사람은 가장 간단합니다.

- Codex App을 연다.
- 왼쪽 사이드바에서 Plugins를 클릭한다.
- Coding 섹션에서 Superpowers를 찾는다.
- Superpowers 옆의 + 버튼을 누르고 안내를 따른다.
- 설치 후 새 세션을 열어 "Tell me about your superpowers"처럼 물어본다.

설치가 잘 되면 에이전트가 사용 가능한 스킬을 인식합니다. 변화가 없다면 앱을 완전히 종료한 뒤 다시 실행해 보세요.

Codex CLI에 설치하기

Codex CLI에서는 공식 플러그인 마켓플레이스에서 설치합니다.

/plugins
플러그인 검색 화면에서 다음 키워드를 검색합니다.

superpowers
검색 결과에서 Install Plugin을 선택합니다. 설치 후 새 Codex CLI 세션을 시작하고 다음처럼 확인합니다.

Tell me about your superpowers.
Codex CLI에서 기존 AGENTS.md나 프로젝트 규칙과 충돌하면 사용자와 프로젝트 지시가 우선입니다. Superpowers는 그 안에서 개발 절차를 보강합니다.

Claude Code에 설치하기

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

공식 마켓플레이스 설치:

/plugin install superpowers@claude-plugins-official
Superpowers 마켓플레이스 등록 후 설치:

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace
설치 후 Claude Code를 다시 시작하세요. 새 세션에서 스킬 사용 규칙을 인식하면 정상입니다.

Gemini CLI에 설치하기

Gemini CLI에서는 extension으로 설치합니다.

gemini extensions install obra/superpowers 저장소 URL
업데이트는 다음 명령으로 진행합니다.

gemini extensions update superpowers
Gemini CLI는 도구 매핑과 하위 에이전트 지원 범위가 다를 수 있습니다.

OpenCode에 설치하기

OpenCode는 opencode.json에 플러그인을 추가합니다. 전역 또는 프로젝트 설정에 다음 형태를 넣습니다.

{
"plugin": ["superpowers@git+obra/superpowers 저장소"]
}
설정 후 OpenCode를 재시작합니다. 확인은 다음처럼 요청하면 됩니다.

Tell me about your superpowers.
예전 symlink 방식 사용자는 기존 symlink와 오래된 설정을 지우고 새 플러그인 방식으로 갈아타는 것이 좋습니다.

Cursor에 설치하기

Cursor Agent 채팅에서는 마켓플레이스에서 설치합니다.

/add-plugin superpowers
또는 플러그인 마켓플레이스에서 superpowers를 검색해 설치합니다. 설치 뒤 새 Agent 대화에서 Superpowers가 인식되는지 확인하세요.

기본 워크플로우 이해하기

공식 README의 기본 흐름은 다음과 같습니다.

- brainstorming: 요구사항과 대안을 검토한다.
- using-git-worktrees: 승인된 설계 뒤 격리된 작업 공간을 만든다.
- writing-plans: 구현을 작은 작업으로 쪼갠다.
- subagent-driven-development 또는 executing-plans: 계획대로 구현하고 리뷰한다.
- test-driven-development: 실패 테스트를 먼저 만들고 최소 구현으로 통과시킨다.
- requesting-code-review: 코드 리뷰로 심각한 이슈를 막는다.
- finishing-a-development-branch: 테스트와 변경을 확인하고 마무리 선택지를 제시한다.

이 흐름의 핵심은 "바로 구현하지 않기"입니다. Superpowers를 설치했는데도 에이전트가 매번 즉시 코드를 쓰려고 한다면, 다음처럼 요청해 보세요.

Superpowers가 설치되어 있다면 관련 스킬을 먼저 확인하고,
구현 전에 요구사항과 검증 기준을 짧게 정리해줘.
실제 요청 예시

좋은 요청:

관리자 대시보드의 기간 필터를 개선하고 싶어.
먼저 Superpowers 스킬을 확인한 뒤 요구사항을 질문해줘.
구현 전에는 사용자가 어떤 흐름으로 필터를 바꾸는지,
URL 쿼리와 새로고침 동작을 어떻게 검증할지 정리해줘.
이렇게 요청하면 에이전트는 코드를 바로 뱉는 도구가 아니라, 작업을 쪼개고 검증 기준을 확인하는 개발 파트너에 가까워집니다.

자주 쓰게 될 스킬

스킬은 계속 바뀔 수 있지만, 현재 공개 저장소 기준으로 중요한 축은 다음과 같습니다.

- brainstorming: 아이디어를 바로 구현하지 않고 요구사항과 설계를 먼저 정리합니다.
- writing-plans: 승인된 설계를 작은 구현 작업으로 나눕니다.
- test-driven-development: 테스트를 먼저 작성하고 실패를 확인한 뒤 구현합니다.
- systematic-debugging: 추측 대신 재현, 최소화, 가설, 계측, 수정 순서로 버그를 좁힙니다.
- verification-before-completion: 정말 끝났는지 증거로 확인합니다.
- requesting-code-review: 코드 품질과 계획 충족 여부를 리뷰합니다.
- using-git-worktrees: 병렬 작업을 안전하게 분리합니다.
- finishing-a-development-branch: 작업 브랜치 마무리를 정리합니다.

중요한 건 스킬 이름 암기가 아닙니다. 핵심은 "관련 스킬이 있으면 먼저 확인한다"입니다.

문제 해결

설치했는데 변화가 없다면 다음을 확인하세요.

- 설치한 하네스가 지금 쓰는 하네스와 같은가?
- 앱이나 CLI를 재시작했는가?
- 플러그인 또는 extension이 최신 버전으로 로드되었는가?
- 오래된 slash command를 쓰고 있지는 않은가?

v5.1.0 릴리즈 노트는 예전 /brainstorm, /execute-plan, /write-plan 같은 legacy slash command 제거를 설명합니다. 최신 흐름에서는 스킬을 직접 호출하거나, 관련 스킬 확인을 요청하는 방식이 더 안전합니다.

OpenCode에서 스킬이 보이지 않으면 opencode.json의 plugin 배열을 확인하고 재시작하세요.

결론

Superpowers는 AI 코딩 에이전트를 "더 빠른 자동완성"에서 "절차를 지키는 개발 파트너"에 가깝게 만드는 도구입니다. 설치는 어렵지 않고, 진짜 변화는 설치 후 요청 방식에서 시작됩니다.

작업 전에 의도를 묻고, 설계를 합의하고, 계획을 쪼개고, 완료 전에 증거를 확인하는 것. 이 흐름이 핵심입니다.

바이브코딩을 실무에 쓰고 싶다면 화려한 프롬프트보다 에이전트가 따라야 할 습관이 먼저입니다. Superpowers는 그 습관을 반복 가능한 형태로 포장한 좋은 출발점입니다.

참고 자료: obra/superpowers README, RELEASE-NOTES, OpenCode 문서, Jesse Vincent 글.