~ AI를 일시키는 법 ! Superpowers 🦸

같은 Claude Code를 쓰는데 생산성이 3배씩 차이 나는 이유는 ??

엔지니어링 문화를 마크다운으로 배포하는 플러그인을 해부한다

(이전에 작성했던 bkit 플러그인 글의 superpowers 버전입니다 !)

 

1.  왜 같은 AI를 써도 결과가 다를까 ??

2026년 현재, 대부분의 개발자는 이미 Claude Code 같은 AI 에이전트를 활용하고 있다.

함수 작성, 에러 수정, 리팩토링까지 — AI가 개발을 빠르게 만들어준다는 건 사실이다. 그런데 이상한 현상이 있다.

 

같은 AI를 쓰는데도 어떤 개발자는 생산성이 2~3배씩 올라가고, 어떤 개발자는 "그냥 조금 편해진 정도"에 머문다.

💡 핵심 질문: 이 차이는 AI의 성능에서 오는가? 아니다. AI를 어떻게 사용하느냐에서 온다. 더 정확히는, AI에게 어떤 구조와 방법론을 적용하느냐의 차이다.

대부분의 개발자가 빠지는 함정은 "검색 패턴"

실무에서 흔히 관찰되는 AI 사용 패턴은 다음과 같다.

막힘 → AI에게 질문 → 답변 복붙 → 다시 막힘 → 반복...

 

 

이 접근법의 문제는 명확하다.

컨텍스트가 매번 끊기고, 같은 질문을 반복하게 되며, AI는 매 대화마다 프로젝트 전체 구조를 모르는 채로 답변한다.

결과적으로 AI를 "똑똑한 검색엔진" 수준으로만 활용하게 된다.

⚠️ 실제 비용: Superpowers의 분석에 따르면, 이 방식은 전체 토큰의 90%를 코드 생성 단계에 쏟아붓고, 결과물이 기대와 다르면 처음부터 다시 대화를 시작한다. 계획 없이 코드를 먼저 짜기 때문이다.

2. 패러다임 전환 ->> AI를 "질문 대상"에서 "작업자"로

생산성이 크게 뛰는 개발자들은 접근 방식이 근본적으로 다르다. 그들은 AI를 질문하는 대상이 아니라 일을 시키는 대상으로 바라본다.

 

 

이 전환을 가능하게 해주는 것이 바로 Superpowers 플러그인이다.

 

3. Superpowers 해부

엔지니어링 문화를 마크다운으로 배포하다

Superpowers는 Jesse Vincent가 만든 오픈소스 플러그인이다.

2025년 10월 등장해 7개월 만에 GitHub 스타 17만 개를 돌파했다.

Anthropic 공식 마켓플레이스에도 등재되어 있다.

💬 핵심 철학 > "AI 코딩 에이전트에게 부족한 것은 능력이 아니라 규율(discipline)이다. 그리고 규율은 마크다운 파일로 배포할 수 있다."

작동 원리 ⭕️ 14개의 Skill이 Claude를 바꾼다

Superpowers는 skills/ 디렉토리 아래에 14개의 SKILL.md 파일을 설치한다.

각 파일은 Claude가 특정 작업을 할 때 따라야 하는 방법론을 정의한다.

설치 즉시, 마스터 디스패처 스킬(using-superpowers)이 모든 대화 시작 시 자동으로 활성화되어 요청 유형에 따라 적절한 스킬을 라우팅한다.

 

"대시보드 만들어줘" → clarify → visual-companion → design → plan → code → verify
"버그 잡아줘"       → debug(4단계) → verify

핵심 워크플로우 5단계

 

 

TDD 강제 메커니즘

Superpowers의 TDD는 단순한 권장 사항이 아니다.

테스트가 반드시 먼저 실패해야 다음 단계로 넘어갈 수 있다.

# 1. RED: 실패하는 테스트 먼저 작성
#    → 테스트가 통과하면 멈추고 확인 요청 (이미 구현이 있거나 테스트가 잘못된 경우)

# 2. GREEN: 테스트를 통과하는 최소한의 코드만 작성
#    → YAGNI 원칙: 필요하지 않은 것은 만들지 않는다

# 3. REFACTOR: 코드 정리 (테스트 통과 유지 확인)
#    → DRY 원칙 적용

# ⚠ 같은 버그를 3번 연속 수정 실패 시:
#   → 자동으로 아키텍처 리뷰 트리거
#   → "단순 버그가 아니라 설계 문제일 수 있음"

Superpowers v5의 새 기능: 적대적 스펙 리뷰

v5(2026년 3월)부터는 별도의 서브에이전트가 구현 시작 전에 스펙을 검토한다.

"TBD"로 남겨진 섹션, 에러 처리가 빠진 부분, 모호한 인터페이스 정의를 잡아낸다.

코드 한 줄 작성 전에 스펙 레벨에서 구멍을 막는다.

📊 비용 절감 효과 > 복잡한 태스크에서 토큰 사용량 14% 감소, 비용 9% 절감 측정. 사전 계획 단계(Phase 1~3)가 저렴한 텍스트 처리인 반면, 계획 없이 진행하면 비싼 코드 생성(Phase 4)을 반복해야 하기 때문이다.

Superpowers의 강점 🧡 플랫폼 독립성

Superpowers는 Claude Code 전용이 아니다. 동일한 skills/ 디렉토리가 아래 모든 플랫폼에서 동작한다.

• Claude Code
• Cursor
• OpenAI Codex CLI / App
• GitHub Copilot CLI
• Gemini CLI
• OpenCode

각 에이전트 호스트는 자신만의 매니페스트(.claude-plugin/, .cursor-plugin/ 등)를 갖지만, 스킬 파일 자체는 호스트에 독립적이다.

특정 AI 도구에 종속되지 않는 "이식 가능한 엔지니어링 문화"다.

(공식 플러그인은 클로드코드 & 코덱스에 있다 - 마켓플레이스 기준)

 

4. 실무 전략

언제 Superpowers를 써야 하나

Superpowers는 복잡도와 품질이 중요한 상황에서 가장 빛난다.

반대로 10줄짜리 유틸 함수에 전체 브레인스토밍 플로우를 돌리는 건 오버엔지니어링이다.

적합한 상황 ??

• 초기 개발 (탐색·속도 중심) — 요구사항이 불명확할 때 브레인스토밍으로 스펙 정련, 서브에이전트로 빠른 구현
• 대규모 리팩토링 — 코드베이스 전체 영향 변경, 마이크로 태스크 분해 + 병렬 처리
• 복잡한 피처 개발 — 품질 중심, TDD 강제 메커니즘으로 안정성 확보

실제 예시로는 "API 응답 구조가 바뀌었다. 프론트엔드 전체에 반영해야 한다."

 

"프로젝트 전체에서 이 API 사용하는 부분 찾아서 새 구조로 바꿔줘"

→ 브레인스토밍 스킬이 영향 범위 먼저 파악
→ 계획서 작성 후 서브에이전트 병렬 실행
→ 각 수정마다 TDD로 검증
→ 수십 개 파일도 몇 시간 내 처리

 

설치 명령어

# Superpowers (공식 마켓플레이스)
/plugin install superpowers@claude-plugins-official

# 설치 확인
/plugin list
# → superpowers 표시되어야 함

5. 생산성 데이터

실제로 얼마나 빨라지나

 

⚠️ 중요한 맥락: 이 수치는 복잡도가 높은 태스크에서 극적으로 효과가 크다. 복잡한 멀티스텝 개발 워크플로우에서 일관성이 중요할 때, 장기 세션에서 API 비용을 줄이고 싶을 때, 팀이 표준화된 AI 지원 개발 관행을 원할 때 가장 유용하다.

6. 결론....

Superpowers가 던지는 진짜 질문은 "규율 접근법이 작동하는가"가 아니다.

그것은 이미 증명되었다.

진짜 질문은,,, 엔지니어링 문화의 어떤 부분들이 AI 에이전트가 따를 수 있는 마크다운으로 표현 가능한가?

코드 리뷰 스타일, 온콜 런북, 보안 자세, 릴리즈 관리까지.

 

AI를 잘 쓰는 사람은 AI에게 질문하지 않는다.

그들은 AI에게 구조화된 역할과 명확한 컨텍스트를 주고, 반복 가능한 프로세스 안에서 작업을 위임한다.

"AI를 잘 쓰는 사람은 질문하지 않는다 — 일을 시킨다"
그리고 일을 시키려면, 먼저 일의 구조가 있어야 한다.