무슨 일이 있었나
obra/superpowers가 GitHub Trending에서 75,892 스타를 기록하며 하루 1,387 스타가 추가되고 있습니다. AI 코딩 도구 생태계에서 가장 빠르게 성장하는 프로젝트 중 하나입니다.
Superpowers의 핵심 관찰은 이것입니다: AI 코딩 에이전트는 코드를 잘 쓰지만, 좋은 개발 프로세스를 따르지는 않습니다. 바로 코드를 쓰기 시작하고, 테스트 없이 구현하고, 전체 설계를 고려하지 않습니다.
Superpowers는 에이전트에게 "먼저 계획하고, 테스트를 먼저 쓰고, 코드 리뷰를 받아라"라는 개발 방법론을 강제합니다. 사람에게 코딩 컨벤션을 가르치듯, 에이전트에게 프로세스를 가르치는 것입니다.
프로젝트 구조
Superpowers는 주로 Shell 스크립트와 마크다운으로 구성되어 있습니다. 코드보다 "지시문서"가 핵심인 독특한 프로젝트입니다.
superpowers/
├── skills/ # 핵심 스킬 모듈
│ ├── testing/ # TDD 관련 스킬
│ │ ├── red-green-refactor.md
│ │ └── test-first.md
│ ├── debugging/ # 디버깅 스킬
│ ├── collaboration/ # 사용자 협업 스킬
│ └── meta/ # 메타 스킬 (자기 개선)
├── agents/ # 서브 에이전트 설정
│ ├── code-reviewer.md # 코드 리뷰 에이전트
│ └── spec-writer.md # 스펙 작성 에이전트
├── commands/ # CLI 명령어 구현
├── lib/ # 유틸리티 라이브러리
├── docs/ # 플랫폼별 문서
├── .claude-plugin/ # Claude Code 통합
├── .cursor-plugin/ # Cursor 통합
├── .codex/ # OpenAI Codex 통합
└── .opencode/ # OpenCode 통합
주목할 점은 코드가 메인이 아니라 마크다운이 메인이라는 것입니다. skills/ 디렉토리의 마크다운 파일들이 에이전트의 행동을 정의합니다. 에이전트가 이 마크다운을 읽고, 그 안의 지시를 따릅니다.
핵심 기술 스택
7단계 개발 워크플로
Superpowers는 에이전트에게 7단계의 구조화된 워크플로를 강제합니다.
[1. 브레인스토밍]
소크라테스식 질문으로 요구사항 명확화
"이 기능의 edge case는 뭐야?"
↓
[2. Git Worktree 설정]
독립된 브랜치에서 작업 시작
기존 코드에 영향 없이 실험
↓
[3. 계획 작성]
작업을 2~5분 단위 태스크로 분해
각 태스크에 정확한 스펙 명시
↓
[4. TDD 실행]
테스트를 먼저 작성 (Red)
테스트를 통과하는 최소 코드 작성 (Green)
코드 개선 (Refactor)
↓
[5. 코드 리뷰]
1차: 스펙 준수 여부 검토
2차: 코드 품질 검토
심각도 기반 이슈 리포팅
↓
[6. 수정]
리뷰에서 발견된 이슈 해결
critical 이슈는 반드시 수정
↓
[7. 브랜치 완료]
머지 또는 PR 생성
worktree 정리
TDD 강제: Red-Green-Refactor
Superpowers의 가장 강력한 규칙은 TDD(Test-Driven Development) 강제입니다. 단순한 권장이 아니라, 테스트 없이 쓴 코드는 삭제합니다.
# skills/testing/test-first.md (개념적 내용)
## 규칙
1. 코드를 쓰기 전에 반드시 테스트를 먼저 작성한다
2. 테스트가 FAIL하는 것을 확인한 후에만 구현 코드를 작성한다
3. 테스트 없이 작성된 코드를 발견하면 즉시 삭제한다
4. Red → Green → Refactor 사이클을 반드시 따른다
## Red (빨간불)
- 새 기능의 테스트를 작성한다
- 이 테스트가 실패하는 것을 확인한다
- 실패하지 않는 테스트는 의미가 없다
## Green (초록불)
- 테스트를 통과하는 최소한의 코드를 작성한다
- "최소한"이 핵심이다. 불필요한 코드를 쓰지 않는다
## Refactor (리팩토링)
- 테스트가 통과하는 상태를 유지하면서 코드를 개선한다
- 중복 제거, 명명 개선, 구조 정리
서브 에이전트 디스패치
복잡한 작업은 서브 에이전트에게 위임됩니다. 각 서브 에이전트는 독립된 컨텍스트에서 최대 2시간까지 자율적으로 작업합니다.
[메인 에이전트] "인증 시스템을 구현해"
├── [서브 에이전트: 스펙 작성] → 기능 명세서
├── [서브 에이전트: 코드 구현] → 인증 모듈
├── [서브 에이전트: 코드 리뷰 (1차)] → 스펙 준수 확인
└── [서브 에이전트: 코드 리뷰 (2차)] → 품질 확인
두 단계 코드 리뷰가 특히 독특합니다.
- 1차 리뷰: "스펙대로 구현했는가?" — 기능적 정확성
- 2차 리뷰: "코드 품질은 괜찮은가?" — 구조, 가독성, 성능
멀티 플랫폼 통합
Superpowers는 특정 에이전트에 종속되지 않습니다. Claude Code, Cursor, OpenAI Codex, OpenCode 등 여러 AI 코딩 도구에서 작동합니다.
각 플랫폼별 통합은 .claude-plugin/, .cursor-plugin/ 등의 디렉토리에 정의되어 있습니다. 플러그인 마켓플레이스를 통해 한 줄로 설치할 수 있습니다.
Git Worktree 활용
Superpowers는 Git Worktree를 적극 활용합니다. 새 작업을 시작할 때 메인 브랜치를 건드리지 않고, 독립된 worktree에서 작업합니다.
# Git Worktree = 하나의 레포에 여러 작업 디렉토리
git worktree add ../feature-auth feature/auth
# ../feature-auth 디렉토리에서 독립적으로 작업
# 메인 브랜치에 영향 없음
이 방식의 장점:
- 격리: 실험적 변경이 메인 코드에 영향을 주지 않음
- 병렬 작업: 여러 서브 에이전트가 동시에 다른 worktree에서 작업 가능
- 롤백 용이: 문제가 생기면 worktree만 삭제하면 됨
개념 정리
에이전트에게 프로세스가 필요한 이유
AI 코딩 에이전트는 코드 생성 능력은 뛰어나지만, "어떤 순서로, 어떤 방식으로 작업할까"에 대한 판단은 약합니다. 사람 개발자가 수년간 경험으로 체득하는 것들 — 먼저 설계를 하고, 테스트를 쓰고, 리뷰를 받는 것 — 을 에이전트는 자연스럽게 따르지 않습니다.
Superpowers의 가설: 에이전트에게 좋은 프로세스를 강제하면, 출력 코드의 품질이 올라간다. 이것은 사람 개발자에게 코딩 컨벤션을 강제하면 코드 품질이 올라가는 것과 같은 원리입니다.
CLAUDE.md와의 관계
Claude Code 사용자라면 CLAUDE.md 파일에 프로젝트 규칙을 적는 것에 익숙할 것입니다. Superpowers는 이 개념을 극한까지 확장한 것입니다.
CLAUDE.md가 "이 프로젝트에서는 TypeScript를 쓰고, 테스트는 Jest로 해"라는 수준이라면, Superpowers는 "모든 작업에서 TDD를 따르고, 2단계 코드 리뷰를 받고, 2~5분 단위로 태스크를 쪼개라"는 전체 개발 방법론을 정의합니다.
코드로서의 프로세스(Process as Code)
Superpowers의 근본적 아이디어는 개발 프로세스를 코드화(codify)하는 것입니다. 사람에게 구두로 전달되던 개발 문화와 프로세스를, 에이전트가 읽고 따를 수 있는 실행 가능한 문서로 변환합니다.
[전통적 방식]
시니어: "PR 올리기 전에 테스트 돌려봐"
주니어: (가끔 까먹음)
[Superpowers 방식]
마크다운 스킬: "테스트 없는 코드는 삭제한다"
에이전트: (100% 따름)
에이전트는 피곤하지 않고, 까먹지 않고, 귀찮아하지 않습니다. 프로세스를 명확하게 정의하면, 에이전트는 100% 준수율로 따릅니다. 이것이 "에이전트에게 프로세스를 가르치는 것"의 핵심 가치입니다.
정리
Superpowers는 "AI 코딩 에이전트의 품질은 프로세스로 결정된다"는 통찰을 가장 체계적으로 구현한 프로젝트입니다.
7.6만 스타라는 숫자가 놀라운 것은, 이 프로젝트에 혁신적인 AI 기술이 들어있지 않기 때문입니다. 새로운 모델도, 새로운 알고리즘도 없습니다. 마크다운으로 작성된 프로세스 문서가 전부입니다. 그런데 이것이 코드 품질에 미치는 영향은 극적입니다.
결국 좋은 소프트웨어는 좋은 코드가 아니라 좋은 프로세스에서 나옵니다. 이것은 사람 개발자에게도, AI 에이전트에게도 마찬가지입니다. Superpowers는 이 보편적 원칙을 에이전트 시대에 맞게 재해석한 프로젝트입니다.
📌 원문: Jidong Lab
AI 소식과 개발 로그 → jidonglab.com
Top comments (0)