Superpowers – AI 코딩 에이전트를 위한 스킬 기반 소프트웨어 개발 방법론 (★178k)

핵심 아이디어
포함된 스킬들
지원 플랫폼
설계 원칙
누구에게 유용한가?
라이선스
관련 도구
관련 문서
참고 자료

AI 코딩 에이전트에게 기능 구현을 시키면 기본적으로 가장 빠른 경로를 택한다. 스펙도 없고, 테스트도 없고, 코드 리뷰도 없다. Superpowers는 이 문제를 해결하는 오픈소스 소프트웨어 개발 방법론으로, SKILL.md 기반 스킬 파일들을 에이전트에게 주입해 브레인스토밍→스펙 작성→구현 계획→서브에이전트 기반 TDD 구현→검증→완료까지 전 과정을 강제한다. Claude Code 공식 플러그인 마켓플레이스에서 배포되며 GitHub ★178,459를 기록했다.

핵심 아이디어

에이전트는 자신이 놓치는 부분을 모른다. 경험 많은 시니어 엔지니어가 diff에 보이지 않는 작업(스펙, 테스트, 리뷰, 범위 규율, 검증)에 대부분의 시간을 쓰는 것처럼, Superpowers는 이 보이지 않는 부분을 스킬 파일로 에이전트 워크플로우에 내재화한다.

에이전트가 “기능을 만들어라”라는 요청을 받으면:

바로 코드를 작성하지 않는다.
먼저 실제로 무엇을 만들어야 하는지 질문한다.
스펙을 합의한다.
주니어 엔지니어도 따를 수 있는 구현 계획을 수립한다.
서브에이전트 기반으로 각 태스크를 TDD로 구현한다.
결과를 검토하고 다음으로 진행한다.

포함된 스킬들

스킬	역할
`using-superpowers`	라우터. 세션 시작 시 적절한 스킬을 자동 활성화
`brainstorming`	새 기능·컴포넌트 작업 전 브레인스토밍 강제
`writing-plans`	스펙/요구사항을 구현 계획으로 전환
`test-driven-development`	TDD 강제 — 구현 코드 전 실패 테스트 먼저
`subagent-driven-development`	독립 태스크를 병렬 서브에이전트로 실행
`systematic-debugging`	버그·테스트 실패 발생 시 체계적 디버깅
`verification-before-completion`	완료 선언 전 검증 명령어 실행 강제
`requesting-code-review`	작업 완료 후 코드 리뷰 요청
`receiving-code-review`	리뷰 피드백 구현 전 평가

지원 플랫폼

Claude Code(공식 마켓플레이스), Codex CLI, Codex App, Factory Droid, Gemini CLI, OpenCode, Cursor, GitHub Copilot CLI

Claude Code 설치 (공식 마켓플레이스):

/plugin install superpowers@claude-plugins-official

Codex CLI 설치:

/plugins → superpowers 검색 → Install Plugin 선택

설계 원칙

경직된(Rigid) 스킬: TDD, 디버깅처럼 반드시 따라야 하는 규율 — 에이전트가 상황에 따라 변형하지 않는다.

유연한(Flexible) 스킬: 컨텍스트에 맞게 원칙을 적용한다.

점진적 노출: 세션 시작 시 모든 스킬을 로드하지 않는다. 라우터(using-superpowers)가 현재 태스크에 적합한 스킬만 활성화해 컨텍스트 사용량을 최소화한다.

누구에게 유용한가?

AI 에이전트가 자율적으로 장시간 작업하길 원하는 개발자: 스킬 없이는 에이전트가 계획에서 이탈하거나 임의 리팩터링을 시작한다. Superpowers는 몇 시간 동안 방향을 유지한다.
팀 코딩 표준을 에이전트에 적용하려는 조직: TDD, 코드 리뷰, 범위 규율을 AI 에이전트에게 일관되게 강제한다.
Claude Code·Codex 등 에이전트를 처음 도입하는 팀: 좋은 기본 워크플로우가 자동 적용된다.

라이선스

MIT

참고 자료

obra/superpowers — GitHub 공식 저장소

Like?

AI Sparkup