Superpowers - 코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론

Superpowers 는 코딩 에이전트를 위한 완전한 소프트웨어 개발 방법론으로, 상호 운용 가능한 기술 (composable skills) 세트와 에이전트가 이를 사용하도록 보장하는 초기 지침 위에 구축되었습니다.

코딩 에이전트를 시작하는 순간부터 이 방법론이 적용됩니다. 에이전트가 당신이 무언가를 만들고 있다는 것을 인식하자마자, 단순히 코드를 작성하려고 하는 것이 아닙니다. 대신, 당신은 무엇을 실제로 하고자 하는지 물어봅니다.

대화를 통해 스펙 (spec) 을 추출한 후, 실제로 읽을 수 있고 소화할 수 있는 작은 단위로 이를 보여줍니다.

설계를 승인한 후, 에이전트는 열정적인 초급 엔지니어가 테스트를 싫어하고, 판단 없이 프로젝트 컨텍스트가 없더라도 따라갈 수 있도록 명확한 구현 계획을 세웁니다. 이 계획은 진정한 레드/그린 TDD (Test-Driven Development), YAGNI (You Aren't Gonna Need It - 필요하지 않을 것이니 만들지 마라), DRY (Don't Repeat Yourself) 를 강조합니다.

다음으로, "가자"라고 할 때, 에이전트는 각 엔지니어링 작업을 수행하고 자신의 작업을 점검하며 검토한 후 계속 진행하는 서브에이전트 기반 개발 (subagent-driven-development) 프로세스를 시작합니다. 클로드 (Claude) 가 계획에서 벗어나지 않고 몇 시간 동안 자율적으로 작업할 수 있는 것은 흔하지 않습니다.

더 많은 것이 있지만, 이것이 시스템의 핵심입니다. 기술이 자동으로 트리거되므로 특별한 작업을 수행할 필요가 없습니다. 당신의 코딩 에이전트는 단순히 Superpowers 를 갖습니다.

Superpowers 가 당신에게 돈을 벌게 하는 일을 도와주었다면, 오픈소스 작업에 대한 스폰서십을 고려해 주시면 감사하겠습니다.

감사합니다!

• Jesse

참고: 설치 방법은 플랫폼마다 다릅니다.

Superpowers 는 공식 클로드 플러그인 마켓플레이스를 통해 제공됩니다.
Anthropic 의 공식 마켓플레이스에서 플러그인을 설치하세요:

/plugin install superpowers@claude-plugins-official

Superpowers 마켓플레이스는 Superpowers 와 다른 관련 플러그인을 제공합니다.
Claude Code 에서 마켓플레이스를 먼저 등록하세요:

/plugin marketplace add obra/superpowers-marketplace

이후 이 마켓플레이스에서 플러그인을 설치하세요:

/plugin install superpowers@superpowers-marketplace

• 오픈 플러그인 검색 인터페이스 열기

/plugins

Superpowers 를 검색하세요:

superpowers

Install Plugin 을 선택하세요.

• Codex 앱에서 사이드바의 플러그인을 클릭하세요.
• 당신은 Coding section 에서
  Superpowers
  를 볼 수 있습니다. + 를 클릭하고 프롬프트를 따르세요.

Cursor Agent chat 에서 마켓플레이스에서 설치하세요:

/add-plugin superpowers

또는 플러그인 마켓플레이스에서 "superpowers" 를 검색하세요.

OpenCode 에게 다음을 말하세요:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

상세 문서: docs/README.opencode.md

copilot plugin marketplace add obra/superpowers-marketplace
copilot plugin install superpowers@superpowers-marketplace

gemini extensions install https://github.com/obra/superpowers

업데이트하려면:

gemini extensions update superpowers

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

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

테스트

test-driven-development- RED-GREEN-REFACTOR 사이클 (테스트 반패턴 참조 포함)

디버깅

systematic-debugging- 4 단계 원근 분석 프로세스 (원근 추적, 방어를 위한 깊이, 조건 기반 대기 기술 포함)
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- 두 단계 검토 (스펙 준수, 코드 품질) 를 통한 빠른 반복

메타

writing-skills- 최선 관행에 따라 새로운 기술을 생성합니다 (테스트 방법론 포함)
using-superpowers- 기술 시스템 소개

Test-Driven Development- 테스트를 먼저 작성하세요, 항상
Systematic over ad-hoc- 프로세스보다 추측
Complexity reduction- 단순성이 주요 목표
Evidence over claims- 성공을 선언하기 전에 검증합니다.

원본 릴리스 발표문을 읽으세요.

Superpowers 의 일반적인 기여 프로세스는 다음과 같습니다. 새로운 기술을 수용하지 않는다는 점과 모든 지원 코딩 에이전트에서 작동해야 하는 업데이트가 필요하다는 점을 기억하세요.

• 저장소를 포크합니다.
• 'dev' 브랜치로 전환합니다.
• 작업을 위한 브랜치를 생성합니다.
• writing-skills 기술에 따라 새로운 및 수정된 기술을 생성하고 테스트합니다 - PR 을 제출하며, 풀 리퀘스트 템플릿을 채워 넣으십시오.

완전한 가이드를 보려면 skills/writing-skills/SKILL.md 를 참조하세요.

Superpowers 업데이트는 코딩 에이전트 의존도가 어느 정도이지만 자주 자동적입니다.

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

Superpowers 는 Jesse Vincent 와 Prime Radiant 의 다른 사람들이 구축했습니다.

Discord: 커뮤니티 지원, 질문 및 구축 중인 내용을 공유하기 위해 저희와 함께하세요. Superpowers

Issues: https://github.com/obra/superpowers/issues

Release announcements: 새 버전 알림을 받기 위해 구독하세요.