뭐부터 해야하는거임? superpowers

아니 난 바쁘잖아... 니가 좀 해줘

2026-09-28 · 참치

Claude Code에서 superpowers 쓰는 법: AI에게 "개발 순서"를 가르치는 플러그인

이 글은 superpowers 저장소(obra/superpowers)의 README와 제작자 Jesse Vincent의 블로그 글(2025년 10월 9일)을 읽고 정리했습니다. 저장소의 skills/ 폴더는 접근이 막혀서 개별 스킬 파일의 상세 내용은 읽지 못했습니다. 예시 대화는 설명을 위해 구성한 것이고 실제 출력이 아닙니다.

1. superpowers가 뭔가요?

Claude Code에게 "블로그에 태그 기능 만들어줘"라고 하면 바로 코드를 쓰기 시작합니다. 빠르지만 단점이 있습니다. 내가 원하는 것과 다르게 만들어지거나, 테스트 없이 만들어지거나, 만들다가 계획이 흔들립니다.

superpowers는 이 문제를 개발 순서(방법론)를 심어 주는 방식으로 해결하려는 플러그인입니다. README는 이렇게 소개합니다.

"Superpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them."

정리하면 "코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론"이고, 이것이 여러 개의 스킬 묶음으로 구성되어 있으며, 에이전트가 그 스킬을 쓰도록 만드는 초기 지침이 함께 들어 있습니다. GitHub의 한 줄 소개는 "An agentic skills framework & software development methodology that works"입니다.

철학 4가지

README의 "Philosophy" 항목입니다.

Test-Driven Development: "Write tests first, always" (테스트를 항상 먼저 쓴다)
Systematic over ad-hoc: "Process over guessing" (추측하지 말고 절차를 따른다)
Complexity reduction: "Simplicity as primary goal" (단순함이 최우선 목표)
Evidence over claims: "Verify before declaring success" (성공을 선언하기 전에 확인한다)

일반 사용과 무엇이 다른가요?

README는 이렇게 설명합니다. 무언가를 만든다고 하면 에이전트는 바로 코드를 쓰려 하지 않고, 먼저 내가 뭘 원하는지 묻고, 설계를 조각조각 나눠 보여 주며, 구현 계획을 씁니다. 그 계획은 진짜 레드/그린 TDD, YAGNI(필요 없는 건 만들지 않기), DRY(중복 줄이기)를 강조합니다. 내가 "진행해"라고 하면 서브에이전트가 작업을 이어받고, README는 이 상태로 "계획에서 벗어나지 않고 몇 시간 동안 자율적으로 일할 수 있다"고 말합니다.

제작자 블로그는 동작 원리를 이렇게 설명합니다. 시작할 때 모델에게 세 가지를 가르칩니다. 첫째, 너에게는 스킬이 있다. 둘째, 스킬을 찾아서 읽어라. 셋째, 어떤 작업에 맞는 스킬이 있으면 반드시 써라.

그래서 별도 명령 없이 스킬이 자동으로 발동합니다.

2. 설치하기 (Claude Code)

README는 "설치 방법은 도구마다 다르고, 여러 도구를 쓰면 각각 설치해야 한다"고 안내합니다. Claude Code에서는 두 가지 방법이 있습니다.

방법 A: 공식 마켓플레이스 (가장 간단)

Anthropic의 공식 마켓플레이스 이름은 claude-plugins-official입니다.

/plugin install superpowers@claude-plugins-official

방법 B: 제작자의 마켓플레이스

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

설치 확인

README의 확인 방법은 새 세션을 열고 이렇게 입력하는 것입니다.

Let's make a react todo list

제대로 설치되었다면 코드를 쓰기 전에 brainstorming 스킬이 먼저 발동해서 질문을 시작합니다. 제작자 블로그는 설치 후 claude를 껐다 다시 켜면, 시작 훅이 getting-started 스킬을 읽으라는 안내를 모델에게 주입한다고 설명합니다. README에는 Claude Code만을 위한 확인 명령이 따로 없습니다.

한국어로 "새 기능 만들어줘, 간단한 할 일 목록" 같은 요청을 해도 확인할 수 있습니다.

3. 기본 작업 흐름 7단계

README의 "Basic Workflow"를 기준으로 합니다. 단계마다 스킬이 자동으로 발동합니다.

순서	스킬	언제	하는 일
1	`brainstorming`	무언가 만들기 전	내가 정말 원하는 것과 이유를 질문으로 끌어냅니다. 작은 변경은 채팅으로 합의하고, 프로젝트는 설계 문서를 씁니다
2	`using-git-worktrees`	설계 승인 후	새 브랜치에 격리된 작업 공간을 만들고, 프로젝트 설정을 하고, 테스트가 깨끗한 상태인지 확인합니다
3	`writing-plans`	승인된 설계로	일을 2~5분짜리 작은 작업으로 쪼갭니다. 작업마다 정확한 파일 경로, 완성된 코드, 확인 절차가 들어갑니다
4	`subagent-driven-development` 또는 `executing-plans`	계획이 생기면	아래 "실행 방식 고르기" 참고
5	`test-driven-development`	구현 중	실패하는 테스트를 쓰고, 실패를 확인하고, 최소한의 코드를 쓰고, 통과를 확인하고, 커밋합니다. 테스트보다 먼저 쓴 코드는 지웁니다
6	`requesting-code-review`	작업과 작업 사이	계획과 비교해서 문제를 심각도별로 보고합니다. 심각한 문제는 진행을 막습니다
7	`finishing-a-development-branch`	작업이 끝나면	테스트를 확인하고, 병합/PR/유지/폐기 중에서 고르게 하고, 작업 공간을 정리합니다

4단계 실행 방식 고르기

README는 두 가지를 구분합니다.

subagent-driven-development(가장 꼼꼼함): 작업마다 새 서브에이전트가 맡고 매번 리뷰합니다. 두 단계 리뷰(계획 준수 확인, 코드 품질 확인)를 거칩니다.
executing-plans(가장 저렴함): 지금 세션 안에서 모든 작업을 처리하고, 마지막에 브랜치 전체를 한 번 리뷰합니다.

꼼꼼한 방식은 그만큼 사용량도 늘어난다고 보시면 됩니다. 이는 README 설명에서 제가 추론한 것이고 정확한 비율은 확인하지 못했습니다.

4. 스킬 전체 목록

README의 "What's Inside" 기준입니다. 이 세션에서 실제로 불러온 스킬 목록과도 이름이 일치합니다.

테스트

test-driven-development: 레드-그린-리팩터 사이클(테스트 안티패턴 참고서 포함)

디버깅

systematic-debugging: 4단계 근본 원인 분석(근본 원인 추적, 다중 방어, 조건 기반 대기 기법 포함)
verification-before-completion: 정말 고쳐졌는지 확인
diagnosing-superpowers: 세션에서 뭐가 잘못됐는지 증거와 함께 파악, 이슈 제출용 자료 만들기

협업

brainstorming: 만들기 전에 의도를 끌어내기
writing-plans: 상세 구현 계획
executing-plans: 한 세션에서 계획 실행, 마지막에 한 번 리뷰
dispatching-parallel-agents: 동시에 서브에이전트 돌리기
requesting-code-review: 리뷰 요청 전 점검표
receiving-code-review: 리뷰 피드백에 대응하기
using-git-worktrees: 병렬 개발 브랜치
finishing-a-development-branch: 병합/PR 결정 절차
subagent-driven-development: 두 단계 리뷰로 빠르게 반복

메타

writing-skills: 모범 사례를 따라 새 스킬 만들기(테스트 방법론 포함)
using-superpowers: 스킬 시스템 소개

README는 에이전트가 "어떤 작업이든 시작하기 전에 관련 스킬이 있는지 확인한다"고 설명합니다. 위 7단계에 없는 스킬(디버깅, 병렬 에이전트, 리뷰 응답 등)이 정확히 어떤 상황에서 발동하는지는 README에 명시되어 있지 않습니다.

슬래시 명령은?

README에는 /plugin 설치 명령 외에 따로 설명된 슬래시 명령이 없습니다. 제3자 마켓플레이스 페이지에는 /brainstorming 같은 호출이나 /execute-plan 명령이 소개되어 있지만, 저장소 문서로 확인하지는 못했습니다. 기본은 자동 발동이라고 생각하시면 됩니다.

5. 효율을 높이는 방법

저장소 설명에 근거한 것과 제 판단을 구분했습니다.

브레인스토밍 질문에 구체적으로 답합니다. 가장 효과가 큰 단계입니다(제 판단).
설계를 승인하기 전에 꼼꼼히 읽습니다. README는 설계가 조각으로 나온다고 설명하고, 방향 수정은 이 단계에서 하는 것이 가장 쌉니다(제 판단).
작업 크기에 맞게 실행 방식을 고릅니다. 큰 기능은 subagent-driven-development, 작은 작업은 executing-plans가 더 저렴합니다(README의 비교를 근거로 한 판단).
긴 세션은 새로 시작합니다. README는 Hermes에서 세션이 길어져 압축되면 시작 때 주입된 지침을 잃을 수 있어서 스킬이 안 걸리면 새 세션을 열라고 안내합니다. Claude Code에서도 같은 현상이 생기는지는 확인하지 못했습니다.
작은 수정까지 전체 절차를 거칠 필요는 없습니다. README는 작은 변경은 채팅으로 합의하고 큰 프로젝트만 설계 문서를 쓴다고 설명합니다. 또 using-superpowers에 포함된 규칙은 사용자의 직접 지시가 스킬보다 우선한다는 것입니다(이 세션에서 불러온 내용을 근거로 한 설명입니다). 그래서 "이건 간단한 수정이니까 바로 고쳐줘"라고 명시하면 됩니다.
이슈가 생기면 diagnosing-superpowers를 활용합니다. 반복 작업, 계획 무시, 스킬 미발동 같은 문제의 원인을 증거와 함께 분석하고 이슈 제출용 자료를 만들 수 있습니다.
필요 없는 데이터 전송은 끕니다. README는 브레인스토밍의 시각 도우미가 외부 사이트에서 로고를 불러오며 superpowers 버전이 함께 전달된다고 밝힙니다. 끄려면 환경 변수 SUPERPOWERS_DISABLE_TELEMETRY를 참 값으로 설정하면 되고, Claude Code의 DISABLE_TELEMETRY, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 설정도 따른다고 합니다.

8. 알아둘 점과 한계

속도는 느려질 수 있습니다. 바로 코드를 쓰지 않고 질문, 설계, 계획을 거치기 때문입니다. 대신 방향이 어긋나는 일이 줄어든다는 것이 이 도구의 가치입니다.
사용량이 늘 수 있습니다. 특히 작업마다 서브에이전트를 쓰는 방식은 더 많이 씁니다(README 설명을 바탕으로 한 추론).
다른 지침형 도구와 겹칠 수 있습니다. 예를 들어 "가장 최소한만 쓴다"는 성격의 ponytail과 계획·TDD를 강조하는 superpowers는 응답 방식이 겹칠 수 있습니다. 두 도구를 같이 쓴 결과는 확인하지 못했으니 하나씩 켜 보고 비교해 보세요.
저장소 정책: README는 새 스킬 기여를 일반적으로 받지 않고, 스킬 수정은 지원하는 모든 에이전트에서 동작해야 한다고 밝힙니다.
제작자가 인정하는 미완성: 블로그는 기억·공유 기능이 "아직 완전히 갖춰지지 않았다"고 말합니다.
정보의 시점: 저장소는 별 약 31만 개, 설치 수 약 100만으로 표시되어 있습니다(2026년 11월 4일 확인). 버전은 README에 명시되어 있지 않습니다.
라이선스: MIT입니다.

9. 한 줄 요약

superpowers는 AI에게 "바로 코딩하지 말고, 묻고, 설계하고, 계획하고, 테스트부터 쓰고, 검토하고, 확인하고 끝내라"는 개발 순서를 심어 주는 플러그인입니다. 설치는 한 줄이고, 설치한 뒤에는 평소처럼 요청하면 단계별로 자동 발동합니다. 작은 수정에는 "바로 고쳐줘"라고 말하면 됩니다.

참고 자료

{{ post.title }}