AI 코딩 에이전트에 '두뇌'를 심다 — obra/superpowers 완전 분석

하루 만에 별 931개. obra/superpowers가 GitHub 트렌딩 최상위권에 올라섰다. 누적 226,000개를 넘긴 이 프로젝트는 Claude Code·Cursor·Codex 같은 AI 코딩 에이전트에 "올바르게 일하는 방식"을 심는 방법론 프레임워크다. 에이전트가 묻지도 따지지도 않고 코드부터 짜는 게 지긋지긋하다면, 읽을 가치가 있다.

이게 뭔가

에이전트에게 새 기능을 맡기면 보통 이렇다 — 요구사항 확인 없이 바로 코드를 쏟아낸다. Superpowers는 이 패턴을 Shell 스크립트로 짜인 프롬프트·지침 모음으로 바꾼다. 설치하면 에이전트가 다음 흐름을 자동으로 밟는다:

1. 스펙 수집 — 코딩 전에 "뭘 만드려 해?"를 먼저 물어 요구사항을 정리한다
2. 설계 확인 — 짧은 청크로 설계안을 보여주고 사용자 승인을 받는다
3. 구현 계획 — 판단력 없는 주니어도 따를 수 있는 명확한 태스크 목록을 만든다
4. 서브에이전트 실행 — 각 태스크를 서브에이전트가 처리·검토하며 순차 진행한다

TDD, YAGNI, DRY가 기본값으로 적용된다. 기술 자체는 단순한 Shell이지만, 효과는 에이전트의 사고 구조를 바꾼다.

왜 지금 뜨는가

2025~2026년은 AI 코딩 에이전트가 명실상부 주류가 된 시기다. 문제는 에이전트를 그냥 켜면 몇 시간을 엉뚱한 방향으로 달린다는 것 — 계획 없는 자율성은 낭비다. Superpowers는 그 공백을 방법론으로 메운다.

폭발의 직접 촉매는 Anthropic 공식 Claude 플러그인 마켓플레이스 입점이다. /plugin install 한 줄로 설치가 끝나는 순간 진입 장벽이 사라졌다. Claude Code 사용자 기반 확장과 맞물려 별이 쏟아지고 있다.

핵심 기능

• 자동 트리거: 별도 명령 없이 프로젝트 시작 시 자동으로 개입한다
• 서브에이전트 기반 개발: 큰 기능을 독립 태스크로 쪼개 각각 서브에이전트가 처리·검토. README에 따르면 Claude가 별도 개입 없이 수 시간 자율 작업하는 것이 드물지 않다고 한다
• 컴포저블 스킬: 스킬을 조합해 커스텀 워크플로우 구성 가능
• 멀티 하네스 지원: Claude Code, Codex CLI, Codex App, Gemini CLI, Cursor, GitHub Copilot CLI 모두 지원

누구에게 쓸모 있나

• 에이전트가 계획 없이 코드부터 짜는 것이 반복되는 개발자
• 큰 기능을 에이전트에게 맡기고 수 시간 후 결과를 받고 싶은 팀
• Claude Code·Cursor를 쓰지만 일관된 개발 워크플로우가 없는 사람

단발성 수정이나 짧은 질의응답 위주라면 굳이 필요 없다.

시작하기

에이전트 환경(하네스)마다 설치법이 다르다. 두 개 이상 쓴다면 각각에 따로 설치해야 한다. 전체 가이드는 README에서 확인한다.

Claude Code — 공식 마켓플레이스 (가장 빠른 방법)

/plugin install superpowers@claude-plugins-official

Claude Code — Superpowers 자체 마켓플레이스 경유 마켓플레이스 등록 후 설치하는 방식도 지원한다. 전체 명령은 README의 해당 섹션을 참고한다.

Codex CLI · Gemini CLI · Cursor 등 하네스마다 방식이 다르다. 레포의 각 하네스 섹션에서 확인한다.

사용 예시

설치 후 에이전트를 평소대로 쓰면 된다. Superpowers는 개발 작업을 감지하는 순간 자동으로 개입한다.

① 기능 요청 — 에이전트가 코드 대신 스펙을 먼저 묻는다

> 사용자 인증 기능 추가해줘.

[Agent] 먼저 몇 가지 확인할게요.
        소셜 OAuth인가요, 이메일/비밀번호 방식인가요?
        세션 기반인가요, JWT 토큰 방식인가요?

② 설계 승인 후 구현 태스크 목록 자동 생성

[설계 확인 완료. 구현 태스크:]
1. users 테이블 마이그레이션 작성
2. bcrypt 비밀번호 해싱 유틸 추가
3. /auth/register POST 엔드포인트 구현
4. /auth/login POST + JWT 발급 구현
5. 인증 미들웨어 연결
승인하면 시작합니다.

③ 서브에이전트 자율 실행 — 사용자는 "go" 한 마디

# 각 태스크를 서브에이전트가 처리·검토하며 순차 진행한다
go

한계·주의

• 모델 품질이 바닥을 결정한다: Superpowers는 방법론이지 마법이 아니다. 기반 에이전트가 약하면 결과도 약하다
• 하네스별 별도 설치 필수: Claude Code에 설치해도 Cursor에서는 다시 설치해야 한다
• "수 시간 자율 작업"은 이상적 조건 기준: 레거시 코드베이스나 모호한 의존성이 있으면 수시로 개입이 필요하다
• 내부 커스텀은 Shell 이해가 전제: 스킬을 직접 수정하려면 Shell 스크립팅을 알아야 한다