Superpowers — 코딩 에이전트가 스스로 설계·계획·TDD를 수행하는 완전 자동 개발 방법론

AI한테 '만들어줘' 한마디면 충분하다고 믿었던 시절

코딩 에이전트를 처음 써봤을 때의 기대감을 기억하시나요? '이거 만들어줘'라고 치면 뭔가 완성된 게 나올 것 같은 느낌. 실제론 달랐습니다. 맥락 없이 바로 코드를 뱉고, 설계는 없고, 테스트는 생략되고, 작업 중간에 방향이 흔들립니다. 에이전트가 '일을 잘못 이해한 채로 열심히' 하는 상황이 반복됩니다.

[]

Superpowers는 이 문제를 방법론 레이어에서 해결합니다. 도구를 바꾸는 게 아니라 에이전트가 일하는 방식 자체를 바꾸는 것이죠.

---

이 플러그인이 푸는 문제

코딩 에이전트의 가장 흔한 실패 패턴은 세 가지입니다.

첫째, 스펙 없이 시작합니다. 요청을 문자 그대로 받아서 바로 구현에 돌입합니다. 요구사항의 모호함은 코드가 나온 후에야 드러납니다.

둘째, 테스트를 나중으로 미룹니다. 동작하는 것처럼 보이는 코드를 먼저 짜고, 시간이 남으면 테스트를 추가합니다. 대부분 시간이 남지 않습니다.

셋째, 장기 작업에서 방향을 잃습니다. 처음 설계와 다른 방향으로 흘러가도 스스로 인지하지 못합니다.

Superpowers는 이 세 가지를 각각 brainstorming → writing-plans → test-driven-development 스킬로 구조적으로 막습니다. 그리고 이 워크플로는 강제입니다. 제안이 아니라 의무입니다.

---

핵심 동작 원리

Superpowers는 Claude Code의 플러그인 시스템 위에 동작하는 스킬 라이브러리입니다. README의 .claude-plugin/ 구조, plugin.json, /plugin install 명령어가 이를 확인시켜줍니다.

에이전트가 어떤 태스크를 시작하기 전에 관련 스킬을 먼저 확인합니다. 스킬은 트리거 조건을 가지고 있고, 조건이 맞으면 자동으로 활성화됩니다. 사용자가 수동으로 호출할 필요가 없습니다.

기본 워크플로는 이렇게 흐릅니다.

[요청 수신]
    ↓
 brainstorming — 스펙 확정 (섹션별 확인)
    ↓
 using-git-worktrees — 격리된 브랜치 생성
    ↓
 writing-plans — 2-5분 단위 태스크로 분해
    ↓
 subagent-driven-development — 서브에이전트 병렬 실행
    ↓
 test-driven-development — RED → GREEN → REFACTOR
    ↓
 requesting-code-review — 심각도별 이슈 리포트
    ↓
 finishing-a-development-branch — 머지/PR/폐기 결정

각 단계는 이전 단계의 산출물(설계 문서, 계획서)을 입력으로 받습니다. 사람이 'go'라고 할 때까지 다음 단계로 넘어가지 않습니다.

[]

---

설치 가이드

Claude Code 기준으로 두 가지 방법이 있습니다.

공식 마켓플레이스 (권장):

/plugin install superpowers@claude-plugins-official

Superpowers 자체 마켓플레이스:

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

설치 후 별도 설정은 없습니다. 스킬이 자동으로 활성화됩니다. 다른 코딩 에이전트(Cursor, Gemini CLI, Codex CLI 등)를 함께 쓴다면 각각에 별도로 설치해야 합니다. 하네스마다 설치 방법이 다릅니다.

[]

---

실전 시나리오

시나리오 1: 새 기능 개발

'결제 모듈 추가해줘'라고 입력한다고 가정합니다.

기존 에이전트: 바로 코드 작성 시작.

Superpowers 에이전트:
1. brainstorming 스킬 활성화 → '어떤 결제 수단을 지원할 건가요? PG사는? 환불 로직은?' 질문 시작
2. 스펙 확정 후 설계 문서 저장
3. git worktree로 격리 브랜치 생성
4. writing-plans가 태스크 단위로 분해: '결제 모델 정의 (2분)', 'PG 연동 인터페이스 작성 (5분)' 등
5. 서브에이전트가 태스크별로 실행, 각 완료 후 두 단계 리뷰 (스펙 준수 → 코드 품질)

# writing-plans 결과물 예시 구조
tasks = [
    {
        'id': 1,
        'title': '결제 모델 정의',
        'file': 'models/payment.py',
        'estimated_minutes': 2,
        'verification': 'pytest tests/test_payment_model.py'
    },
    # ...
]

시나리오 2: 버그 디버깅

systematic-debugging 스킬이 4단계 근본 원인 분석 프로세스를 강제합니다. 증상 → 가설 → 검증 → 수정 순서로 진행합니다. 'verification-before-completion'으로 수정됐다고 선언하기 전에 실제 검증을 요구합니다.

[]

---

언제 쓰면 안 되는가 / 트레이드오프

Superpowers의 구조화된 워크플로는 짧은 일회성 작업에는 오버헤드입니다. '이 함수 이름 바꿔줘' 수준의 요청에 brainstorming 단계가 활성화되면 오히려 느립니다.

또한 스킬이 자동으로 트리거되는 특성상, 명확한 스펙이 이미 있는 경우에도 스펙 확인 단계를 거치게 됩니다. 이미 상세한 PRD가 있는 팀이라면 이 단계가 중복으로 느껴질 수 있습니다.

성능 측면에서는 서브에이전트를 병렬로 실행하기 때문에 API 비용이 단일 에이전트 방식보다 높습니다. 자율 작업 시간이 길어지는 것과 비용 간의 트레이드오프를 판단해야 합니다.

---

같은 카테고리 대안 비교

Claude Code 기본 CLAUDE.md: 직접 작성한 지시사항으로 에이전트 동작을 커스텀할 수 있습니다. 유연하지만 방법론 전체를 설계해야 하는 부담이 있습니다. Superpowers는 이 설계 작업을 이미 해놓은 완성품입니다.

Aider: 코드 편집에 특화된 CLI 도구. TDD 강제나 서브에이전트 병렬 실행 같은 워크플로 레이어는 없습니다. 개별 편집 작업에는 빠르지만 장기 프로젝트 관리 기능은 Superpowers가 앞섭니다.

[]

---

마무리

Superpowers가 흥미로운 이유는 '더 좋은 AI 모델'이 아니라 '더 나은 작업 방식'으로 문제를 푼다는 점입니다. 모델의 한계를 방법론으로 보완하는 접근입니다.

README의 표현 그대로: '에이전트가 그냥 슈퍼파워를 갖게 됩니다.' 설치 후 사용자가 바꿀 게 없습니다.

다음 단계로는 Superpowers의 writing-skills 스킬로 팀 고유의 커스텀 스킬을 추가하는 방향을 탐색해볼 만합니다. 공통 패턴을 스킬로 만들면 팀 전체의 에이전트 워크플로를 표준화할 수 있습니다.

---

🐦 X에서 더 빠르게: @baegseungh7061
📚 이 시리즈 더 보기: AI 인사이트
💌 새 글 알림: X 팔로우 또는 블로그 RSS 구독