Markdown 버전

AI-translated from English; not yet reviewed by a fluent editor.

# Claude Code에서 Superpowers로 코드 변경 하나를 계획하고 테스트하고 검토하기

> 승인된 Superpowers 설계와 계획, 실제로 확인한 빨강·초록 테스트, 작업 및 전체 브랜치 검토를 거쳐 책임자의 결정까지 진행하는 문서 기반 가이드입니다.

By BIG CHANGE Editorial

Published: 2026-10-20T10:39:38.153Z
Updated: 2026-10-20T10:39:38.153Z
Canonical: https://bigchange.ai/blog/superpowers-claude-code-plan-test-review-change-guide

![Conceptual charcoal illustration of a long, unlettered code-diff proof sheet emerging from a printer across an inspection table, with a short orange passage.](https://bigchange.ai/api/media/file/superpowers-whole-branch-proof-hero-v1.png)
AI-generated conceptual illustration by BIG CHANGE.

Superpowers는 직접 관리하는 Git 저장소에서 큰 변경을 수행하는 Claude Code 사용자를 안내할 수 있습니다. 설계를 합의하고 작업 계획을 승인한 다음, 테스트와 함께 구현하고 각 작업 및 최종 브랜치를 검토하는 과정입니다. 이 가이드는 2026년 10월 20일 확인한 Superpowers 7.0.0 공식 매뉴얼을 따릅니다. BIG CHANGE는 문서를 검토했으며, 플러그인을 설치하거나 실제 프로젝트를 이 과정으로 실행하지 않았습니다.

## 핵심 변화

- **달라진 점:** 승인된 설계와 구현 계획은 코딩 에이전트가 저장소를 수정하기 전에 구체적인 작업과 제약을 제공합니다.
- **중요한 이유:** 문서상 작업 흐름은 실제로 관찰한 테스트 실패·통과와 한 검토자의 명세 및 품질에 대한 별도 판단을 연결한 뒤 전체 브랜치를 더 넓게 검토합니다.
- **주의할 점:** 책임자는 여전히 전체 diff와 최신 인수 결과를 확인하고 브랜치의 처리 방식을 결정합니다. 에이전트 흐름이 완료되어도 공개된 지적 사항이 남을 수 있습니다.

## 시작하기 전에

직접 소유하거나 편집 권한이 있는 저장소에서 승인된 여러 단계의 코드 변경 하나를 선택하세요. 검토 가능한 작업으로 나눌 수 있고 테스트할 동작이 있어야 합니다. 요청 동작, 영향 범위, 제외 사항, 원래 인수 명령과 시작 commit을 기록합니다. 작업 전에 그 명령과 관련 기존 검사를 실행하세요. 시작 상태부터 실패한다면 지금 원인을 확인합니다. 이후 빨강 또는 초록 결과에는 알려진 기준점이 필요합니다.

Git, 인증된 Claude Code 설치, 플러그인 설치 및 브랜치나 worktree 생성 권한, Claude Code와 하위 에이전트에 충분한 요금제 또는 API 용량이 필요합니다. 소스 코드 접근과 플러그인 사용에 관한 조직 규칙을 확인하세요. 활성화 전에 플러그인 내용, 실제 권한, 공급자 데이터 약관과 지출 제어를 검토합니다. Anthropic은 플러그인 hook과 서버 프로세스가 도구 호출 샌드박스 밖에서 사용자 권한으로 실행될 수 있다고 경고합니다. 일반적인 도구 권한 요청이 이런 코드 전체를 다루지는 않습니다. 비밀정보, 의존성, 외부 쓰기, push와 릴리스는 실제로 부여받은 권한 안에서 처리하세요. [Claude Code 플러그인 보안 문서](https://code.claude.com/docs/en/plugins/security)에서 이 경계를 설명합니다.

아래 경로는 여러 작업이 있는 변경에 Superpowers의 `subagent-driven-development` 스킬을 사용합니다. 매뉴얼은 직접 진행하는 `executing-plans` 경로도 설명하며 작은 작업에는 간단한 설계 합의를 허용합니다. 모든 프로젝트에 전체 과정이 필요하다고 가정하지 말고, 구현 전에 책임자와 경로를 선택하세요.

## 1. 플러그인을 설치하고 활성 버전 확인하기

대화형 Claude Code 세션에서 [공식 마켓플레이스 명령](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md)을 입력하세요.

```text
/plugin install superpowers@claude-plugins-official
```

Claude Code는 설치 전에 플러그인 상세 패널을 엽니다. 내용을 살펴보고 허용된 범위를 선택합니다. 로컬 범위는 이 저장소에서 본인에게 활성화하고, 프로젝트 범위는 협업자의 저장소 설정에 영향을 줍니다. 설치 요약과 Errors 탭을 읽으세요. 세션의 활성화 지침을 따르거나 다시 시작한 뒤 Installed 탭을 확인하고 shell에서 `claude plugin list` 명령을 실행합니다. 표시된 Version, Scope, Status를 기록하고 활성 세션에서 Superpowers 스킬을 사용할 수 있는지 확인하세요. 마켓플레이스 명령은 이 가이드에서 조사한 commit을 고정하지 않습니다. 설치 버전이나 스킬 내용이 7.0.0과 다르면 계속하기 전에 해당 버전에 맞춰 절차를 조정하세요. 설치 실패나 비활성 상태에서는 중단해야 하며, 흐름이 로드되었다는 증거가 아닙니다. [Claude Code 설치 가이드](https://code.claude.com/docs/en/discover-plugins)에서 이 검사를 설명합니다.

## 2. 설계를 승인하고 다음에 계획 승인하기

실제 변경, 인수 기준, 시작 결과와 금지된 편집을 Claude Code에 알려주세요. Superpowers의 `brainstorming` 과정으로 의도, 설계 선택과 제약을 확정합니다. 이 여러 단계의 변경에서는 작성된 설계와 빌더 검사 결과를 확인하고, 책임자가 결정할 질문을 해결한 뒤 전체 설명을 승인하세요. 승인은 만들 동작을 기술해야 하며 에이전트가 계속 말한다는 이유로 추정해서는 안 됩니다. [설계 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/brainstorming/SKILL.md)은 작은 작업에 간단한 합의나 명시적 제외를 허용하므로, 여기서는 큰 작업을 위해 전체 경로를 의도적으로 선택합니다.

다음으로 `writing-plans` 과정에 설계를 작업으로 나누도록 요청합니다. 계획의 파일 경계, 인터페이스, 전역 제약, 테스트 명령과 Review Focus를 검토하세요. 각 작업은 검사 가능한 크기여야 하며 테스트는 합의된 동작을 측정해야 합니다. 코드 변경 전에 계획과 하위 에이전트 실행 방식을 승인합니다. [계획 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/writing-plans/SKILL.md)에서 인계를 정의합니다. 그럴듯한 계획을 의존성 추가나 무관한 파일 수정의 허가로 받아들이지 마세요.

실행할 때 `using-git-worktrees` 과정은 적합한 기존 작업공간을 확인하거나 필요한 동의를 얻어 격리된 공간을 준비합니다. 실제 브랜치, 기준 commit과 깨끗한 시작 상태를 기록하세요. 가능한 경우 Claude Code의 기본 worktree 지원을 사용합니다. 무관한 수정이 있다면 계속하기 전에 책임 소재를 해결하세요. [worktree 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/using-git-worktrees/SKILL.md)에서 검사와 생성 경로를 설명합니다.

## 3. 각 테스트와 작업 검토 관찰하기

승인된 계획으로 `subagent-driven-development` 스킬을 사용해 독립적으로 검토 가능한 작업을 실행합니다. 현재 매뉴얼은 작업에 구현자를 배정한 뒤 구현과 diff를 **한 명의 작업 검토자**에게 전달합니다. 검토자는 작업이 명세에 맞는지와 구현 품질이 허용 가능한지 두 판단을 내립니다. 한 번의 검토에서 나오는 두 결론이며, 검토 에이전트 둘이 차례로 실행되는 것이 아닙니다. 같은 형태의 작은 작업은 매뉴얼 규칙에 따라 묶을 수 있습니다. [작업 흐름](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md)과 [검토자 프롬프트](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/task-reviewer-prompt.md)에서 이 순서를 정합니다.

테스트 선행에 맞는 각 동작에 관찰 가능한 빨강·초록 순환을 요구하세요. 동작 테스트를 추가해 실행하고 예상된 실패를 확인합니다. 최소 구현을 만든 뒤 다시 실행해 통과를 확인하고, 검사를 통과한 상태로 리팩터링합니다. 가져오기 오류나 고장 난 테스트 기반은 예상된 빨강 결과가 아닙니다. 각 작업의 명령, 출력과 관련 commit 또는 diff를 보관하세요. [테스트 주도 개발 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/test-driven-development/SKILL.md)은 사람의 합의가 필요한 예외를 설명합니다. 이 가이드는 일반적인 테스트 선행 경로에 맞는 작업을 전제합니다.

두 검토 판단과 실제 diff를 읽으세요. 작업을 수락하기 전에 “diff로 검증할 수 없음” 항목을 계획과 저장소로 해결합니다. 수정과 해당 범위의 재검토를 확인하세요. 새 성공 주장은 새 테스트 결과가 아닙니다. 7.0.0 흐름은 수정 반복을 제한하고 서면 판단과 함께 지적 사항을 보류할 수 있습니다. 이를 이후 검토를 위해 보존하세요. 완료 표시가 반드시 지적 없는 검토를 의미하지는 않습니다.

작업이 끝나면 **별도의 전체 브랜치 검토**를 확인합니다. 작업 사이 상호작용을 찾고, 단일 diff에서 판단할 수 없어 보류한 지적을 다시 살필 수 있습니다. 열린 이슈마다 증거와 판단 근거를 요청하세요. 플러그인의 임시 작업공간 정리 전에 설계, 계획, 테스트 출력, 검토 보고서와 전체 diff를 보관합니다. 예상 스킬이 실행되지 않았다면 활성 플러그인 상태, 버전과 문서의 진단 경로를 확인하세요. 설치했다는 사실만으로 흐름이 강제되었다고 가정하지 마세요.

## 4. 브랜치를 확인하고 처리 결정하기

최종 코드에서 원래 인수 명령과 프로젝트의 전체 테스트를 다시 실행합니다. 최신 출력, 전체 브랜치 diff와 모든 미해결 지적을 확인하세요. [Superpowers 검증 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/verification-before-completion/SKILL.md)은 완료 주장 전에 현재 상태의 증거를 요구합니다. 테스트가 실패하면 정확한 실패를 찾아 수정하거나 검토할 수 있도록 브랜치를 남기세요. 테스트 모음이 실패하면 문서상 브랜치 마무리 메뉴로 진행하지 않습니다.

이름이 있는 브랜치에서는 `finishing-a-development-branch` 스킬이 로컬 병합, push 및 pull request 생성, 또는 그대로 유지를 제시합니다. 분리된 HEAD에서는 pull request와 유지 옵션이 있습니다. 폐기는 책임자의 명시적 요청과 입력 확인 후 별도로 처리하며 일상적인 네 번째 옵션이 아닙니다. [브랜치 마무리 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/finishing-a-development-branch/SKILL.md)에서 이 선택을 설명합니다. 책임자의 결정 전에 검사, diff와 남은 지적을 보여주세요. 병합, push, 삭제 또는 릴리스에는 해당 조치에 맞는 권한이 필요합니다.

유용한 결과는 원래 요구와 연결된 검토 가능한 브랜치입니다. 승인된 설계와 계획, 관찰한 테스트 결과, 두 작업 검토 판단, 전체 브랜치 검토, 전체 diff와 최신 인수 결과가 포함됩니다. 설치, 접근, 예산 또는 검사로 실행이 멈추면 검증된 산출물을 보존하고 마지막 완료 단계를 밝히세요. 문서는 과정을 설명하며, 실행하지 않은 이 가이드의 변경이 더 빠르거나 저렴하거나 결함이 적었다고 입증하지 않습니다.

## 출처 및 추가 자료

- [Superpowers 7.0.0 README 및 설치](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md): 프로젝트 공식 경로와 작업 흐름 설명입니다. 독자의 설치 버전이나 결과를 검증하지 않습니다.
- [Superpowers 작업 실행 매뉴얼](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md): 작업 검토자, 두 판단, 수정 결정과 최종 브랜치 검토입니다. 실제 설치 버전과 함께 읽으세요.
- [Claude Code 플러그인 설치](https://code.claude.com/docs/en/discover-plugins) 및 [보안](https://code.claude.com/docs/en/plugins/security): 범위, 활성화, 버전 확인과 실행 권한입니다. 조직 제어에 따라 사용 가능 항목이 달라질 수 있습니다.

단일 인수 검사 수정은 BIG CHANGE의 [실패한 저장소 검사 하나를 검증하는 가이드](https://bigchange.ai/blog/ai-goal-failing-repository-check-guide)를 참고하세요. 여기의 과정은 여러 작업의 변경을 설계하고 계획하는 더 이른 단계에서 시작합니다.

## Sources

- [Superpowers 7.0.0 README](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/README.md) — 프로젝트의 공식 마켓플레이스 명령과 전체 흐름입니다. 고정 참고자료이며 마켓플레이스가 그 정확한 commit을 설치했거나 흐름이 실행되었다는 증거는 아닙니다.
- [Superpowers brainstorming 스킬](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/brainstorming/SKILL.md) — 설계 질문, 빌더 검사와 사람의 승인을 설명합니다. 작은 작업은 간단한 경로를 따를 수 있습니다.
- [Superpowers writing-plans 스킬](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/writing-plans/SKILL.md) — 계획 구조와 검토 인계를 설명합니다. 실행하지 않은 프로젝트의 계획이 승인되었다는 뜻은 아닙니다.
- [Superpowers using-git-worktrees 스킬](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/using-git-worktrees/SKILL.md) — 기존 또는 격리 작업공간 선택, 동의와 시작 검사를 설명합니다. 이 보도에서는 worktree를 만들지 않았습니다.
- [Superpowers subagent-driven-development 스킬 및 작업 검토자](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/subagent-driven-development/SKILL.md) — 한 검토자의 명세·품질 판단, 제한된 수정 반복, 보류된 지적과 별도 전체 브랜치 검토를 정합니다. 완료 상태에 판단이 기록된 미해결 항목이 포함될 수 있습니다.
- [Superpowers test-driven-development 스킬](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/test-driven-development/SKILL.md) — 예상 빨강·초록·리팩터링과 사람과 합의한 예외를 설명합니다. 이 기사를 위해 테스트를 실행하지 않았습니다.
- [Superpowers verification-before-completion 스킬](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/verification-before-completion/SKILL.md) — 완료 주장에 최신 실제 명령 증거를 요구하며, 이 가이드의 결과를 입증하지 않습니다.
- [Superpowers finishing-a-development-branch 스킬](https://github.com/obra/superpowers/blob/bb92a77741419a4ab5f06e711a283343f1ada0c3/skills/finishing-a-development-branch/SKILL.md) — 이름 있는 브랜치와 분리된 브랜치의 선택, 별도 요청과 입력 확인이 필요한 폐기를 설명합니다. 책임자의 권한은 여전히 필요합니다.
- [플러그인 설치 및 관리 — Claude Code Docs](https://code.claude.com/docs/en/discover-plugins) — 현재 설치 패널, 범위, 활성화, Installed 탭과 CLI의 Version, Scope, Status 확인입니다. 로컬 정책에 따라 실제 가용성이 달라집니다.
- [플러그인 보안 — Claude Code Docs](https://code.claude.com/docs/en/plugins/security) — 플러그인 hook과 서버 프로세스가 모델 도구 호출 샌드박스의 권한 요청 밖에서 사용자 권한으로 실행될 수 있음을 설명합니다. 사용자는 로컬 접근을 검토해야 합니다.