수록 현황:317 건의 뉴스/102 개의 AI 도구/399 개의 오픈소스 프로젝트/74 개의 학습 자료
홈뉴스오픈소스모델AI 도구학습 자료
홈 / 오픈소스 / superpowers

superpowers

AI 코딩 에이전트에게 체계적이고 테스트 주도적인 소프트웨어 개발 방법론을 제공하는 조합 가능한 스킬 라이브러리입니다.

ShellMITskill
⭐ GitHubhttps://github.com/obra/superpowers
272,614
스타 수
+0
스타 증가율
2026년 8월 13일
최근 업데이트
4
클릭 수

1. 프로젝트 개요

Superpowers는 AI 코딩 에이전트를 위한 오픈소스 소프트웨어 개발 방법론으로, Claude Code, Cursor, Codex CLI와 같은 도구가 즉흥적인 코딩으로 바로 뛰어드는 대신 규율 있고 증거 기반의 워크플로를 따르도록 안내하는 조합 가능한 "스킬" 라이브러리입니다.

2. 배경 및 포지셔닝

Superpowers는 AI 코딩 에이전트의 일반적인 실패 모드, 즉 설계 검토를 건너뛰고 테스트를 생략하며 실제 검증 없이 작업을 "완료"라고 선언한 채 먼저 코드를 작성하고 나중에 생각하는 문제를 해결하기 위해 만들어졌습니다. 핵심 미션은 에이전트에게 브레인스토밍, 계획 수립, 격리된 실행, 테스트 주도 개발, 코드 검토 등 반복 가능하고 전문가 수준의 프로세스를 제공하여, 에이전트가 생성한 소프트웨어가 인간 엔지니어링 팀에 기대되는 것과 동일한 기준을 충족하도록 하는 것입니다.

단일 목적의 프롬프트 라이브러리나 일회용 "코딩 에이전트" 래퍼와 달리, Superpowers는 명확히 방법론과 스킬 라이브러리의 결합이며 단일 도구가 아닙니다. 설계상 에이전트에 종속되지 않습니다. 동일한 스킬 세트가 하나의 벤더 생태계에 묶이지 않고 13개 이상의 다양한 코딩 에이전트(Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Devin 등)에 설치됩니다. 또한 프로세스 규율을 강제하지 않는 경량 프롬프트 엔지니어링 컬렉션과 구별되게 "즉흥적 접근보다 체계적 접근"을, "주장보다 증거"를 중시합니다.

3. 기능 카테고리

  • 🧪 테스트 — 1개 스킬. test-driven-development는 엄격한 RED-GREEN-REFACTOR 루프를 강제하여 에이전트가 구현 코드를 작성하기 전에 실패하는 테스트를 먼저 작성하도록 합니다.
  • 🐞 디버깅 — 2개 스킬. systematic-debugging은 추측 대신 근본 원인 분석을 주도하며, verification-before-completion은 실제로 작동한다는 증거 없이는 에이전트가 작업을 "완료"로 표시하지 못하도록 차단합니다.
  • 🤝 협업 — 9개 스킬. brainstorming(코딩 전 사용자와 함께 설계 검증), writing-plans / executing-plans(작업 분해 및 실행), dispatching-parallel-agents(하위 에이전트로 작업 분산), requesting-code-review / receiving-code-review, using-git-worktrees(격리되고 안전한 개발 브랜치), finishing-a-development-branch, subagent-driven-development를 포함합니다.
  • 🧩 메타 — 2개 스킬. writing-skills는 새로운 스킬을 작성하는 방법을 문서화하며, using-superpowers는 프레임워크 자체를 호출하고 조합하는 방법을 설명합니다.

4. 주요 하이라이트

  • 7단계 개발 워크플로 — 모든 작업은 설계 브레인스토밍, git worktree 격리, 작업 분해, 검토 주기가 포함된 하위 에이전트 실행, TDD, 사양 기반 코드 검토, 브랜치 정리를 거치며, 에이전트 주도 개발에 일관된 형태를 부여합니다.
  • 에이전트 비종속적 설치 — 13개 이상의 코딩 에이전트(Claude Code, Cursor, Codex CLI, Gemini CLI, GitHub Copilot CLI, Devin, Antigravity, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Pi, Hermes Agent)에서 작동하므로 팀이 단일 벤더에 종속되지 않습니다.
  • 기본값으로서의 테스트 주도 개발 — test-driven-development 스킬은 RED-GREEN-REFACTOR를 선택 사항이 아닌 기본 루프로 만듭니다.
  • 주장보다 증거 우선 검증 — verification-before-completion은 에이전트가 증명 없이 성공을 자체 보고하는 것을 막기 위해 특별히 설계되었습니다.
  • Git worktree 격리 — 개발은 격리된 worktree에서 이루어지며, 실험적이거나 진행 중인 에이전트 작업이 메인 브랜치를 불안정하게 만드는 것을 방지합니다.
  • 조합 가능하고 확장 가능한 스킬 라이브러리 — 스킬은 모듈식 Markdown 기반 단위(SKILL.md)이며, writing-skills는 자체 스킬을 추가하려는 팀을 위해 패턴을 문서화합니다.

5. 역할별 사용 사례

  • 일반 개발자 — 선호하는 코딩 에이전트에 Superpowers를 설치하여 일상적인 에이전트 지원 코딩 세션에 구조화된 계획, TDD 강제, 코드 검토를 내장할 수 있습니다.
  • 프로젝트 매니저 / 테크 리드 — 브레인스토밍 및 계획 스킬을 사용하여 에이전트가 구현 시작 전에 설계 트레이드오프를 드러내고 검토 가능한 계획을 산출하도록 유도하여 예기치 않은 재작성을 줄일 수 있습니다.
  • 오픈소스 관리자 — using-git-worktrees 및 finishing-a-development-branch 스킬은 에이전트가 제출한 브랜치를 격리되고 깨끗하게 유지하여 관리자의 검토 부담을 덜어줍니다.

(DevOps/SRE, 보안 엔지니어링, 데이터/연구 과학은 이 프로젝트의 명확한 집중 분야가 아니므로 제외되었습니다.)

6. 시작하기

필요한 것 찾기
저장소의 skills/ 디렉토리에서 카테고리(테스트, 디버깅, 협업, 메타)별로 스킬 라이브러리를 탐색하거나, 에이전트별 설정 노트는 docs/를 참조하십시오.

설치 / 통합
설치는 사용하는 코딩 에이전트에 맞는 단일 명령으로 수행됩니다. 예:

# Claude Code
/plugin install superpowers@claude-plugins-official

# Cursor
/add-plugin superpowers

# Gemini CLI
gemini extensions install https://github.com/obra/superpowers

# GitHub Copilot CLI
copilot plugin install superpowers@superpowers-marketplace

지원되는 13개 이상의 모든 에이전트를 다루는 전체 표는 저장소 README를 참조하십시오.

기여하기
저장소를 포크하고 dev 브랜치에서 작업한 후, 풀 리퀘스트를 열기 전에 skills/writing-skills/SKILL.md에 문서화된 방법론을 따르십시오. 관리자들은 일반적으로 완전히 새로운 스킬의 기여는 받지 않으며, 버그 수정 및 기존 스킬 개선이 주요 기여 경로임을 명시하고 있습니다.

7. 프로젝트 구조

superpowers/
├── .claude-plugin/     # Claude Code 플러그인 매니페스트
├── .cursor-plugin/     # Cursor 플러그인 매니페스트
├── .devin-plugin/      # Devin 플러그인 매니페스트
├── .kimi-plugin/       # Kimi Code 플러그인 매니페스트
├── .opencode/          # OpenCode 확장 + INSTALL.md
├── .pi/extensions/     # Pi 확장 매니페스트
├── .agents/plugins/    # 공유 에이전트 플러그인 정의
├── skills/             # 핵심 스킬 라이브러리 (스킬당 SKILL.md)
├── docs/               # 에이전트별 및 일반 문서
├── hooks/              # 워크플로 훅
├── scripts/            # 지원 자동화 스크립트
├── assets/             # 정적 에셋 (로고, 텔레메트리 픽셀 등)
└── tests/              # 테스트 스위트 / 평가 하네스

skills/ 디렉토리는 프로젝트의 핵심으로, 각 스킬은 에이전트가 이를 언제 어떻게 적용해야 하는지를 설명하는 독립적인 SKILL.md입니다. .{agent}-plugin/ 디렉토리는 동일한 스킬 라이브러리를 지원되는 각 코딩 에이전트의 플러그인 형식에 맞게 조정합니다.

8. 관련 생태계

Superpowers는 설치 대상인 코딩 에이전트 플랫폼(Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Codex CLI, Devin, Antigravity, Factory Droid, Grok Build CLI, Kimi Code, OpenCode, Pi, Hermes Agent)에 의존하며, 각 플랫폼은 Superpowers 스킬이 실행되는 기반 LLM 런타임과 플러그인/확장 메커니즘을 제공합니다. 이는 각 에이전트의 고유 기능을 대체하는 것이 아니라, 그 위에 공유 개발 방법론을 계층화하여 보완합니다.

9. 라이선스

  • ✅ 상업적 목적을 포함하여 자유롭게 사용, 복사, 수정, 병합, 게시, 배포할 수 있습니다 (MIT 라이선스).
  • ✅ 개인 또는 조직용으로 지원되는 모든 코딩 에이전트에 무료로 설치할 수 있습니다.
  • ❌ 보증은 제공되지 않으며, 소프트웨어는 "있는 그대로" 제공됩니다.
  • ℹ️ 원본 저작권 및 라이선스 고지는 사본 또는 소프트웨어의 상당 부분에 포함되어야 합니다.
  • ℹ️ 프로젝트에는 옵트아웃 방식의 선택적 텔레메트리(로고 로드 비콘을 통한 버전 채택 추적)가 포함되어 있으며, 환경 변수를 통해 비활성화할 수 있습니다.

10. 자주 묻는 질문

Q: Superpowers가 제 코딩 에이전트에서도 작동하나요?
A: Claude Code, Cursor, Gemini CLI, GitHub Copilot CLI, Codex CLI, Devin을 포함한 13개 이상의 에이전트를 지원합니다. 사용 중인 에이전트에 대한 정확한 명령은 README의 설치 표를 확인하십시오.

Q: Superpowers는 단일 도구인가요, 아니면 프롬프트 세트인가요?
A: 정확히 둘 다 아닙니다. 일회성 프롬프트가 아니라 전체 개발 워크플로 내내 에이전트에 의해 호출되도록 설계된, 조합 가능한 스킬 라이브러리(skills/)로 구현된 구조화된 방법론입니다.

Q: 새로운 스킬을 기여할 수 있나요?
A: 풀 리퀘스트를 열 수는 있지만, 관리자들은 일반적으로 완전히 새로운 스킬의 기여는 받지 않는다고 명시합니다. 기존 스킬, 문서 또는 에이전트 통합을 개선하는 기여가 병합될 가능성이 더 높습니다. 필수 형식은 skills/writing-skills/SKILL.md를 참조하십시오.

Q: 제 데이터를 수집하나요?
A: 버전 채택 추적에 한정된 선택적 텔레메트리가 포함되어 있으며, 옵트아웃 환경 변수를 준수합니다.

Q: 설치 후 Superpowers를 어떻게 업데이트하나요?
A: 업데이트는 사용 중인 코딩 에이전트의 일반 플러그인/확장 업데이트 메커니즘을 따릅니다. 에이전트별 세부 사항은 저장소 README의 "업데이트" 섹션을 참조하십시오.

11. 빠른 링크

  • 저장소: https://github.com/obra/superpowers
  • 기여 가이드: skills/writing-skills/SKILL.md (저장소 내)
  • 에이전트별 문서: docs/ 디렉토리 (저장소 내)
  • 커뮤니티: 저장소의 GitHub Issues 및 Discussions

12. 요약

Superpowers는 즉흥적인 AI 지원 코딩을 규율 있고 증거 기반의 엔지니어링 프로세스(브레인스토밍, 계획, TDD, 코드 검토)로 전환하며, 팀이 이미 사용 중인 어떤 코딩 에이전트에도 설치할 수 있습니다. 이는 AI 코딩 에이전트가 빠르지만 엉성한 자동 완성 도구처럼 행동하는 대신 신중한 엔지니어처럼 작동하기를 원하는 개발자와 팀에게 가장 유용하며, 단일 에이전트 벤더에 종속되지 않습니다.