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

Superpowersは、Claude CodeにTDD強制・サブエージェント並列実装・自動コードレビューを組み込む7フェーズ開発フレームワークです。 「より賢いLLMを待つのではなく、今あるClaudeに開発規律を仕込む」という設計思想で、2026年5月時点でClaudeプラグインのインストール数681,792件・GitHubスター約20万超を誇るOSSプラグインです（MIT・無料）。

この記事でわかること:

• Superpowersの正体と、なぜ2026年に急速に普及しているのか
• 7フェーズワークフローと14スキルの全体像と具体的な役割
• v5.1.0（2026年5月4日）の破壊的変更——旧スラッシュコマンドが動かない理由と対処法
• Claude Codeへの最新インストール手順と基本的な使い方
• 素のClaude Code・GSD・GTACKとの比較
• 料金・トークン消費・導入判断の基準
• こんな方におすすめ / おすすめしない方

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

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

Superpowers for Claude Codeとは

出典: Claude 公式サイト

Superpowers（公式リポジトリ: obra/superpowers）は、Jesse Vincent氏（Prime Radiant CEO）が開発した、AIコーディングエージェント向けのスキル／開発方法論フレームワークです。Claude Code、Cursor、OpenCode、Gemini CLI、GitHub Copilot CLIなど8種のエージェントに対応しており、MITライセンスで完全無料・オープンソースで公開されています。

技術的な実体は「YAMLフロントマターと数百語の指示を持つ14枚のSKILL.mdファイルのディレクトリ」です。セッション開始フックが約2,000トークンのbootstrap指示を注入し、各エージェントはホスト別プラグインマニフェスト（.claude-plugin/、.cursor-plugin/など）を通じてスキルを読み込みます。

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

Claude Code本体については、Claude Codeとは｜できること・料金・使い方を解説も合わせてご覧ください。

なぜ2026年に急速に普及したのか

2025年秋〜2026年春にかけて、AIコーディングの現場では「AIが書いたコードのデバッグに結局時間を取られる」「テストが書かれないままコードが量産される」「長時間セッションで品質が劣化する」といった課題が顕在化しました。

SuperpowersはTDDを強制し、サブエージェントで並列実装しつつ自動レビューを挟むという構造的な解法を提示したため、個人開発者・スタートアップ・テックリードから急速に支持を獲得しています。さらに2026年1月にAnthropicの公式プラグインマーケットプレイスに掲載されたことで、認知が一気に広がりました。

⚠️ v5.1.0（2026年5月4日）の破壊的変更——旧コマンドが動かない理由

2026年5月4日リリースのv5.1.0では、レガシースラッシュコマンドが全削除されました。 旧バージョンの解説記事を参照している場合、コマンドが動かない原因はここにあります。

v5.1.0のその他の主な変更点:

• コードレビュー機能の統合: 独立していた code-reviewer エージェントが requesting-code-review スキルに統合
• Git Worktreeスキルの改善: ベースラインテスト検証フローが強化
• BootstrapキャッシングでOpenCode性能改善: 特にOpenCode環境での起動速度向上

「/brainstormコマンドで起動」と書かれた記事、「v5.0.7が最新」という記事はいずれも旧情報です。現在の最新はv5.1.0（2026年5月4日）です。

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

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

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

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

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

特徴は、どのフェーズを今やっているかをエージェント自身が認識し、次のフェーズへ進む前に検証を要求する点にあります。

Classmethodの実践レポートによると、brainstormingスキル起動時のClaudeは一問一回答形式で質問します（「どこに置くか」「ビルド成果物の使い方」「キーリングバックエンド」など、粒度の細かいA/B選択式）。バッチでまとめて質問するのではなく、1問ずつ答えを確定させてから次に進む設計です。

14スキル完全解説

Superpowersは公式READMEで確認できる14スキルをカテゴリ別に提供しています（v5.1.0時点）。

テスト系（1スキル）

デバッグ系（2スキル）

verification-before-completion は見落とされがちですが実務上の効果が大きいスキルです。AIが「テストは通っているはずです」と推測で完了を宣言するのを防ぎ、実際にコマンドを走らせて出力を確認することを義務付けます。

コラボレーション系（9スキル）

receiving-code-review は、AIが「指摘を盲目的に適用する」のを防ぐスキルです。なぜその修正が必要なのかを理解し、疑問があれば質問することを強制します。これにより「適当にレビューを受け流す」問題を防ぎます。

メタ系（2スキル）

「1%ルール」とは、プロジェクトの .claude/rules/ または CLAUDE.md に書いたルールがSuperpowersのスキルより優先されるという設計原則です。組織固有のルールでSuperpowersを上書きできます。

インストール方法（v5.1.0対応・最新）

出典: anthropics/claude-code 公式GitHubリポジトリ

Superpowersの導入は数十秒で完了します。

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

/plugin install superpowers@claude-plugins-official

インストール後、/reload-plugins で有効化します。/plugin list で superpowers 5.1.0 と表示されれば完了です。

方法2: Superpowersコミュニティマーケットプレイス経由

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

インストール確認（v5.1.0）

/plugin list を実行して superpowers 5.1.0 が表示されれば成功です。

⚠️ 注意: v5.1.0以前の解説で「/helpを実行して /brainstorm /write-plan /execute-plan が一覧に出ていれば成功」と書かれているものがありますが、これらのコマンドはv5.1.0で削除済みです。インストール確認は /plugin list で行ってください。

他エージェントへのインストール

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

基本的な使い方（v5.1.0対応）

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

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

v5.1.0以降、スキルは自然言語でのトリガーまたは superpowers:スキル名 形式で呼び出します。

superpowers:brainstorming ユーザー認証機能を追加したい

または、自然言語で「設計を一緒に考えて」と話しかけるだけでも brainstorming スキルは自動発火します（using-superpowers メタルールにより、1%でも該当すればスキルが呼び出されます）。

Claudeは「MFAは必須ですか？」「セッション期間は？」と一問一回答形式で質問してきます。ここで仕様を固めるほど、後工程の手戻りが減ります。

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

using-git-worktrees により、mainブランチから隔離されたworktreeが自動作成されます。失敗しても本体への影響はありません。ベースラインテストが通ることを確認してから実装フェーズに入ります。

ステップ3: 実装プランを書く

superpowers:writing-plans

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

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

superpowers:executing-plans

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

ステップ5: コードレビュー

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

ステップ6: 完了処理

finishing-a-development-branch と verification-before-completion が連携して、テスト・lint・buildを実際に実行して出力を確認します。マージ・PR作成・Stash・破棄の4択から選択します。

Implementer Status Protocol

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

素のClaude Codeとの比較

出典: Anthropic 公式サイト

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

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

Claude Code本体との使い分けについては、Claude Code 使い方・できること完全ガイドも参考にしてください。

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

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

3フレームワークは競合ではなく「非重複な次元」を制約しています。 Pulumiのフレームワーク比較記事では「品質規律はSuperpowers、長期コンテキストはGSD、製品設計はGSTACK」のように組み合わせて使う実務者もいると紹介されています。

特に長期プロジェクトでは「Superpowers（TDD・品質） + GSD（コンテキスト管理）の併用」が有効な組み合わせです。Superpowersは開発規律を担当し、GSDは複数セッションにまたがるコンテキスト保存を担当するという分業です。

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

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

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

実コストはClaude Code側に発生

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

⚠️ 起動コスト：約22,000トークン（ユーザー報告）

ユーザー報告（GitHub Issue #190）によると、Superpowersはセッション開始時にすべてのスキルをロードするため、約22,000トークン（200kコンテキストの約11%）を最初から消費します。Anthropicの「段階的開示」の想定（約1,400トークン）の約15.7倍に相当します。

これは長時間セッションでコンテキスト上限に達しやすくなる可能性を意味します。ただし、複雑なタスクでは構造化計画により無駄な探索が削減され、14〜60%のトークン削減実績も報告されています（MindStudio Blog・Pulumi Blog）。

トークン消費を抑えるための2つのポイント

1. 軽い修正には使わない — 1ファイル修正や試行錯誤には7フェーズのオーバーヘッドが重い。素のClaude Codeで対応する
2. 複雑・長時間タスクに集中投下 — 複数ファイルにまたがる機能実装や品質重視タスクでコスト効率が最大化する

Claude Code全体の料金については、Claude Code 料金プラン完全ガイドも参考にしてください。

メリット・デメリット

メリット

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

デメリット

• 軽いタスクには重い — 1ファイル修正や探索的プロトタイピングでは7フェーズのオーバーヘッドが無視できない。所要時間が素のClaude Codeの3〜6倍になる場合も
• 起動時に約22,000トークン消費 — コンテキストウィンドウの11%を最初から使用（ユーザー報告）
• 学習コスト — 14スキルの概念と呼び出し方を把握するのに時間がかかる
• 長期コンテキスト管理は弱め — 複数セッションにまたがる長期プロジェクトではGSDの方が強いという評価
• Anthropic公式サポート対象ではない — 公式マーケットプレイスに掲載はされているが、サポートはコミュニティベース（Discord / GitHub Issues）
• スキルインターフェースは英語のみ — スキルファイル自体は英語で記述されているため、プロンプトへの応答が英語ベースになることがある

こんな方におすすめ / おすすめしない方

こんな方におすすめ

• AIコーディングを業務で日常的に使っているエンジニア・テックリード — 1日数時間以上Claude Codeを使うなら、7フェーズのオーバーヘッドを回収しやすい
• 品質とスピードを両立させたいスタートアップ — 少人数でも規律ある開発を維持できる
• 複数ファイルにまたがる中〜大規模な機能実装が中心のチーム — サブエージェント並列実装が最も効果を発揮する
• 受託開発・SIerの開発チーム — TDD強制は成果物の品質説明もしやすい
• AIに任せたいが暴走が怖いチーム — worktree強制・検証強制で事故を防ぐ
• 独自のコーディング規約をチームに浸透させたい組織 — writing-skills でSKILL.mdに落とし込めば社内ルールをAIに継承できる
• 要件が曖昧で整理が必要なプロジェクト — brainstormingスキルが仕様固めを大幅に効率化

おすすめしない方

• 数行の修正や試行錯誤が中心の使い方 — 7フェーズが重すぎてストレスになる
• まだClaude Codeに慣れていない段階 — 素のClaude Codeで基本を押さえてからのほうが理解が速い
• トークン予算がシビアで、従量APIで節約運用している個人 — サブエージェント多用と起動コスト（約22,000トークン）で想定外の課金になりやすい
• テストのないレガシーコードを大量に抱えている組織 — いきなり全体にTDDを強制すると開発が停滞する。段階導入の計画を先に立てること
• 探索的プロトタイピングが主な用途 — 制約が強すぎる
• 既存プロジェクトの途中からの導入 — テストなしで書かれたコードは削除されるため、途中導入はリスクが高い。プロジェクト開始時からの採用を推奨

⚠️ 既存プロジェクトへの途中導入の注意点: test-driven-development スキルは、テストなしで書かれたコードを削除して再スタートさせる「鉄則」を持っています。既存コードベースに突然適用すると、大量のコードが削除対象になる可能性があります。特定モジュールから部分的にTDDを適用する段階導入が現実的です。

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

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

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

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

Superpowersフレームワーク自体はコード実行権限を持たない

Superpowersの技術的な実体はMarkdownファイルのみで構成されており、コードの実行権限は持ちません。追加的なセキュリティリスクは特に確認されていません。

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

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

コードレビュースキルにセキュリティチェックが内蔵

requesting-code-review / receiving-code-review スキルには、セキュリティ脆弱性・露出した認証情報・インジェクションリスクのチェックが含まれます。ただし、LLMの出力自体にハルシネーションが残る可能性は排除できません。本番コードへ反映する際は自社のセキュリティレビューを必ず通してください。

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

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

AIコーディングツール全般のセキュリティリスクについては、AIコーディングツールのセキュリティリスクと対策も合わせて確認してください。

よくある質問（FAQ）

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

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

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

Cursor、OpenCode、Gemini CLI、GitHub Copilot CLI、Codex CLI/App、Factory Droidなど8種のエージェントに対応する導入経路が用意されています。ただし2026年5月時点で最も成熟しているのはClaude Code上での挙動です。

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

プラグイン本体は無料（MITライセンス）です。Claude Code利用料は別途必要で、サブエージェントを多用する分トークン消費は増える傾向にあります。また、セッション起動時に約22,000トークン（ユーザー報告）を消費します。

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

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

Q5. v5.1.0で/brainstormが動かなくなりました。どうすれば？

v5.1.0でレガシースラッシュコマンドが削除されたためです。代わりに superpowers:brainstorming を直接プロンプトで呼び出すか、自然言語で依頼してください（using-superpowers メタルールにより自動発火します）。

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

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

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

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

Q8. GSDやGSTACKと一緒に使えますか？

併用可能です。「品質規律はSuperpowers・長期コンテキスト管理はGSD・製品設計はGSTACK」という組み合わせが実務者に使われています。3フレームワークは競合ではなく、それぞれ異なる次元を制約しているため、相互排他ではありません。

まとめ

Superpowers for Claude Codeは、「より賢いLLMを待つのではなく、今あるClaudeに開発規律を仕込む」という割り切りで急成長しているOSSスキルフレームワークです。2026年5月時点でAnthropicの公式マーケットプレイスへのインストール数681,792件、GitHubスター約20万超を誇る事実が、その実用性の高さを示しています。

2026年5月時点の重要ポイント:

1. v5.1.0（2026年5月4日）でレガシースラッシュコマンドが削除 — /brainstorm等は動かない。superpowers:スキル名形式または自然言語トリガーに移行する
2. 本質は「何ができる」ではなく「何を禁止するか」 — 推測表現禁止、main直接作業禁止、テスト前コード削除
3. 7フェーズ×14スキル — Brainstorm → Worktree → Plan → Subagent Dev → TDD → Code Review → Finalize
4. インストールはプラグインコマンド1行で完了 — /plugin install superpowers@claude-plugins-official
5. 軽いタスクには不向き、長時間・品質重視・複数ファイルのタスクに本領 — 起動コスト約22,000トークン（ユーザー報告）を考慮した使い分けが重要

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

• Claude Codeとは｜できること・料金・使い方を解説 — Claude Code本体の概要
• Claude Code 使い方・できること完全ガイド — 基本操作
• Claude Code 料金プラン完全ガイド — Pro / Max / APIの違い
• Claude Code MCP サーバー活用ガイド — Claude Codeをさらに拡張する方法
• OpenClaw vs Claude Code 徹底比較 — 他のAIコーディングツールとの比較
• AIコーディングツール おすすめ比較 — 他ツールとの選び分け