obra/superpowers — 공식 README
Key Insight
obra-superpowers는 단순 스킬 모음이 아니라 완전한 소프트웨어 개발 방법론이다. 7단계 워크플로우(브레인스토밍 → 워크트리 → 계획 → SDD → TDD → 리뷰 → 브랜치 종료)가 자동으로 연결되며, 에이전트가 스스로 적절한 스킬을 트리거한다.
출처: GitHub (obra/superpowers) 작성자: Jesse-Vincent (Prime Radiant) 유효일: 2026-05-20
핵심 Takeaway
- “완전한 소프트웨어 개발 방법론” — 스킬이 강제(mandatory) 워크플로우로 자동 트리거됨, 선택 사항 아님
- Claude Code, Codex CLI, Codex App, Gemini CLI, Cursor, GitHub Copilot CLI, OpenCode, Factory Droid 등 8개 플랫폼 지원
- 7단계 기본 워크플로우: brainstorming → git-worktrees → writing-plans → SDD/executing-plans → TDD → code-review → finishing-branch
- subagent-driven-development: 태스크마다 새 서브에이전트 + 2단계 리뷰(스펙 준수 → 코드 품질)
- TDD 강제: RED 실패 테스트 작성 → GREEN 최소 코드 → REFACTOR commit. 테스트 전에 작성된 코드는 삭제
- YAGNI + DRY 원칙을 열정적이지만 판단력·컨텍스트·테스트 의지가 없는 주니어 엔지니어도 따를 수 있게 계획서 작성 강제
- 철학 4원칙: TDD, Systematic over ad-hoc, Complexity reduction, Evidence over claims
7단계 기본 워크플로우
| 단계 | 스킬 | 트리거 조건 | 핵심 동작 |
|---|---|---|---|
| 1 | brainstorming | 코드 작성 전 | 소크라테스식 질문으로 스펙 도출, 섹션별 확인 |
| 2 | using-git-worktrees | 디자인 승인 후 | 새 브랜치 격리 워크스페이스, 테스트 기준선 확인 |
| 3 | writing-plans | 승인된 디자인과 함께 | 2-5분 단위 태스크 분리, 정확한 파일 경로·코드·검증 포함 |
| 4 | subagent-driven-development | 계획과 함께 | 태스크별 새 서브에이전트 + 2단계 리뷰 |
| 5 | test-driven-development | 구현 중 | RED-GREEN-REFACTOR 강제 |
| 6 | requesting-code-review | 태스크 사이 | 계획 대비 검토, 심각도별 이슈 보고, Critical은 진행 차단 |
| 7 | finishing-a-development-branch | 태스크 완료 시 | 테스트 확인, merge/PR/keep/discard 선택지 제시, 워크트리 정리 |
스킬 라이브러리 전체 목록 (14개)
Testing: test-driven-development Debugging: systematic-debugging, verification-before-completion Collaboration: brainstorming, writing-plans, executing-plans, dispatching-parallel-agents, requesting-code-review, receiving-code-review, using-git-worktrees, finishing-a-development-branch, subagent-driven-development Meta: writing-skills, using-superpowers
설치 명령 (Claude Code)
# 공식 Anthropic 마켓플레이스
/plugin install superpowers@claude-plugins-official
# 또는 Superpowers 전용 마켓플레이스
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace철학
- TDD: 항상 테스트 먼저
- Systematic over ad-hoc: 추측보다 프로세스
- Complexity reduction: 단순성이 1차 목표
- Evidence over claims: 선언 전에 검증
연결되는 노트
- obra-superpowers — 이 README의 주체
- Jesse-Vincent — 저자 (Prime Radiant)
- subagent-driven-development — 핵심 워크플로우 개념
- harness-engineering — 배경 개념
- Thin-Harness-Fat-Skills — 설계 철학적 배경