🔥 02. superpowers: 스킬 기반 개발 방법론

superpowers는 “에이전트에게 코드를 시킨다”를 넘어서, 에이전트가 어떻게 설계하고 계획하고 테스트하고 리뷰해야 하는지까지 강제하는 스킬 프레임워크다. 좋은 답변이 아니라 좋은 개발 루프를 만든다는 점이 핵심이다.

이 레포는 2위 · ⭐ +19.2K로 회자된 프로젝트다. 별 숫자만 보면 유행처럼 보일 수 있지만, 실제로는 개발자들이 지금 어디에 시간을 쓰고 있는지를 꽤 솔직하게 드러낸다. 요즘 에이전트 코딩이 가장 많이 흔들리는 지점은 처음 5분이다. 바로 코드를 찍기 시작하면 금방 산으로 간다. superpowers는 그 초반을 설계 문서, 짧은 검토 가능한 계획, TDD, 코드 리뷰, 브랜치 마무리 순서로 묶어버린다. 그래서 팀 입장에서는 “잘 쓴 프롬프트”보다 “덜 흔들리는 프로세스”로 보인다.

flowchart LR
A[문제] --> B[superpowers]
B --> C[설치]
C --> D[최소 실험]
D --> E[업무 적용 판단]

칠판 판서형 치트시트

• 이 레포의 한 줄 키워드는 superpowers다.
• 이번 보강에서는 설치와 사용 순서를 공식 README 기준으로 더 촘촘하게 정리했다.
• 읽을 때는 전제 조건 → 설치 → 첫 실행 → 검증 순서로 보면 된다.
• “대단해 보인다”보다 “내 업무에서 반복 비용을 줄이는가”를 먼저 본다.

이 레포를 한 줄로 보면

superpowers는 “에이전트에게 코드를 시킨다”를 넘어서, 에이전트가 어떻게 설계하고 계획하고 테스트하고 리뷰해야 하는지까지 강제하는 스킬 프레임워크다. 좋은 답변이 아니라 좋은 개발 루프를 만든다는 점이 핵심이다.

왜 지금 이 레포가 뜨는가

요즘 에이전트 코딩이 가장 많이 흔들리는 지점은 처음 5분이다. 바로 코드를 찍기 시작하면 금방 산으로 간다. superpowers는 그 초반을 설계 문서, 짧은 검토 가능한 계획, TDD, 코드 리뷰, 브랜치 마무리 순서로 묶어버린다. 그래서 팀 입장에서는 “잘 쓴 프롬프트”보다 “덜 흔들리는 프로세스”로 보인다.

레포 안에서 먼저 볼 것

• brainstorming, writing-plans, test-driven-development, requesting-code-review 같은 스킬 번들
• 설계 승인 후 작업 분해, 서브에이전트 실행, 리뷰, 브랜치 마무리까지 이어지는 전체 흐름
• Claude·Cursor·Codex·OpenCode·Gemini 등 여러 하니스에 맞춘 설치 경로

설치 전에 확인할 것

• 사용 중인 코딩 하니스가 무엇인지 먼저 정하기
• 새 세션을 열 수 있는 상태일 것(대부분 새 세션에서 스킬 인식이 쉬움)
• 짧은 기능 추가나 버그 수정처럼 실험 대상 작업 1개 준비

설치 방법

공식 확인 링크

• GitHub README: https://github.com/obra/superpowers
• Codex 상세: https://github.com/obra/superpowers/blob/main/docs/README.codex.md
• OpenCode 상세: https://github.com/obra/superpowers/blob/main/docs/README.opencode.md

Claude Code 설치

공식 마켓플레이스가 열려 있으면 아래 한 줄이 가장 빠르다.

/plugin install superpowers@claude-plugins-official

마켓플레이스 등록 방식이라면 먼저 아래를 실행한다.

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

설치 후에는 새 세션을 열어야 자동 스킬 탐지가 깔끔하게 동작한다.

Cursor · Codex · OpenCode · Gemini CLI

Cursor Agent chat에서는 아래처럼 설치한다.

/add-plugin superpowers

Codex는 설치 지시문 자체를 따라가게 설계돼 있다.

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md

OpenCode도 같은 방식이다.

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

Gemini CLI는 확장처럼 설치한다.

gemini extensions install https://github.com/obra/superpowers
gemini extensions update superpowers

설치 확인

• 새 세션에서 help me plan this feature 같은 말을 던졌을 때 brainstorming 계열 흐름이 자동으로 붙는지 본다.
• let's debug this issue처럼 분명한 작업을 넣었을 때 관련 skill이 자동 트리거되면 정상이다.

사용 방법

1. 새 세션에서 만들고 싶은 기능이나 고치고 싶은 문제를 자연어로 설명한다.
2. 에이전트가 바로 코드를 쓰기보다 요구를 되묻고 설계 초안을 제시하는지 본다. 이 단계가 brainstorming이다.
3. 설계를 승인하면 writing-plans가 작게 쪼갠 작업 목록을 만든다.
4. 그다음 구현 단계에서 TDD, 코드 리뷰, 브랜치 정리까지 이어지는지 확인한다.

superpowers의 진짜 사용법은 명령 남발이 아니라 작업 흐름을 자동으로 타게 만드는 것이다. 공식 README 기준 기본 흐름은 아래 7단계다.

1. brainstorming
2. using-git-worktrees
3. writing-plans
4. subagent-driven-development 또는 executing-plans
5. test-driven-development
6. requesting-code-review
7. finishing-a-development-branch 처음 실험에서는 이 7단계를 모두 다 쓰려 하지 말고, brainstorming → writing-plans → test-driven-development가 실제로 이어지는지만 먼저 확인하면 된다.

어디에 바로 써먹을 수 있나

사례 A. 기능 추가 작업

사이드프로젝트에서 결제 페이지를 붙일 때, 바로 구현부터 들어가면 검증이 뒤로 밀린다. superpowers 흐름대로 먼저 요구를 정리하고 짧은 계획으로 쪼개면, 각 단계가 끝날 때마다 확인할 수 있어서 되돌림 비용이 확 줄어든다.

사례 B. 디버깅 작업

에러 한 번 고쳐보려고 이것저것 손대는 팀에서는 systematic-debugging 계열 스킬이 특히 유용하다. 추측이 아니라 원인 추적 순서를 고정해주기 때문에, 비슷한 버그를 반복해서 밟을 확률이 줄어든다.

처음 해볼 최소 실험

1. 버그 수정이나 작은 기능 추가 하나를 고른다.
2. 새 세션에서 문제를 설명하고 brainstorming이 발동하는지 확인한다.
3. 설계 승인 후 작업이 2~5분 단위 계획으로 쪼개지는지 본다.
4. 구현 후 코드 리뷰까지 자연스럽게 이어지는지 점검한다.

검증 포인트는 간단하다. 작업이 끝났을 때 코드 양보다 계획 대비 이탈이 얼마나 적었는지 본다. 계획 문서와 최종 변경 파일이 크게 다르면 프로세스가 아직 정착되지 않은 것이다.

볼 때 주의할 점

• 아주 작은 수정에는 오히려 과할 수 있다. 모든 일에 풀코스 프로세스를 붙이면 느려진다.
• 스킬이 있다고 해서 자동으로 좋은 설계가 나오진 않는다. 승인 단계에서 사람 판단이 여전히 중요하다.
• TDD를 강제하는 흐름이 익숙하지 않으면 초반에는 답답하게 느껴질 수 있다.

다음 읽기

• 🔥 01. agency-agents
• 🔥 09. Deep Agents
• 59. 에이전트 말고 스킬부터

이 글은 AI를 활용해 초안을 정리했고, GitHub README와 공식 링크를 다시 확인해 실무 적용 관점으로 풀어썼다.