Claude Code는 기본적으로도 강력하지만, 구조가 없으면 계획도, 테스트도, 체계적인 접근 방식도 없이 바로 코딩에 뛰어듭니다. Superpowers 플러그인은 혼란을 방지하는 검증된 개발 워크플로우를 강제 적용하여 이 문제를 해결합니다.
Superpowers가 실제로 하는 일
Superpowers는 핵심 순간에 Claude Code를 가로채는 스킬 프레임워크입니다. 무언가를 요청했을 때 즉시 코드를 작성하는 대신, 먼저 멈춰서 질문을 합니다. 그런 다음 TDD를 강제하고, 구현 계획을 만들고, 다음 단계로 넘어가기 전에 자체 작업을 검토합니다.
핵심 워크플로우:
- Brainstorm: 소크라테스식 질문을 통해 아이디어를 다듬습니다
- Plan: 정확한 파일 경로와 함께 작은 단위의 작업(각 2-5분)을 생성합니다
- Execute: 2단계 검토를 거쳐 작업별로 서브에이전트를 배치합니다
- Finish: 테스트를 검증하고, PR/병합 옵션을 제공하며, 정리합니다
설치 (10초)
bash
플러그인 메뉴 열기
/plugin
"Discover" 탭으로 이동
"superpowers" 검색
선택 후 설치
설치 후 Claude Code를 재시작하세요. "SessionStart:startup hook succeeded: Success" 메시지가 표시되면 플러그인이 활성화된 것입니다.
설치되는 구성 요소
플러그인은 필요한 모든 것을 포함합니다:
| 구성 요소 | 포함 내용 |
|---|---|
| Commands | execute-plan, write-plan, brainstorm |
| Agents | code-reviewer |
| Skills | TDD, 디버깅, git worktrees, 코드 리뷰 등 14개 스킬 |
| Hooks | SessionStart (워크플로우 자동 부트스트랩) |
세 가지 핵심 명령어
/superpowers:brainstorm
새로운 기능을 시작하기 전에 사용하세요. Claude는:
- 목표에 대한 명확한 질문을 합니다
- 고려하지 못했던 대안을 탐색합니다
- 검증을 위해 디자인을 이해하기 쉬운 단위로 제시합니다
- 참고용 설계 문서를 저장합니다
실행 시점: 모든 기능, 리팩토링 또는 마이그레이션의 시작 시점.
/superpowers:write-plan
브레인스토밍 후, 다음과 같은 구현 계획을 생성합니다:
- 각 작업은 최대 2-5분 소요
- 모든 작업에 정확한 파일 경로와 완전한 코드 스니펫 포함
- 각 작업에 검증 단계가 내장됨
- 계획은 "맥락이 전혀 없는 열정적인 주니어 엔지니어"가 실행할 것을 가정합니다
/superpowers:execute-plan
서브에이전트 기반 개발을 사용하여 계획을 실행합니다:
- 작업당 새로운 서브에이전트 생성(깨끗한 컨텍스트)
- 2단계 검토: 사양 준수, 그 다음 코드 품질
- 배치 간 사람의 체크포인트
- 중요한 문제는 자동으로 진행을 차단
14가지 스킬 설명
| 스킬 | 기능 |
|---|---|
| test-driven-development | RED-GREEN-REFACTOR 강제 적용. 테스트 전에 작성된 코드 삭제. |
| systematic-debugging | 심층 방어를 갖춘 4단계 근본 원인 프로세스 |
| using-git-worktrees | 격리된 브랜치 생성, 설정 실행, 깨끗한 베이스라인 검증 |
| using-superpowers | 스킬 시스템 소개 |
| dispatching-parallel-agents | 동시 서브에이전트 워크플로우 |
| executing-plans | 체크포인트를 포함한 배치 실행 |
| finishing-a-development-branch | 병합/PR/유지/삭제 옵션, 정리 |
| brainstorming | 소크라테스식 설계 개선 |
| writing-plans | 상세한 구현 계획 수립 |
| requesting-code-review | 사전 검토 체크리스트, 중요 문제 시 차단 |
| receiving-code-review | 체계적인 피드백 대응 |
| writing-skills | 새로운 스킬 생성을 위한 메타 스킬 |
| verification-before-completion | 수정 사항이 실제로 작동하는지 확인 |
| subagent-driven-development | 작업당 2단계 검토 |
스킬이 자동으로 실행되는 방식
스킬은 호출하는 명령어가 아니라 컨텍스트에 따라 활성화됩니다:
- 새로운 기능 논의 시작 → brainstorming 활성화
- 설계 승인 → using-git-worktrees 활성화
- 구현 시작 → test-driven-development 활성화
- 작업 완료 → requesting-code-review 활성화
- 모든 작업 완료 → finishing-a-development-branch 활성화
Claude는 모든 작업 전에 관련 스킬을 확인합니다. 이것들은 제안이 아닌 필수 워크플로우입니다.
Git worktree 통합
Superpowers는 격리된 개발을 위해 git worktrees를 사용합니다: bash
백그라운드에서 일어나는 일:
git worktree add ../project-feature feature-branch cd ../project-feature
Claude가 여기서 작업하고, main 브랜치는 깨끗하게 유지됩니다
장점:
- 여러 Claude 인스턴스를 다른 기능에서 실행
- 실험 중에도 main 브랜치를 안정적으로 유지
- 문제 발생 시 쉬운 정리
서브에이전트 기반 개발
가장 강력한 패턴입니다. 하나의 긴 Claude 세션 대신:
- 메인 에이전트가 계획을 생성
- 새로운 서브에이전트가 각 작업을 실행
- 검토 에이전트(code-reviewer)가 작업을 확인
- 메인 에이전트가 계속 진행하거나 수정을 요청
이것이 효과적인 이유: 각 서브에이전트는 하나의 작업에 집중된 깨끗한 컨텍스트로 시작합니다. 긴 세션에서 누적된 혼란이 없습니다.
TDD 강제 적용
Superpowers는 TDD를 진지하게 받아들입니다. 스킬은:
- 구현 전에 실패하는 테스트를 요구합니다
- 테스트가 실패하는 것을 확인합니다(무언가를 테스트한다는 것을 증명)
- 통과하기 위한 최소한의 코드를 구현합니다
- 통과 시점에 커밋합니다
- 통과 후에만 리팩토링합니다
Claude가 테스트 전에 코드를 작성하면, 스킬은 해당 코드를 삭제하고 다시 시작하도록 지시합니다.
실제 예시
당신: Express 앱에 사용자 인증이 필요해
Claude (Superpowers 사용): → brainstorming 스킬 활성화 → 질문: OAuth인가요 비밀번호인가요? 세션인가요 JWT인가요? 어떤 제공자를 사용하나요? → 탐색: 속도 제한? 계정 잠금? 비밀번호 요구사항? → 승인을 위해 섹션별로 설계를 제시
당신: 좋아 보여, 계획을 세워봐
Claude: → writing-plans 스킬 활성화 → 각 2-5분 소요되는 12개 작업 생성 → 작업 1: /signup 엔드포인트에 대한 실패하는 테스트 생성 → 작업 2: 테스트를 통과하도록 signup 핸들러 구현 → 각 작업에 정확한 파일 경로와 코드 포함
당신: 실행해
Claude: → 작업 1을 위한 서브에이전트 생성 → code-reviewer 에이전트가 결과물 검증 → 작업 2를 위한 서브에이전트 생성 → 진행 상황 보고, 계속 진행 승인 요청
플러그인 관리
/plugin 메뉴에서 다음을 수행할 수 있습니다:
- Disable plugin: 일시적으로 끄기
- Mark for update: 다음 업데이트 주기에 플래그 지정
- Update now: 최신 버전 즉시 가져오기
- Uninstall: 완전히 제거
- View on GitHub: 소스 코드 보기
Superpowers를 사용하지 말아야 할 때
- 간단한 일회성 질문
- 단순한 파일 편집
- 5분 미만의 작업
이런 경우에는 오버헤드가 가치가 없습니다. Superpowers는 체계적인 실행이 필요한 다중 파일 기능, 리팩토링, 마이그레이션에서 빛을 발합니다.
빠른 참조
| 작업 | 방법 |
|---|---|
| 설치 | /plugin → Discover → superpowers |
| 설계 시작 | /superpowers:brainstorm |
| 계획 생성 | /superpowers:write-plan |
| 계획 실행 | /superpowers:execute-plan |
| 업데이트 | /plugin → superpowers 선택 → Update now |
Superpowers는 Claude Code를 "가끔 궤도를 벗어나는 도움이 되는 조수"에서 "검증된 프로세스를 따르는 체계적인 개발 파트너"로 변신시킵니다. 구조화된 워크플로우는 가장 흔한 실패 모드인 테스트 건너뛰기, 엣지 케이스 누락, 요구사항에서 벗어나는 기능을 방지합니다.
