superpowers

무엇을 하는 플러그인인가

README는 이것을 코딩 에이전트용 소프트웨어 개발 방법론이라고 소개합니다. 조합 가능한 스킬과, 에이전트가 그 스킬을 쓰도록 만드는 지시문으로 이뤄집니다.

에이전트는 작업 전에 관련 스킬이 있는지 확인합니다. README는 이를 제안이 아닌 필수 워크플로로 설명합니다.

설치

Claude Code에서는 공식 마켓플레이스 이름으로 설치합니다. 작성자의 마켓플레이스(obra/superpowers-marketplace)를 추가해서 설치하는 방법도 README에 있습니다.

/plugin install superpowers@claude-plugins-official

기본 흐름 7단계

• brainstorming: 만들기 전에 원하는 것을 묻고 정리해 설계를 작은 덩어리로 보여줍니다.
• using-git-worktrees: 설계 승인 뒤 격리된 브랜치 작업 공간을 만들고, 테스트가 깨끗한 상태인지 확인합니다.
• writing-plans: 일을 2~5분짜리 작업으로 쪼개고 파일 경로, 코드, 검증 단계를 적습니다.
• subagent-driven-development 또는 executing-plans: 작업마다 새 서브에이전트와 리뷰를 쓰거나, 현재 세션에서 이어서 실행하고 마지막에 리뷰합니다.
• test-driven-development: 실패하는 테스트, 통과, 정리 순서를 강제합니다.
• requesting-code-review: 작업 사이에 리뷰하며, 심각한 문제는 진행을 막습니다.
• finishing-a-development-branch: 테스트를 확인하고 머지, PR, 보존, 폐기 중 고르게 한 뒤 정리합니다.

어떤 일에 맞고 어떤 일에 안 맞나

• 맞는 일: 새 기능처럼 요구가 아직 흐릿하고, 여러 파일을 건드리며, 테스트로 검증할 수 있는 작업.
• 안 맞는 일: 오타 수정이나 한 줄 설정 변경. 절차를 거치는 비용이 작업보다 큽니다. 이럴 땐 바로 하라고 지시하면 됩니다.
• 디버깅에는 systematic-debugging, 완료 선언 전에는 verification-before-completion 스킬이 따로 있습니다.
• 스킬 라이브러리에는 dispatching-parallel-agents, receiving-code-review, writing-skills 등도 들어 있습니다.

다른 도구와 비교

code-review 플러그인은 PR 하나를 리뷰하는 명령이고, superpowers는 계획부터 마무리까지의 절차 전체입니다. 공식 마켓플레이스의 feature-dev 플러그인도 탐색, 설계, 리뷰 에이전트를 쓰는 개발 흐름이라 용도가 비슷합니다.

실제 예시

회원가입 후 이메일 인증 기능을 추가하고 싶어.

질문 말고 그냥 진행해.

흔한 실수와 쓰지 말아야 할 때

• 작은 수정에도 설계, 계획, 리뷰가 붙어 시간이 늘어납니다. 작은 일은 처음부터 "간단한 수정이니 바로 해"라고 말하세요.
• 서브에이전트가 작업마다 돌기 때문에 토큰 사용량이 늘어날 수 있습니다. /usage로 확인하면서 쓰세요.
• README는 플러그인을 쓰는 도구마다 따로 설치하라고 안내합니다. Claude Code에 설치한 것이 다른 도구에 자동 적용되지 않습니다.
• brainstorming의 시각 보조 기능은 로고를 불러오며 superpowers 버전을 전송합니다. 끄려면 SUPERPOWERS_DISABLE_TELEMETRY를 참 값으로 설정합니다(README 기준).
• 스킬이 갑자기 불리지 않으면 세션을 새로 시작해 보라고 README가 안내합니다. 이 안내는 Hermes 에이전트 항목에 적혀 있으므로 Claude Code에서도 같다고 단정할 수는 없습니다.

자주 묻는 질문