Superpowers 플러그인 — Claude Code에 14개 스킬을 주입하는 오픈소스 에이전트 프레임워크

Claude Code를 처음 써보면 금방 알게 되는 사실이 있다. 프롬프트를 던지면 일단 코드부터 짜기 시작한다는 것. 계획을 세우거나 질문을 먼저 하는 대신, 바로 파일을 열고 수정을 시작한다. 소규모 작업에서는 괜찮지만 복잡한 기능을 추가하거나 대규모 리팩토링을 할 때는 이 "일단 시작" 방식이 오히려 독이 된다.

Superpowers 플러그인은 이 문제를 정면으로 겨냥한 오픈소스 프레임워크다. Claude Code에 14개의 구조화된 스킬을 주입해서, 에이전트가 코드를 작성하기 전에 반드시 계획을 세우고 검증받도록 강제한다.

Claude Code의 기본 동작 문제

Claude Code는 강력하지만 방향을 잡아주지 않으면 같은 실수를 반복한다.

Superpowers는 이 네 가지를 한 번에 해결한다. 비유하면 건축 현장에 도면도 없이 벽돌부터 쌓기 시작하는 인부를 막고, 설계도를 먼저 그리게 하는 현장 감독 역할이다.

14개 스킬의 구조

Superpowers가 Claude Code에 주입하는 14개 스킬은 다섯 카테고리로 나뉜다.

각 스킬은 독립적으로 호출하거나 조합해서 쓸 수 있다. Implement 스킬 하나를 쓰더라도 그 내부에서 Test → Review 순서를 자동으로 따른다.

[💡 잠깐! 이 용어는?] 스킬(Skill): Superpowers 맥락에서 "스킬"은 Claude Code의 동작 방식을 정의하는 사전 작성된 워크플로우 명세다. CLAUDE.md 컨텍스트 시스템을 통해 주입되며, 별도의 API 호출이나 외부 서버 없이 작동한다.

7단계 워크플로우

Superpowers의 핵심은 7단계 워크플로우다. 이 단계를 강제로 따르게 하는 것이 플러그인의 가장 큰 가치다.

1. 브레인스토밍 — 질문부터

코드 작성 전에 에이전트가 명세를 구체화하기 위한 질문을 던진다. "로그인 기능 추가해줘"라고 하면 바로 파일을 열지 않고, "OAuth를 쓸 건가요? 세션 방식인가요? 이메일/비밀번호 방식도 함께 지원하나요?" 같은 질문이 먼저 나온다.

2. Git 셋업 — 격리된 작업 공간

작업마다 별도의 Git worktree를 생성한다. 메인 브랜치에 영향을 주지 않고 독립적인 환경에서 개발할 수 있다.

[💡 잠깐! 이 용어는?] Git Worktree: 하나의 Git 리포지토리에서 여러 작업 디렉터리를 동시에 운영하는 기능. 브랜치를 전환하지 않고도 다른 브랜치의 코드를 별도 폴더에서 편집할 수 있다.

3. 계획 수립 — 2~5분 단위 태스크

전체 작업을 2~5분짜리 작은 태스크로 분해한다. 이 단계에서 사람이 검토하고 승인한 뒤에야 다음으로 넘어간다.

4. 서브에이전트 디스패치

각 태스크마다 신선한 서브에이전트를 생성해서 작업을 할당한다. 에이전트별로 컨텍스트가 격리되기 때문에 이전 작업의 편향이 섞이지 않는다.

5. TDD 구현 — 테스트가 먼저

테스트를 먼저 작성하고(RED), 통과하는 구현을 추가하고(GREEN), 리팩토링한다(REFACTOR). 이 사이클을 강제한다.

# 1. Plan 스킬 → 구현 계획 수립
/skill plan "사용자 인증 모듈 추가"
 
# 2. Test 스킬 → 실패하는 테스트 먼저
/skill test --mode red
 
# 3. Implement 스킬 → 통과하는 구현
/skill implement
 
# 4. Review 스킬 → 코드 검토
/skill review

6. 코드 리뷰 — 명세 대조

구현이 끝나면 초기 명세와 대조해서 검증한다. 요구사항을 벗어난 코드를 이 단계에서 걸러낸다.

7. 브랜치 완료 — 정리

머지와 브랜치 정리까지 자동으로 처리한다.

설치 방법

두 가지 방식이 있다.

npm install -g claude-code-superpowers
superpowers init

/plugin install superpowers@claude-plugins-official

superpowers init을 실행하면 프로젝트의 CLAUDE.md에 스킬 정의가 자동으로 추가된다. 별도 서버나 API 키 설정이 필요 없다.

{
  "plugins": {
    "superpowers": {
      "version": "latest",
      "skills": "all",
      "workflow": "seven-phase"
    }
  }
}

실제 효과 — 토큰 40~60% 절감

Superpowers가 내세우는 수치 중 가장 눈에 띄는 것은 토큰 절감이다. 대규모 리팩토링이나 기능 추가 작업에서 비구조적 실행 대비 40~60% 토큰을 줄일 수 있다고 한다.

원리는 단순하다. 계획 없이 코드베이스를 탐색하면 에이전트가 필요 없는 파일까지 읽는다. 하지만 Plan 스킬로 먼저 구조를 잡으면 정확히 필요한 파일만 접근한다. 비유하면 도서관에서 책을 찾을 때 서가를 처음부터 끝까지 훑는 것과, 목차에서 위치를 먼저 확인하고 바로 가는 것의 차이다.

(수치는 프로젝트 규모와 복잡도에 따라 크게 달라질 수 있다.)

어떤 상황에서 쓸 만한가

Superpowers가 모든 상황에서 이득인 건 아니다.

쓸 만한 경우:

• 기능 추가가 여러 파일에 걸쳐 있을 때
• 팀 전체가 AI 코딩 워크플로우를 통일하고 싶을 때
• API 비용이 문제가 되는 대규모 프로젝트
• 장시간 자율 실행이 필요한 작업

굳이 필요 없는 경우:

• 단일 파일 버그 수정 같은 단순 작업
• 빠른 프로토타이핑이 목적인 실험
• 혼자서 소규모 프로젝트를 운영할 때

마무리

Superpowers는 Claude Code의 기능을 확장하는 것이 아니라 동작 방식을 바꾸는 플러그인이다. "무엇을 할 수 있나"가 아니라 "어떻게 할 것인가"를 정의한다.

• 즉시 구현을 막고 → 계획을 강제한다
• 범위 확장을 막고 → 태스크 단위 격리를 적용한다
• 토큰 낭비를 막고 → 목적 지향적 탐색을 유도한다

Claude Code를 진지하게 쓰는 팀이라면 한 번 시도해볼 가치가 있다. 설치 자체는 npm install 한 줄이고, 마음에 안 들면 CLAUDE.md에서 스킬 정의를 지우면 원상복구된다.

참고:

• obra/superpowers GitHub: https://github.com/obra/superpowers
• Claude 플러그인 마켓플레이스: https://claude.com/plugins
• Superpowers 마켓플레이스: https://github.com/obra/superpowers-marketplace