← 보드로 돌아가기

obra/superpowers

An agentic skills framework & software development methodology that works.

GitHub에서 열기 ↗ aibrainstormingcodingobrasdlcskillssubagent-driven-developmentsuperpowers
251,251
GitHub 스타
22,423
포크
Shell
언어
MIT
라이선스
2026.07.06
최근 푸시
2026.05.16
별표한 날

AI 분석

설치 난이도: 보통
큐레이터 노트
Superpowers는 코딩 에이전트의 개발 방법론을 체계화하고 자동화하려는 프로젝트에 매우 적합합니다. 특히 TDD, YAGNI, DRY 원칙을 강조하며 서브에이전트 기반 개발을 지원하므로, 일관된 품질과 생산성 향상을 원하는 팀에 추천할 만합니다.

강점

  • 다양한 코딩 에이전트(Claude Code, Cursor, Gemini CLI 등)를 지원하여 폭넓은 호환성을 제공합니다.
  • 브레인스토밍, TDD, 코드 리뷰 등 개발 전 과정을 체계적인 스킬로 자동화하여 생산성을 크게 향상시킵니다.
  • 서브에이전트 기반 개발을 통해 장시간 자율 작업이 가능하며, 계획 이탈을 방지합니다.

약점

  • 새로운 스킬 기여를 일반적으로 받지 않아 확장성이 제한적일 수 있습니다.
  • 설치 과정이 하네스별로 달라 초기 설정이 다소 복잡할 수 있습니다.
  • 시각적 동반자 기능에 기본적으로 텔레메트리가 포함되어 있어 프라이버시에 민감한 사용자는 별도로 비활성화해야 합니다.

주의사항

  • 텔레메트리 비활성화를 원할 경우 환경 변수 `SUPERPOWERS_DISABLE_TELEMETRY`를 설정해야 합니다.
  • 여러 하네스를 사용하는 경우 각각 별도로 설치해야 하며, 업데이트 방식이 하네스마다 다를 수 있습니다.
  • 스킬 업데이트는 모든 지원 에이전트에서 호환되어야 하므로 기여 시 주의가 필요합니다.

시작 가이드

  • 사용 중인 코딩 에이전트에 맞는 설치 방법을 확인하고 Superpowers를 설치합니다.
  • 기본 워크플로우를 숙지하고 첫 프로젝트에 적용해 봅니다.
  • 텔레메트리 설정을 검토하고 필요시 비활성화합니다.
  • Discord 커뮤니티에 참여하여 사용 팁과 사례를 공유합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

Superpowers

Superpowers는 구성 가능한 스킬 세트와 에이전트가 이를 사용하도록 보장하는 초기 지침 위에 구축된, 코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론입니다.

채용 중입니다!

Superpowers 커뮤니티 및 코드 작업을 도와줄 풀타임 직원을 채용 중입니다. https://primeradiant.com/jobs/superpowers-community-engineer/ 에서 채용 공고를 확인할 수 있습니다. 아는 사람이 있다면 꼭 추천해 주세요.

빠른 시작

에이전트에 Superpowers를 부여하세요: Claude Code, Antigravity, Codex App, Codex CLI, Cursor, Factory Droid, Gemini CLI, GitHub Copilot CLI, Kimi Code, OpenCode, Pi.

작동 방식

코딩 에이전트를 실행하는 순간부터 시작됩니다. 에이전트는 무언가를 빌드 중임을 감지하면 바로 코드를 작성하려고 뛰어들지 않습니다. 대신 한 걸음 물러서서 실제로 무엇을 하려는지 질문합니다.

대화에서 스펙을 이끌어내면, 실제로 읽고 이해할 수 있을 만큼 짧은 청크로 나누어 보여줍니다.

설계에 동의한 후, 에이전트는 안목이 없고, 판단력이 없으며, 프로젝트 컨텍스트가 없고, 테스트를 싫어하는 열정적인 주니어 엔지니어도 따라할 수 있을 만큼 명확한 구현 계획을 작성합니다. 이 계획은 진정한 레드/그린 TDD, YAGNI(You Aren't Gonna Need It), DRY를 강조합니다.

다음으로, "시작"이라고 말하면 서브에이전트 기반 개발 프로세스를 시작하여 각 엔지니어링 작업을 처리하고, 작업을 검사 및 검토하며 계속 진행합니다. 에이전트가 함께 작성한 계획에서 벗어나지 않고 한 번에 몇 시간씩 자율적으로 작업하는 경우도 드물지 않습니다.

더 많은 내용이 있지만, 이것이 시스템의 핵심입니다. 그리고 스킬이 자동으로 트리거되므로 특별히 할 일이 없습니다. 코딩 에이전트가 Superpowers를 가지기만 하면 됩니다.

상용 서비스

엔터프라이즈에서 Superpowers를 사용 중이고 상용 지원, 추가 도구 또는 관리형 지출의 혜택을 받을 수 있다면 [email protected]으로 연락해 주세요.

설치

설치는 하네스에 따라 다릅니다. 둘 이상을 사용하는 경우 각각에 대해 Superpowers를 별도로 설치하세요.

Claude Code

Superpowers는 공식 Claude 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

공식 마켓플레이스

  • Anthropic의 공식 마켓플레이스에서 플러그인을 설치합니다:
  /plugin install superpowers@claude-plugins-official

Superpowers 마켓플레이스

Superpowers 마켓플레이스는 Claude Code용 Superpowers 및 기타 관련 플러그인을 제공합니다.

  • 마켓플레이스를 등록합니다:
  /plugin marketplace add obra/superpowers-marketplace
  • 이 마켓플레이스에서 플러그인을 설치합니다:
  /plugin install superpowers@superpowers-marketplace

Antigravity

이 저장소에서 플러그인으로 Superpowers를 설치합니다:

agy plugin install https://github.com/obra/superpowers

Antigravity는 플러그인의 세션 시작 훅을 실행하므로 첫 메시지부터 Superpowers가 활성화됩니다. 업데이트하려면 동일한 명령으로 재설치하세요.

Codex App

Superpowers는 공식 Codex 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

  • Codex 앱에서 사이드바의 Plugins를 클릭합니다.
  • Coding 섹션에서 Superpowers가 보일 것입니다.
  • Superpowers 옆의 +를 클릭하고 프롬프트를 따릅니다.

Codex CLI

Superpowers는 공식 Codex 플러그인 마켓플레이스를 통해 사용할 수 있습니다.

  • 플러그인 검색 인터페이스를 엽니다:
  /plugins
  • Superpowers를 검색합니다:
  superpowers
  • Install Plugin을 선택합니다.

Cursor

  • Cursor Agent 채팅에서 마켓플레이스에서 설치합니다:
  /add-plugin superpowers
  • 또는 플러그인 마켓플레이스에서 "superpowers"를 검색합니다.

Factory Droid

  • 마켓플레이스를 등록합니다:
  droid plugin marketplace add https://github.com/obra/superpowers
  • 플러그인을 설치합니다:
  droid plugin install superpowers@superpowers

Gemini CLI

  • 확장을 설치합니다:
  gemini extensions install https://github.com/obra/superpowers
  • 나중에 업데이트합니다:
  gemini extensions update superpowers

GitHub Copilot CLI

  • 마켓플레이스를 등록합니다:
  copilot plugin marketplace add obra/superpowers-marketplace
  • 플러그인을 설치합니다:
  copilot plugin install superpowers@superpowers-marketplace

Kimi Code

Superpowers는 Kimi Code의 플러그인 마켓플레이스에서 사용할 수 있습니다.

  • Kimi Code의 플러그인 관리자를 엽니다:
  /plugins
  • Marketplace > Superpowers로 이동하여 설치합니다.
  • 또는 이 저장소에서 직접 설치합니다:
  /plugins install https://github.com/obra/superpowers
  • 자세한 문서: docs/README.kimi.md

OpenCode

OpenCode는 자체 플러그인 설치를 사용합니다. 다른 하네스에서 이미 사용 중이더라도 Superpowers를 별도로 설치하세요.

  • OpenCode에 지시합니다:
  Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
  • 자세한 문서: docs/README.opencode.md

Pi

이 저장소에서 Pi 패키지로 Superpowers를 설치합니다:

pi install git:github.com/obra/superpowers

로컬 개발의 경우, 이 체크아웃을 임시 패키지로 로드하여 Pi를 실행합니다:

pi -e /path/to/superpowers

Pi 패키지는 Superpowers 스킬과 세션 시작 시 및 압축 후에 using-superpowers 부트스트랩을 주입하는 작은 확장을 로드합니다. Pi는 네이티브 스킬을 가지고 있으므로 호환성 Skill 도구가 필요하지 않습니다. 서브에이전트 및 작업 목록 도구는 선택적 Pi 동반 패키지로 남아 있습니다.

기본 워크플로우

  1. brainstorming - 코드를 작성하기 전에 활성화됩니다. 질문을 통해 거친 아이디어를 다듬고, 대안을 탐색하며, 검증을 위해 설계를 섹션별로 제시합니다. 설계 문서를 저장합니다.
  1. using-git-worktrees - 설계 승인 후 활성화됩니다. 새 브랜치에 격리된 작업 공간을 만들고, 프로젝트 설정을 실행하며, 깨끗한 테스트 기준선을 확인합니다.
  1. writing-plans - 승인된 설계와 함께 활성화됩니다. 작업을 한 입 크기(각 2-5분)로 나눕니다. 모든 작업에는 정확한 파일 경로, 완전한 코드, 검증 단계가 있습니다.
  1. subagent-driven-development 또는 executing-plans - 계획과 함께 활성화됩니다. 작업당 새로운 서브에이전트를 파견하여 2단계 검토(스펙 준수, 코드 품질)를 수행하거나, 사람이 확인하는 체크포인트와 함께 배치로 실행합니다.
  1. test-driven-development - 구현 중에 활성화됩니다. RED-GREEN-REFACTOR를 강제합니다: 실패하는 테스트 작성, 실패 확인, 최소 코드 작성, 통과 확인, 커밋. 테스트 전에 작성된 코드는 삭제합니다.
  1. requesting-code-review - 작업 사이에 활성화됩니다. 계획에 대해 검토하고, 심각도별로 문제를 보고합니다. 치명적인 문제는 진행을 차단합니다.
  1. finishing-a-development-branch - 작업이 완료되면 활성화됩니다. 테스트를 확인하고, 옵션(병합/PR/유지/폐기)을 제시하며, 워크트리를 정리합니다.

에이전트는 모든 작업 전에 관련 스킬을 확인합니다. 필수 워크플로우이며, 제안이 아닙니다.

내부 구성

스킬 라이브러리

  • test-driven-development - RED-GREEN-REFACTOR 사이클 (테스팅 안티패턴 참조 포함)

테스팅

  • systematic-debugging - 4단계 근본 원인 프로세스 (root-cause-tracing, defense-in-depth, condition-based-waiting 기술 포함)
  • verification-before-completion - 실제로 수정되었는지 확인

디버깅

  • brainstorming - 소크라테스식 설계 개선
  • writing-plans - 상세 구현 계획
  • executing-plans - 체크포인트가 있는 배치 실행
  • dispatching-parallel-agents - 동시 서브에이전트 워크플로우
  • requesting-code-review - 사전 검토 체크리스트
  • receiving-code-review - 피드백에 응답
  • using-git-worktrees - 병렬 개발 브랜치
  • finishing-a-development-branch - 병합/PR 결정 워크플로우
  • subagent-driven-development - 2단계 검토(스펙 준수, 코드 품질)를 통한 빠른 반복

협업

  • writing-skills - 모범 사례를 따라 새 스킬 생성 (테스팅 방법론 포함)
  • using-superpowers - 스킬 시스템 소개

메타

철학

  • 테스트 주도 개발 - 항상 먼저 테스트를 작성하세요
  • 임시방편보다 체계적으로 - 추측보다 프로세스
  • 복잡성 감소 - 단순성을 주요 목표로
  • 주장보다 증거 - 성공을 선언하기 전에 검증하세요

원본 릴리스 발표를 읽어보세요.

기여하기

Superpowers의 일반적인 기여 프로세스는 아래와 같습니다. 일반적으로 새로운 스킬의 기여는 받지 않으며, 스킬에 대한 모든 업데이트는 지원하는 모든 코딩 에이전트에서 작동해야 합니다.

  1. 저장소를 포크합니다.
  2. 'dev' 브랜치로 전환합니다.
  3. 작업할 브랜치를 만듭니다.
  4. 새 스킬 및 수정된 스킬을 생성하고 테스트하려면 writing-skills 스킬을 따릅니다.
  5. PR을 제출하고, 풀 리퀘스트 템플릿을 반드시 작성하세요.

스킬 동작 테스트는 superpowers-evals의 drill eval 하네스를 사용하며, evals/에 클론됩니다. 설정은 evals/README.md를 참조하세요. 플러그인 인프라 테스트는 tests/에 있으며, 관련 run-*.sh 또는 npm test를 통해 실행됩니다.

전체 가이드는 skills/writing-skills/SKILL.md를 참조하세요.

업데이트

Superpowers 업데이트는 코딩 에이전트에 따라 다소 다르지만, 종종 자동으로 이루어집니다.

라이선스

MIT 라이선스 - 자세한 내용은 LICENSE 파일을 참조하세요.

시각적 동반자 텔레메트리

스킬과 플러그인은 제작자에게 어떤 피드백도 제공하지 않기 때문에, 얼마나 많은 사람들이 Superpowers를 사용하는지 알 수 없습니다. 기본적으로 brainstorming의 선택적 시각적 동반자 기능에 있는 Prime Radiant 로고는 당사 웹사이트에서 로드됩니다. 여기에는 사용 중인 Superpowers 버전이 포함됩니다. 프로젝트, 프롬프트 또는 코딩 에이전트에 대한 세부 정보는 포함되지 않습니다. 클릭이나 빌드 중인 내용에 대한 어떤 정보도 볼 수 없습니다. 이는 대략적인 사용자 수와 사용 중인 Superpowers 버전을 파악하는 데 도움이 됩니다. 100% 선택 사항입니다. 비활성화하려면 환경 변수 SUPERPOWERSDISABLETELEMETRY를 참(true) 값으로 설정하세요. Superpowers는 또한 Claude Code의 DISABLETELEMETRY 및 CLAUDECODEDISABLENONESSENTIAL_TRAFFIC 옵트아웃을 존중합니다.

커뮤니티

Superpowers는 Jesse Vincent과 Prime Radiant의 다른 사람들에 의해 만들어졌습니다.

  • Discord: 가입하기 커뮤니티 지원, 질문, Superpowers로 빌드한 내용 공유
  • 이슈: https://github.com/obra/superpowers/issues
  • 릴리스 알림: 등록하여 새 버전 알림 받기

원본 저장소: obra/superpowers

라이선스: MIT

게재 제외를 원하시면 삭제 요청을 보내주세요.