Github 19만 스타에 빛나는 Claude Code 플러그인 Superpowers 사용기 완벽 가이드
AI 코딩 에이전트가 폭주한 경험이 있는가? "메모앱 만들어"라고만 요청했는데, 사용자의 의도 따위는 아랑곳하지 않고 기획에 없던 기능까지 척척 추가하던 경험. 바로 이 문제를 근본적으로 해결하기 위해 등장한 도구가 있다. Claude Code 플러그인 Superpowers다. 현재 19만 4천 개 이상의 깃허브 스타를 받으며 커뮤니티에서 입증된 이 도구는, AI가 코딩에 돌입하기 전에 기획 단계를 강제하는 구조적 프레임워크를 제공한다.
왜 기존 AI 코딩의 방식에는 한계가 있었나
대부분의 개발자가 Claude Code를 사용하는 방법은 단순하다. 프롬프트를 입력하고, 코딩이 시작되는 것을 바라보며, 결과가 마음에 들지 않으면 30분에 걸쳐 수정을 반복한다. 근본적인 원인은 Claude가 멍청해서가 아니라 성급하기 때문이다. 대규모 언어 모델은 "도와주기" 훈련받았기에 문제를 정확히 이해하기 전에 즉시 출력하기 시작한다. 경험 많은 개발자라면 알 것이다. 새로운 작업에 착수할 때 가장 먼저 하는 일이 clarifying 질문, 아키텍처 스케치, 플랜 작성이라는 것을. Claude는 이 세 단계를 건너뛰고 바로 코드 작성으로 돌진한다.
Superpowers가 가져온 변화
Superpowers는 Jesse Vincent가 개발한 MIT 라이선스의 무료 오픈소스 플러그인으로, Claude Code에 14개의 에이전트 스킬을 원코마은도 하나로 설치한다. 핵심은 "using superpowers"라는 마스터 디스패처가 대화 시작 시 자동으로 활성화되어, 작업 종류에 따라 필요한 스킬을 올바른 순서로 라우팅한다는 점이다.
예를 들어 "랜딩 페이지를 만들어줘"라고 말하면 Clarify → Visual Companion → Design → Plan → Code → Verify 순서로 스킬이 활성화된다. 반면 "이 버그를 수정해줘"라고 하면 Debug 스킬과 Verify 스킬만 활성화된다. 개발자가 수동으로 각 스킬을 호출할 필요가 없다. 디스패처가 알아서 판단한다.
5단계 필수 프로세스
Superpowers의 철학은 명확하다. 모든 기능 요청은 5개의 필수 단계를 거친다. Claude는 이 단계를 건너뛸 수 없다. 각 단계에는 다음 단계의 잠금을 해제하기 전에 통과해야 하는 품질 게이트가 존재한다.
1단계 Clarify — 요구사항 정리와 시각적 목업 생성으로 시작한다. Claude는 소크라테스식 질문을 통해 요구사항을 캐낸다. 로컬 저장소를 사용할 것인가, 클라우드를 사용할 것인가. 검색 기능이 필요한가. 사용자는 이러한 질문을 받으며 기획이 자동으로 정리된다.
2단계 Design — 아키텍처 결정, 컴포넌트 구성, 기술 스택 선택이 이루어진다. 설계 문서가 작성되어 세션이 바뀌어도 AI가 약속을 기억하게 된다.
3단계 Plan — 작업을 바이트 크기의 태스크로 분해한다. 각 태스크는 2~5분 내에 완료 가능한립도로 나뉜다. 태스크마다 정확한 파일 경로, 완전한 코드, 검증 단계가 포함된다.
4단계 Code — 테스트 우선 개발이 강제된다. 실패하는 테스트를 먼저 작성하고, 실패를 확인한 후 최소한의 코드를 작성하며, 테스트가 통과하면 커밋한다. 테스트 없이 작성된 코드는 자동으로 삭제된다.
5단계 Verify — 4단계 체계적 디버깅으로 결론을 내린다. 추측이 아닌 증거 기반의 검증을 거친다.
Visual Companion: 코딩 전에 눈으로 확인하라
Superpowers의 가장 인상적인 스킬은 Visual Companion이다. Clarify 단계에서 Claude는 임시 HTML 대시보드를 생성하여 브라우저에서 열린다. 레이아웃 목업, 색상 팔레트 옵션, 컴포넌트 대안, 인터랙티브 미리보기가 즉석에서 생성된다. 실제 프로젝트 코드 한 줄도 작성되기 전의 상태다. 사용자는 옵션을 클릭하며 선호하는 레이아웃과 색상 체계를 선택한다. 이 승인 후에야 Claude가 Design 단계로 이동한다.
실제 테스트 결과, Visual Companion은 피처당 평균 4회이던 스타일 관련 재시도를 0으로 줄였다. 매번 버그 수정에 비용을 지불하던 환경에서 이는 상당한 효율성 향상이다.
14개 스킬의 전체 목록
Superpowers의 스킬 라이브러리는 협업, 테스트, 디버깅, 메타 워크플로우의 네 가지 영역으로 구성된다.
협업 스킬로는 Brainstorming이 소크라테스식 질문으로 요구사항을 구체화하고, Writing Plans가 세부 구현 플랜을 작성하며, Executing Plans가 체크포인트와 함께 배치 실행을 담당한다. Dispatching Parallel Agents는 동시 서브에이전트 워크플로우를, Requesting Code Review와 Receiving Code Review는 코드 리뷰 체인을 형성한다. Using Git Worktrees는 격리된 작업 공간에서 병렬 개발 브랜치를, Finishing a Development Branch는 병합이나 PR 옵션을 제시한다.
테스트 스킬로는 Test Driven Development가 레드-그린-리팩터 사이클을 강제한다. 디버깅 스킬로는 Systematic Debugging이 4단계 근본 원인 분석 프로세스를 적용한다. Verification Before Completion은 결함을 실제로 수정했는지 확인한다.
메타 스킬로는 Writing Skills가 새 스킬 작성 시 모범 사례를 제공하고, Using Superpowers가 스킬 시스템 자체를 소개한다.
설치 방법
Claude Code에서 설치하는 방법은 두 가지다. 첫 번째는 Anthropic 공식 마켓플레이스에서 설치하는 것이다.
/plugin install superpowers@claude-plugins-official두 번째는 Superpowers 마켓플레이스를 등록하고 설치하는 방법이다.
/plugin marketplace add obra/superpowers-marketplace/plugin install superpowers@superpowers-marketplace슈퍼파워즈 마켓플레이스에는 Superpowers 본체 외에도 관련 플러그인이 함께 제공된다. 설치가 완료되면 이후 매 대화 시작 시 "using superpowers" 디스패처가 자동으로 활성화된다. 개발자가 할 일이 없다. Claude Code가 자동으로 슈퍼파워즈를 갖게 되는 것이다.
서브에이전트 기반 개발의위력
Superpowers의 또 다른 핵심은 Subagent Driven Development다. 각 태스크마다 새로운 서브 에이전트가 생성되어 컨텍스트가 격리된다. 태스크는 2~5분 단위로 TDD 프로세스를 반복한다. 각 태스크 완료 후에는 두 단계 리뷰가 수행된다. 먼저 스펙 준수 여부를 검증하고, 그 다음 코드 품질을 점검한다. 이 구조 덕분에 Claude가 몇 시간 동안 자율적으로 작업하면서도 초기 플랜에서 벗어나지 않는 것이 가능해진다.
AI 코딩 시대의 기획자 역할 재정의
AI 코딩 시대에서 진짜 병목은 "정확히 뭘 만들지 정의하는 것"이다. "기획 없이 그냥 만들어"로 대표되는 바이브 코딩 시대의 한계가 드러나면서, 스펙 드리븐 개발이 재평가되고 있다. 슈퍼파워즈는 이를 AI에게 구조적으로 강제하는 프레임워크로, 단순한 코딩 보조 도구를 넘어 AI 시대에 기획자의 역할을 재정의하는 도구라고 할 수 있다.
슈퍼파워즈가 개발자에게 제공하는 세 가지 핵심 가치도 명확하다. 첫째, AI가 합의 없이 폭주하지 않는다. 명시된 스펙만큼만 구현한다. 둘째, 모든 구현이 스펙의 어느 요구사항에서 왔는지 추적 가능하다. 셋째, 코드를 읽지 않고도 스펙 레벨에서 검증할 수 있다.
마무리
슈퍼파워즈는 2026년 5월 현재 Version 5.0.7을 유지하며, 최근 커밋은 Codex/OpenAI 플러그인의 자동 동기화와 여섯 개의 런타임 Claude Code, Cursor, Gemini CLI, OpenCode, Codex CLI, GitHub Copilot CLI에 걸친 확장 멀티플랫폼 지원을 목표로 하고 있다. MIT 라이선스로 무료로 제공되므로 비용 부담 없이 바로 도입할 수 있다.
AI가 코딩을 대신하는 시대, 남alaman의 경쟁력은 "무엇을 만들지"를 정확히 정의하는 기획력이다. 슈퍼파워즈는 그 기획력을 구조적으로 강화하는 도구다. 19만 스타가 증명하는 선택이다.
📚 출처
'AI 뉴스' 카테고리의 다른 글
| Zulip Foundation 설립 발표 — 개발자가 알아야 할 핵심 정리 (0) | 2026.05.17 |
|---|---|
| Apple M5에서 최초로 공개된 macOS 커널 메모리 손상 취약점 — 개발자가 알아야 할 핵심 정리 (0) | 2026.05.17 |
| DS4에 대한 몇 마디 — Redis 창시자가 만든 Metal용 DeepSeek V4 Flash 로컬 추론 엔진 (0) | 2026.05.16 |
| Tailwind에서 벗어나며 CSS 구조화 배우기 — 개발자가 알아야 할 핵심 정리 (0) | 2026.05.16 |
| LLM 생성 제출물은 금지되어야 한다 — arXiv 1년 정지부터 Lobsters.rs 논쟁까지 (0) | 2026.05.16 |