Superpowers는 "coding agent"를 위한 에이전트 기반 "skill" 프레임워크이자 소프트웨어 개발 방법론이다. 이는 "agent"가 코드를 작성하기 전에 체계적인 접근 방식을 따르도록 돕는 것을 목표로 한다.

핵심 방법론 (How it works):
Superpowers는 개발 프로세스를 자동화하고 안내하기 위해 일련의 "skill"들을 활용한다.

1. Spec Teasing & Design Validation: "coding agent"는 코드를 바로 작성하지 않고, 먼저 사용자 대화를 통해 사용자가 진정으로 무엇을 만들고자 하는지 파악한다. 이 과정에서 명세("spec")를 도출하고, 이를 사용자가 읽고 이해하기 쉬운 작은 "chunk"로 나누어 제시하여 "design"에 대한 승인을 받는다.
2. Implementation Plan Creation: "design"이 승인되면, "agent"는 구현 계획("implementation plan")을 수립한다. 이 계획은 경험이 부족한 주니어 엔지니어("junior engineer")도 따를 수 있을 만큼 명확하게 작성되며, "true red/green TDD"(테스트 주도 개발), "YAGNI"(You Aren't Gonna Need It), "DRY"(Don't Repeat Yourself) 원칙을 강조한다.
3. Subagent-Driven Development (SDD): 계획이 준비되면, 시스템은 "subagent-driven-development" 프로세스를 시작한다. 이는 각 엔지니어링 작업("engineering task")에 대해 별도의 "subagent"를 투입하고, 해당 "subagent"의 작업을 검사하고 검토("inspecting and reviewing")하여 진행한다. "Claude"와 같은 "agent"는 수 시간 동안 자율적으로 작업할 수 있다. "skill"들은 자동으로 발동되어 사용자의 별도 조작 없이 "agent"가 Superpowers를 활용한다.

설치 (Installation):
설치 방법은 플랫폼에 따라 다르다. "Claude Code"는 "plugin marketplace"를 통해 설치하며, "/plugin marketplace add obra/superpowers-marketplace" 및 "/plugin install superpowers@superpowers-marketplace" 명령을 사용한다. "Codex"와 "OpenCode"는 GitHub의 특정 "INSTALL.md" 파일을 통해 수동으로 설정한다.

기본 워크플로우 (The Basic Workflow):
Superpowers는 다음과 같은 필수적인("mandatory") 워크플로우를 제공한다.

• brainstorming: 코드 작성 전에 활성화되어, 질문을 통해 아이디어를 다듬고 대안을 탐색하며, "design"을 섹션별로 제시하여 유효성을 검사하고 "design document"를 저장한다.
• using-git-worktrees: "design" 승인 후 활성화되며, 새 브랜치("branch")에 격리된 작업 공간("isolated workspace")을 생성하고, 프로젝트 설정을 실행하며, 깨끗한 테스트 기준선("clean test baseline")을 확인한다.
• writing-plans: 승인된 "design"과 함께 활성화되며, 작업을 2~5분 길이의 작은 "task"로 나눈다. 각 "task"에는 정확한 파일 경로, 완전한 코드, 검증 단계("verification steps")가 포함된다.
• subagent-driven-development 또는 executing-plans: 계획과 함께 활성화된다. "subagent-driven-development"는 각 "task"에 대해 새로운 "subagent"를 파견하여 두 단계의 검토("spec compliance" 및 "code quality")를 거치거나, "executing-plans"는 인간 검증 지점("human checkpoints")과 함께 일괄적으로 작업을 실행한다.
• test-driven-development: 구현 중에 활성화되어, "RED-GREEN-REFACTOR" 주기를 강제한다 (실패하는 테스트 작성, 실패 확인, 최소한의 코드 작성, 통과 확인, 커밋("commit")). 테스트("test") 작성 전에 작성된 코드는 삭제된다.
• requesting-code-review: "task"들 사이에 활성화되어, 계획("plan")에 대한 검토를 수행하고 심각도별로 문제("issues")를 보고한다. 치명적인 문제("critical issues")는 진행을 막는다.
• finishing-a-development-branch: "task" 완료 시 활성화되어, "test"를 확인하고, 병합("merge"), "PR"(Pull Request), 유지("keep"), 폐기("discard") 옵션을 제시하며, 작업 공간("worktree")을 정리한다.

내부 구성 (What's Inside) - Skill 라이브러리:

• Testing: test-driven-development ("RED-GREEN-REFACTOR" 주기).
• Debugging: systematic-debugging (4단계 근본 원인("root cause") 프로세스), 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 (새로운 "skill" 생성 지침), using-superpowers ("skill" 시스템 소개).

철학 (Philosophy):

• "Test-Driven Development" (TDD): 항상 "test"를 먼저 작성.
• "Systematic over ad-hoc": 즉흥적인 방식보다 체계적인 프로세스.
• "Complexity reduction": 단순성을 최우선 목표로.
• "Evidence over claims": 주장보다는 검증을 통해 성공 입증.

기여 및 업데이트 (Contributing & Updating):
"skill"은 GitHub 저장소에 직접 존재하며, "writing-skills" 가이드를 따르고 "PR"을 제출하여 기여할 수 있다. "skill" 업데이트는 "plugin" 업데이트("/plugin update superpowers")를 통해 자동으로 이루어진다.