Superpowers for Claude Code 使い方｜TDD強制7フェーズ開発フレームワーク徹底解説

Superpowersは、Claude CodeをはじめとするAIコーディングエージェントに「ブレインストーミング → 計画 → TDD → サブエージェント実装 → レビュー → 完了」の7フェーズを強制するオープンソースのスキルフレームワークです。「より賢いモデル」を待つのではなく、既存のClaudeにソフトウェア開発の規律を仕込むことで、手戻りの削減と品質保証を両立させるのが最大の狙いです。

この記事でわかること:

Superpowersの正体と、なぜ2026年に入って急速に普及したのか
7フェーズワークフローと14の主要スキルの全体像
Claude Codeへのインストール手順（3通り）と基本的な使い方
素のClaude Codeや他のAIコーディングフレームワーク（GSD / GSTACK）との違い
料金・トークン消費・導入時の注意点
こんな方におすすめ / おすすめしない方、導入後1週間のロードマップ

対象読者は、Claude Codeを日常的に使っているエンジニア・テックリード、AIコーディングの品質とスピードを同時に上げたい開発チーム、そして 「AIに任せたいが勝手にバグを埋め込まれるのが怖い」と感じている実務者です。

Superpowers for Claude Code 公式GitHubリポジトリ（obra/superpowers）

出典: Superpowers 公式GitHubリポジトリ

Superpowers for Claude Codeとは

Superpowers（公式リポジトリ名: obra/superpowers）は、Jesse Vincent氏（Prime Radiant）が開発した、AIコーディングエージェント向けのスキル／開発方法論フレームワークです。Claude Code、Cursor、OpenCode、Gemini CLI、GitHub Copilot CLIなど複数のエージェントに共通して導入でき、MITライセンスで無料公開されています。

リリース時期: 2025年10月に作者ブログ（blog.fsck.com）で公開
Anthropic公式採用: 2026年1月にClaudeの公式プラグインマーケットプレイスに掲載
インストール数: Claude公式プラグインページで 約47.6万件（2026年4月時点）
GitHubスター: 約94,000〜16万（公開ソースにより幅あり。公式プラグインページ基準で急成長中）
最新バージョン: v5.0.7（2026年3月31日リリース）
ライセンス: MIT（無料・OSS）

公式では「より賢いモデルを求めるのではなく、既存モデルに厳格な方法論を課す」という設計思想を打ち出しています。つまりSuperpowers自体は新しいLLMではなく、ClaudeなどのLLMに「仕事のやり方」を仕込むためのスキル集と理解すると分かりやすいでしょう。

なぜ急速に普及したのか

2025年秋〜2026年春にかけて、AIコーディングの現場では「AIが書いたコードのデバッグに結局時間を取られる」「テストが書かれないままコードが量産される」といった課題が顕在化していました。Superpowersはテスト駆動開発（TDD）を強制し、サブエージェントで並列実装しつつ自動レビューを挟むという解法を提示したため、実務者の支持を急速に獲得しています。

Claude Code本体については「Claude Codeとは」「Claude Code 使い方ガイド」も合わせて参照してください。

Superpowersが解決する「AIコーディング3つの問題」

Superpowersが狙い撃ちしているのは、従来のAIコーディングで頻発する3つの典型問題です。

問題	従来の状態	Superpowersの解法
テスト不足	実装が先行し、テストは後回しかスキップ	`test-driven-development` スキルでRED→GREEN→REFACTORを物理的に強制。テスト前の実装コードは削除対象
推測に基づくデバッグ	「たぶんこれが原因」でコードを書き換え、根本原因を見逃す	`systematic-debugging` で観察→仮説→検証→修正の4段階を徹底。3回失敗で設計を疑う
コンテキスト汚染	1つのセッションに全タスクを詰め込み、品質が劣化	`subagent-driven-development` で各タスクを独立サブエージェントに分離

ポイントは、「ルールを書く」のではなく「違反できない構造にする」こと。たとえば推測表現（should / probably）はスキルの中で明示的に禁止され、検証済みの事実のみ述べるよう強制されます。

Superpowersの7フェーズワークフロー

Superpowersが定義する開発プロセスは、次の7フェーズで構成されます。

#	フェーズ	代表スキル	役割
1	Brainstorm（発散・仕様策定）	`brainstorming`	ソクラティック対話で要件を1問ずつ深掘り。v5系では `spec-document-reviewer` が自動レビュー
2	Worktree（作業環境分離）	`using-git-worktrees`	Git worktreeで隔離ブランチを自動作成し、mainブランチを保護
3	Plan（計画）	`writing-plans`	タスクを2〜5分単位、ファイル単位で分解。期待結果を明文化
4	Subagent Dev（並列実装）	`subagent-driven-development` / `dispatching-parallel-agents`	各タスクを独立サブエージェントに割り当て。独立性が確認できた場合のみ並列実行
5	TDD（実装）	`test-driven-development`	RED→GREEN→REFACTORを強制。テスト先行でないコードは破棄
6	Code Review（レビュー）	`requesting-code-review` / `receiving-code-review`	Critical / Important / Minorで分類し、仕様・計画との整合を2段階で検証
7	Finalize（完了）	`finishing-a-development-branch` / `verification-before-completion`	テスト・lint・buildを実走確認。マージ／PR／破棄の4択から完了

特徴は、どのフェーズを今やっているかをエージェント自身が認識し、次のフェーズへ進む前に検証を要求する点にあります。人間側が「フェーズ1終わったよね？」と確認しなくても、Superpowersが自動で次工程に進む合図を出します。

主要14スキルの全体像

Superpowersは多数のスキルを内包していますが、読者が最初に押さえるべきは以下の14スキルです（v5.0系時点で確認できた範囲）。

設計・合意層

brainstorming — 一度に1問ずつ選択肢提示型で要件を掘り下げる
spec-document-reviewer（v5.0+・サブエージェント） — 仕様書を自動レビュー、修正ループが5回を超えたら人間判断を要求

計画層

writing-plans — 2〜5分粒度でタスクを分解、ファイルパスと期待結果を明示
executing-plans — 3タスク単位のチェックポイント付きバッチ実行

実装層

test-driven-development — RED-GREEN-REFACTORを強制
subagent-driven-development — サブエージェントごとに独立実装、コンテキスト汚染防止
dispatching-parallel-agents — 独立性が担保された場合のみ並列実行
using-git-worktrees — worktreeで隔離、main直接作業を禁止

品質保証・レビュー層

verification-before-completion — 「識別→実行→読解→確認→主張」の5段階検証。推測表現を出力から排除
systematic-debugging — 観察→仮説→検証→修正の4段階でデバッグ、3回以上失敗時は設計を疑う
requesting-code-review — レビュー依頼側のテンプレート
receiving-code-review — 「言われたから直す」を禁止し、理解と質問を強制
finishing-a-development-branch — マージ／PR／Stash／破棄の4オプションで完了

メタ層

using-superpowers — 「1%でも該当するならスキルを呼び出す」メタルール
writing-skills — 自社・自分向けの独自スキル（SKILL.md）を書く方法

補助ドキュメントとして、根本原因追跡法、4層バリデーション、条件ベース待機、テストアンチパターン、Cialdiniの説得原則（社会的証明・一貫性・権威など）などが付属します。Cialdiniの原則はSKILL.md内に埋め込まれ、LLMがスキルを無視しないよう心理的圧力をかける設計になっています。

Superpowersの14スキルを設計・合意・計画・実装・品質保証の各層で整理したイメージ

インストール方法（Claude Code）

Superpowersの導入は数十秒で完了します。公式では3つの導入経路が案内されています。

方法1: Superpowersマーケットプレイス経由（推奨）

Claude Codeのターミナル／スラッシュコマンドから次を実行します。

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

方法2: Anthropic公式マーケットプレイス経由

/plugin install superpowers@claude-plugins-official

方法3: `/plugins` UIから検索してインストール

/plugins を開き、superpowers を検索してクリックでインストールできます。

インストール確認

/help を実行し、下記のコマンドが一覧に出ていれば成功です。

/brainstorm
/write-plan
/execute-plan
/review
/finish

他プラットフォームでの導入

プラットフォーム	コマンド
Cursor	`/add-plugin superpowers`
GitHub Copilot CLI	`copilot plugin marketplace add obra/superpowers-marketplace`
Gemini CLI	`gemini extensions install https://github.com/obra/superpowers`
OpenCode / Codex	公式リポジトリのドキュメント手順に従う

ただし、2026年4月時点で最も成熟しているのはClaude Code上での挙動です。他エージェントではバージョンによって一部スキルが未対応の場合があるため、まずはClaude Codeでの運用に慣れてから横展開するのがおすすめです。

基本的な使い方

インストール後、日常的な開発フローは次のように変わります。

ステップ1: ブレインストーミングで要件を固める

/brainstorm ユーザー認証機能を追加したい

Superpowersは「いくつ質問してもいい？」「MFAは必須？」「セッション期間は？」と一問ずつ聞いてきます。ここで仕様を固めるほど、後工程の手戻りが減ります。自然言語で「設計を一緒に考えて」と話しかけるだけでも brainstorming スキルは自動発火します。

ステップ2: worktreeで作業環境を分離

using-git-worktrees により、mainブランチから隔離されたworktreeが自動作成されます。失敗しても本体には影響しません。

ステップ3: 計画を書く

/write-plan

タスクが2〜5分粒度で分解されます。各タスクには「変更するファイル」「期待する結果」が書き込まれます。

ステップ4: 計画を実行（TDD×サブエージェント）

/execute-plan

executing-plans が3タスク単位でバッチ実行し、各タスクは独立サブエージェントに渡されます。テストが先に書かれ（RED）、実装で通す（GREEN）、整理する（REFACTOR）の順序を守らないと、コードは破棄・書き直しになります。

ステップ5: レビュー

/review

requesting-code-review と receiving-code-review が協調し、Critical / Important / Minorの3段階で指摘。仕様書や計画と実装の整合も自動チェックされます。

ステップ6: 完了処理

/finish

テスト・lint・buildの実走を経て、マージ・PR作成・Stash・破棄のいずれかを選択できます。

Implementer Status Protocol

各サブエージェントは進捗を下記の4ステータスで返すため、長時間自律実行させても状況把握が可能です。

DONE — 完了
DONE_WITH_CONCERNS — 完了したが懸念あり
BLOCKED — 依存関係でブロック
NEEDS_CONTEXT — 追加情報が必要

素のClaude Codeとの違い

Superpowersの位置づけを理解するには、Claude Code単体で使った場合との比較が分かりやすいでしょう。

比較ポイント	素のClaude Code	Superpowers導入後
アプローチ	場当たり的（質問→実装）	構造化（7フェーズ）
テスト	任意	強制（テスト先行でないコードは破棄）
ブランチ安全性	main直接作業が可能	worktree強制
タスク粒度	曖昧、一気に書き進める	2〜5分粒度、ファイル単位
実行モード	単発セッション	サブエージェントで並列実装
コードレビュー	人間任せ	2段階の自動レビュー
推測表現	多発（`should`, `probably`）	禁止、検証済み事実のみ
自律時間	長時間は品質劣化しやすい	数時間単位でも品質維持
学習コスト	低い	中〜高（14スキルの概念理解が必要）
トークン消費	標準	増える傾向（サブエージェント多用）

要するに、Superpowersは「Claude Codeを規律あるチームに変える」拡張です。 スピードより品質、試行錯誤より設計、単独実装より分業を優先する思想が一貫しています。

他フレームワークとの比較（GSD / GSTACK）

Claude Code周辺には複数のオーケストレーションフレームワークがあります。主要3つを整理します。

軸	Superpowers	GSD (Get Shit Done)	GSTACK
創設者	Jesse Vincent（obra）	Lex Christopherson	Garry Tan（Y Combinator CEO）
GitHubスター（2026年4月時点）	約94,000〜16万	約51,000	約71,000
主な焦点	TDD強制・開発規律	コンテキスト劣化防止	ロールベース統治（23専門家）
向く場面	ソロ開発・品質優先	長時間・複数セッション・複数日	製品戦略を含むプロジェクト
弱点	軽量タスクに不向き	テスト規律は別途必要	純実装タスクは弱め
学習コスト	中〜高	中	中〜高

3つとも相互排他ではなく、「品質規律はSuperpowers」「長期コンテキストはGSD」「製品設計はGSTACK」のように組み合わせて使う実務者もいます。Pulumiの比較記事では「コンテキスト保存の仕組みはGSDの方が強い」と指摘されており、長期プロジェクトでの使い分けが推奨されています。

AIコーディングフレームワーク全体の比較は「AIコーディングツールおすすめ比較」「AIエージェントフレームワーク比較」も参考にしてください。

料金・トークン消費の考え方

プラグイン本体は無料（MITライセンス）

Superpowersのコード・スキル・ドキュメントはすべてMITライセンスで公開されており、プラグイン利用自体に費用はかかりません。

実コストはClaude Code側に発生

ただし、LLM呼び出しのトークン消費はClaude Code本体の料金プランに応じて発生します。

Claude Pro — 月$20
Claude Max — 月$100〜$200（利用枠が大きい）
Claude API（従量課金） — Claude CodeをAPIキーで使う場合

Superpowersはサブエージェントを多用するため、単発セッションと比べてトークン消費が増える傾向があります。公式にSuperpowers特化の倍率公開はありませんが、Claude Code全般でマルチエージェント構成にするとトークン使用量が数倍に伸びるケースが報告されています。コスト管理は次の2点を意識してください。

軽い修正には使わない — 1ファイル修正や試行錯誤には7フェーズのオーバーヘッドが重い
Max以上のプランを検討する — 日常的に使うなら、従量APIよりも定額Maxのほうが落ち着いて使える傾向

詳細なコストは「Claude Code 料金」「Claude Code コスト最適化」で整理しています。

v5.0で追加された主なアップデート

2026年3月のv5.0系では、品質保証の仕組みが強化されました。

spec-document-reviewer サブエージェントの標準化 — 仕様書の自動レビュー、修正ループが5回を超えたら人間判断を要求
人間介入の閾値が明文化 — 「いつエージェントを止めて人間に戻すか」の条件が形式化
圧力テストの強化 — 「本番障害で1分$5,000損失」などの想定シナリオでスキルが破綻しないかを検証
Visual Brainstorming Companion（一部環境） — WebSocketベース、ゼロ依存のブレスト補助UI

これらはいずれも「長時間自律実行時に品質が落ちない」ことを目的とした改修です。作者のJesse Vincent氏は、今後の拡張として「スキル共有マーケットプレイス」と「過去会話からの学習メモリ」を計画していると公式ブログで言及しています。

メリット・デメリット

メリット

手戻り削減 — 設計段階で要件が固まり、後半の修正が最小化される
当て推量デバッグの排除 — 推測表現が禁止され、根本原因ベースでの修正が強制される
長時間自律実行でも品質が落ちない — 各タスクが独立サブエージェントで動くため
チームの標準ワークフローをコード化できる — SKILL.mdで独自スキルを書けば、組織ルールをAIに継承可能
無料（MIT） — プラグイン自体にコストがかからない

デメリット

軽いタスクには重い — 1ファイル修正や探索的プロトタイピングでは7フェーズのオーバーヘッドが無視できない
学習コスト — 14スキルの概念と呼び出し方を把握するのに時間がかかる
トークン消費が増えやすい — サブエージェント多用のため
長期コンテキスト管理は弱め — 複数セッションにまたがる長期プロジェクトではGSDのほうが強いという評価
Anthropic公式サポート対象ではない — 公式プラグインページに掲載はされているが、サポートはコミュニティベース（Discord / Issues）

こんな方におすすめ

Superpowersは、以下のような方に向いています。

AIコーディングを業務で日常的に使っているエンジニア・テックリード — 1日数時間以上Claude Codeを使うなら、7フェーズのオーバーヘッドを回収しやすい
品質とスピードを両立させたいスタートアップ — 少人数でも規律ある開発を維持できる
受託開発・SIerの開発チーム — 成果物の品質が死活問題。TDD強制は顧客説明もしやすい
AIに任せたいが暴走が怖いチーム — worktree強制・検証強制で事故を防ぐ
独自のコーディング規約をチームに浸透させたい組織 — writing-skills でSKILL.mdに落とし込めば社内ルールをAIに継承できる

導入後1週間のロードマップ

初導入でつまずかないための、推奨される進め方です。

期間	やること	ゴール
1日目	インストール・`/help`で確認・公式READMEを通読	コマンド一覧と7フェーズの概念を把握
2〜3日目	小さな機能追加で `/brainstorm` → `/write-plan` → `/execute-plan` を一周	ワークフローを体感、TDDの強制を体験
4〜5日目	バグ修正で `systematic-debugging` を試す	推測デバッグが減り、根本原因に辿り着く感覚を得る
6日目	`writing-skills` で独自SKILL.mdを1つ書く	チームルールのコード化を試す
7日目	チーム内で使い所・コスト感・合わないケースを議論	標準ワークフロー化するかを決める

ポイントは、最初から全14スキルを覚えようとしないこと。 まず7フェーズを1周し、徐々にスキルを深掘りするほうが定着しやすいです。

セキュリティ・導入時の注意点

mainブランチ保護は機能するが過信は禁物

using-git-worktrees によりmainへの直接変更は防げますが、worktree内のファイル操作やシェルコマンドはClaude Code本体の権限設定に依存します。必ず権限設定とhooks設定を確認してください（参考: 「Claude Code Hooks 使い方」）。

本番運用では社内レビューが必須

MITライセンスの無保証OSSであり、Anthropicの公式サポート対象ではありません。本番コードへ反映する際は、自社のコードレビュー・セキュリティルールを必ず通してください。

ハルシネーション対策は「検証強制」で緩和されるが消えない

verification-before-completion で検証は強制されるものの、LLMの出力自体にハルシネーションが残る可能性はあります。「生成AI セキュリティリスク」も合わせて確認してください。

既存プロジェクトへの段階導入

テストが無いレガシーコードへの適用は、特定モジュールから部分的にTDDを適用する段階導入が現実的です。いきなり全体にRED-GREEN-REFACTORを強制すると、プロジェクトが停滞します。

よくある質問（FAQ）

Q1. Superpowersは公式プラグインですか？

Anthropicの公式プラグインマーケットプレイスに掲載されていますが、開発元はAnthropicではなく個人開発者のJesse Vincent氏です。サポートはコミュニティベース（GitHub Issues / Discord）となります。

Q2. Claude Code以外でも使えますか？

Cursor、OpenCode、Gemini CLI、GitHub Copilot CLIなどに対応する導入経路が用意されています。ただし2026年4月時点でもっとも成熟しているのはClaude Code上での挙動です。

Q3. 料金はかかりますか？

プラグイン本体は無料（MITライセンス）です。Claude Code利用料は別途必要で、サブエージェントを多用する分トークン消費は増える傾向にあります。目安は「Claude Code 料金」を参照してください。

Q4. 既存のテストが無いプロジェクトでも使えますか？

使えますが、いきなり全体でTDDを強制するとプロジェクトが停滞します。まず小さなモジュールから部分導入し、テストカバレッジを上げながら適用範囲を広げるのが現実的です。

Q5. 7フェーズを守らずに使うこともできますか？

コマンド（/brainstorm 等）を呼び出さずに自然言語で依頼しても、1%でも該当すればスキルが発火するメタルール（using-superpowers）により自動で規律が効きます。フェーズの一部だけを使う運用も可能です。

Q6. チームでの標準化はできますか？

writing-skills により、チーム独自のSKILL.mdを追加できます。社内のコーディング規約・レビュー観点・リリース手順をSKILL化すれば、AIが組織ルールに従って動きます。

Q7. GPT-5.4やGeminiでは使えませんか？

Gemini CLIには対応していますが、GPT系（OpenAI Codexなど）での利用は原理的に可能でも、スキル定義はClaude前提で書かれた部分が多いため、互換性は限定的です。Claude Codeを主軸にするのが無難です。

Q8. v5.0の目玉はなんですか？

spec-document-reviewer サブエージェントによる自動仕様レビューと、人間介入の閾値明文化です。長時間自律実行時に「どこで人間に戻すか」が形式化されました。

まとめ

Superpowers for Claude Codeは、「より賢いLLMを待つのではなく、今あるClaudeに開発規律を仕込む」という割り切りで急成長しているオープンソースのスキルフレームワークです。7フェーズと14スキルの全体像を押さえれば、Claude Codeは「質問すれば書いてくれる道具」から「規律あるチームメンバー」に変わります。

2026年4月時点で押さえるべきポイントは次の5つです。

本質は「何ができる」ではなく「何を禁止するか」 — 推測表現禁止、main直接作業禁止、テスト前コード削除
7フェーズ×14スキル — Brainstorm → Worktree → Plan → Subagent Dev → TDD → Code Review → Finalize
インストールはスラッシュコマンド1〜2本で完了 — /plugin install superpowers@superpowers-marketplace
料金はプラグイン側ゼロ・Claude Code側で増える — サブエージェント多用で消費トークン増
軽いタスクには不向き、長時間・品質重視のタスクに本領 — 導入判断は用途次第

合わせて読みたい関連記事:

Claude Codeとは — 本体の概要
Claude Code 使い方ガイド — 基本操作
Claude Code 料金 — Pro / Max / APIの違い
Claude Code サブエージェント使い方 — サブエージェントの基礎
Claude Code Skills 活用ガイド — SKILL.md書き方
Claude Code Hooks 使い方 — 権限・フック設計
AIコーディングツールおすすめ比較 — 他ツールとの選び分け
AIエージェントフレームワーク比較 — オーケストレーション全体像
エージェンティックエンジニアリングとは — 背景にある開発思想

この記事のポイント