「Superpowers」完全ガイド - Claude Codeを規律あるシニアエンジニアに変える

はじめまして、もるふぉ@コードをかかないAIエンジニアです。

エンジニアをやりながら、今はほぼコードを書かない開発スタイルに移行しました。

「書けないから書かない」じゃなくて、「書けるから書かなくていい」という話です。

実案件ベースで気づいたことだけ書いています。

Claude Codeを使っていて、こんな経験はないだろうか。

• いきなりコードを書き始めて、後から設計ミスに気づく
• テストを書かずに実装が進み、バグの温床になる
• 長時間の作業でAIの出力品質がどんどん劣化する

これらはすべて、AIコーディングエージェントが抱える構造的な問題だ。

この問題を根本から解決するのが、Jesse Vincent氏とPrime Radiantチームが開発したオープンソースプラグイン「Superpowers」だ。

GitHub - obra/superpowers: An agentic skills framework & software development methodology that works. · GitHub

github.com

2025年10月に初版が公開され、2026年1月にAnthropicの公式プラグインマーケットプレイスに採択。公開から約5ヶ月でGitHub Stars 10万超を記録し（2026年3月時点）、急成長しているオープンソースプロジェクトの一つとなっている。

本記事では、Superpowersの設計思想から実際のプロンプト例まで、導入してすぐ使えるレベルで解説する。読み終えた後には、今日から開発フローを変えられるはずだ。

Superpowersとは何か

Superpowersは「AIコーディングエージェント向けのスキルフレームワーク兼ソフトウェア開発方法論」だ。Claude Code、Cursor、Codex、OpenCode、Gemini CLIなど主要なAIコーディングツールに対応している。

核心となるアイデアは非常にシンプルだ。「より賢いモデルを求めるのではなく、既存のモデルに厳格な方法論を課すことで、より良い結果を得る」。つまり、AIの能力そのものを上げるのではなく、AIの「働き方」を改善するアプローチだ。

具体的には、以下のような「スキル」と呼ばれるルールセットを、AIエージェントのセッション開始時に注入する。AIは各タスクの前に関連するスキルを自動的にチェックし、それに従って行動する。これは単なる提案ではなく、強制的なワークフローだ。

7ステップの開発ワークフロー

Superpowersが提供する開発ワークフローは、以下の7つのステップで構成される。

Step 1: ブレインストーミング

コードを1行も書く前に、まず設計を練る。Superpowersが有効な状態でClaude Codeに「こういう機能を作りたい」と伝えると、AIはいきなりコードを書き始めるのではなく、質問を投げかけてくる。要件を深掘りし、代替案を検討し、設計を読みやすい単位で提示してくれる。

このステップにより、「作り始めてから方向性が違った」という手戻りを大幅に削減できる。

Step 2: Git Worktreeの活用

Git Worktreeとは、同一リポジトリを複数ディレクトリで同時に操作できるGitの機能だ。設計が承認されたら、Git Worktreeを使って隔離されたワークスペースを新しいブランチ上に作成する。これにより、メインブランチを汚すことなく、安全に実験的な変更を進められる。

Step 3: 計画の作成

設計ドキュメントを元に、2~5分程度で完了できる粒度のタスクに分解した実装計画を作成する。各タスクは「意欲的なジュニアエンジニアでも理解できるレベル」の明確さで記述される。これが後述するサブエージェント駆動開発の土台となる。

Step 4: サブエージェント駆動開発

ここがSuperpowersの最大の革新だ。計画に基づいて各タスクを実行する際、タスクごとに新しいサブエージェントを起動する。各サブエージェントは、そのタスクの仕様と関連するコードコンテキストだけを受け取り、クリーンな状態で作業する。

なぜこれが重要なのか。従来、長時間のAIコーディングセッションでは、コンテキストウィンドウに情報が蓄積され、AIが「焦点を失い」、エラーが蓄積される問題があった。サブエージェント駆動開発では、各タスクが独立したエージェントで実行されるため、数時間にわたる自律的な開発でも品質が維持される。

さらに、各サブエージェントの作業には2段階レビューが組み込まれている。

1. Stage 1 - 仕様準拠チェック: 実装が計画の仕様に適合しているか検証
2. Stage 2 - コード品質チェック: 可読性、パフォーマンス、セキュリティなどを検証

レビューで重大な問題が見つかった場合、次のタスクへの進行がブロックされる。

Step 5: テスト駆動開発

SuperpowersのTDDスキルは、RED-GREEN-REFACTORサイクルを強制する。具体的には以下のルールが適用される。

• まず失敗するテストを書く（RED）
• テストが失敗することを確認する
• テストを通す最小限のコードを書く（GREEN）
• テストが通ることを確認する
• コードをリファクタリングする（REFACTOR）
• コミットする

注目すべきは、テストより先にプロダクションコードを書いた場合、Superpowersはそのコードを削除させ、やり直しを命じるという点だ。これにより、AIが「テストを後回しにする」という悪い癖が構造的に防止される。

Step 6: コードレビュー

タスク間でコードレビューを実施する。レビューは別のサブエージェントが担当し、計画に対して実装が正しいか、コード品質は十分か、エッジケースが考慮されているかを体系的にチェックする。問題がある場合はその重要度に応じて対応を決める。軽微な問題は記録のみ、重大な問題は次のタスクへの進行をブロックする。

Step 7: ブランチの完了

すべてのタスクが完了したら、テストスイートを実行して全テストが通ることを確認し、メインブランチへのマージ判断を行う。

スキルライブラリの全体像

Superpowersに含まれるスキルは、以下のカテゴリに分類される。

特筆すべきは「1%ルール」だ。あるスキルが現在のタスクに適用される可能性が1%でもあれば、エージェントはそのスキルを必ず呼び出さなければならない。これにより、スキルの適用漏れを防いでいる。

systematic-debugging: デバッグの革命

Superpowersのデバッグスキルは、従来のAIによる「当て推量デバッグ」を完全に排除する。4段階のプロセスが定義されている。

1. 根本原因の調査: エラーを読み、再現し、変更点を確認して証拠を収集する
2. パターン分析: 動作する例を見つけ、比較して差異を特定する
3. 仮説検証: 理論を立て、最小限のテストで確認する
4. 実装と検証: テストを作成し、修正し、テストが通ることを確認する

「printデバッグを散りばめて推測する」のではなく、体系的に根本原因を特定する。これだけでもSuperpowersを導入する価値がある。

実践: Superpowersを使った開発の流れ

実際にSuperpowersを導入した開発がどのように進むか、具体的に見ていこう。

自然言語でスキルを起動する

Superpowersのスキルは、自然言語で起動できる。コマンドを暗記する必要はない。

# ブレインストーミングを起動
「ユーザー認証機能を追加したい。設計を一緒に考えてほしい」

# 計画の作成を起動
「この設計で進めよう。実装計画を立ててくれ」

# デバッグスキルを起動
「ログイン時にエラーが出る。一緒にデバッグしよう」

AIが意図を認識し、適切なスキルを自動的にロードする。スラッシュコマンド（/brainstorm、/write-plan など）で明示的に起動することも可能だ。

ブレインストーミングの実際

「こういう機能を作りたい」と伝えると、Superpowersが有効なClaude Codeは以下のように振る舞う。

1. 要件を明確にするための質問を投げかける
2. 複数のアプローチを提示し、それぞれのトレードオフを説明する
3. 設計を読みやすいチャンクに分けて提示する
4. ユーザーの承認を得てから次のステップに進む

これにより、AIが暴走してコードを書き散らすのを防ぎ、人間が設計の主導権を握り続けることができる。

サブエージェント駆動開発の威力

計画が承認され「実行してくれ」と伝えると、Superpowersはサブエージェント駆動開発を開始する。メインエージェントがオーケストレーターとなり、各タスクを独立したサブエージェントに割り振る。

この仕組みの最大のメリットは、数時間にわたる自律的な開発が可能になることだ。従来は30分も経つとAIの出力品質が劣化していたが、サブエージェント駆動開発では各タスクが独立した「新鮮な」エージェントで実行されるため、最後のタスクまで高品質な出力が維持される。

Superpowersが向いているケース・向いていないケース

Superpowersはすべてのシーンに最適というわけではない。導入を検討する際の判断基準を整理する。

向いているケース

• 品質を重視するプロダクション開発
• テストカバレッジとコードレビューが重要なプロジェクト
• チーム開発でコード品質の一貫性を保ちたい場合
• 数時間にわたる大規模な機能開発
• AIに長時間の自律的な作業を任せたい場合

向いていないケース

• ちょっとしたバグ修正や1ファイルのスクリプト作成
• 探索的なプロトタイピング（方向性が未確定な段階）
• 速度が品質より重要なケース

エコシステムの広がり

Superpowersは本体だけでなく、周辺のエコシステムも急速に発展している。

• superpowers-lab: 実験的な新スキルを試せるリポジトリ
• superpowers-skills: コミュニティスキル集（現在はアーカイブ済み。スキルはコアリポジトリに統合）
• superpowers-chrome: Chrome DevTools Protocol経由でブラウザを直接操作するプラグイン
• superpowers-marketplace: キュレーションされたプラグインマーケットプレイス

また、writing-skills スキルを使えば、自分のプロジェクトに特化したカスタムスキルを作成することもできる。チーム固有のコーディング規約やレビュー基準をスキルとして定義すれば、AIエージェントがそれに従って開発を進めてくれる。

インストール方法

Superpowersは各ツールで簡単にインストールできる。ここでは主要な方法を紹介する。

Claude Code（公式マーケットプレイス）

Claude Codeの公式マーケットプレイスに採択されているため、1コマンドでインストールできる。

/plugin install superpowers@claude-plugins-official

カスタムマーケットプレイス経由でインストールする場合は以下のコマンドを使う。

# マーケットプレイスの追加
/plugin marketplace add obra/superpowers-marketplace

# プラグインのインストール
/plugin install superpowers@superpowers-marketplace

Cursor

/add-plugin superpowers

Gemini CLI

gemini extensions install https://github.com/obra/superpowers

アップデート

/plugin update superpowers

MITライセンスで完全に無料だ。

まとめ: なぜ今Superpowersを導入すべきか

Superpowersが示した最も重要な洞察は、「AIの能力を上げるより、AIの働き方を改善する方が効果的」ということだ。

より高性能なモデルを待つのではなく、今あるモデルに対して設計、計画、TDD、コードレビューという人間が長年培ってきたソフトウェアエンジニアリングのベストプラクティスを適用する。その結果、AIコーディングエージェントは「コードを吐き出す機械」から「規律あるシニアエンジニア」へと変貌する。

インストールは1コマンド。Superpowers自体の費用はゼロ。MITライセンスで完全オープンソース。サブエージェント駆動開発ではタスクごとにエージェントを起動するためAPIトークン消費量は増加するが、手戻りの削減と品質向上を考えれば十分に見合う投資だ。

今すぐ試す3ステップ

1. Claude Codeで /plugin install superpowers@claude-plugins-official を実行する
2. 次の開発タスクで「設計を一緒に考えてほしい」と伝えてみる
3. AIがいきなりコードを書き始めず、要件の深掘りから始めることを確認する

この3ステップだけで、Superpowersがどう機能するかを体感できる。まず1つのタスクで試してみてほしい。

参考リンク:

• GitHub - obra/superpowers
• GitHub - obra/superpowers-lab（実験的スキル）
• GitHub - obra/superpowers-skills（コミュニティスキル・アーカイブ済み）
• GitHub - obra/superpowers-chrome（ブラウザ操作プラグイン）

よければXもフォローしてもらえると嬉しいです → X(@morphox_ai)