Claude Code・Cursor・CodexでAIコーディングが暴走する人へ｜Superpowersの使い方・導入メリット・注意点を完全解説【2026年5月22日時点】

まず結論：AIにコードを書かせる前に、Superpowersを入れるべき人がいます

Claude Code、Cursor、CodexなどのAIコーディングエージェントを使っていて、次のような経験はありませんか。

「頼んでいない機能まで勝手に作られた」
「動いたと言われたのに、実際にはテストされていなかった」
「バグ修正を依頼したら、原因を調べずにそれっぽい修正だけされた」
「コードは速く出るが、設計・レビュー・検証が甘い」
「AIに任せるほど、あとで人間が確認する負担が増える」

この悩みを抱えているなら、最初に確認すべきGitHubリポジトリが Superpowers です。

Superpowersは、Claude Code、Cursor、Codex、OpenCodeなどのAIコーディングエージェントに、設計、計画、TDD、体系的デバッグ、コードレビュー、完了確認の流れを使わせるためのオープンソースのスキル・フレームワークです。公式READMEでも、Superpowersは「coding agentsのための完全なソフトウェア開発方法論」と説明されています。

導入手順を今すぐ確認したい人は、まず公式リポジトリを開いてください。

👉 Superpowers公式GitHubで導入方法を確認する

このリンクを最初に確認すべき理由はシンプルです。SuperpowersはAIに「もっと賢くコードを書かせる魔法」ではなく、AIに「人間の開発チームが本来踏むべき手順」を守らせるための仕組みだからです。

Superpowersとは何か？

Superpowersとは、AIコーディングエージェント用の「開発作法セット」です。

通常、AIエージェントに「ログイン機能を作って」「このバグを直して」「この画面を改善して」と頼むと、AIはすぐにコードを書き始めます。これは一見便利ですが、実務では危険です。なぜなら、AIは要件を誤解したまま実装したり、テストせずに完了報告したり、原因を調べずに症状だけ直したりすることがあるからです。

Superpowersは、この問題に対して「AIに開発プロセスを強制する」というアプローチを取ります。公式ドキュメントでは、Superpowersはエージェントを次のような流れに導くと説明されています。

設計を先に行う。
作業を小さく分解する。
失敗するテストを先に書く。
根本原因を調べてからデバッグする。
仕様適合性とコード品質の2段階でレビューする。
完了宣言の前に検証する。

つまり、Superpowersは「AIにコードを書かせるツール」ではありません。すでにコードを書けるAIに、「雑に書かせないための型」を与えるツールです。

なぜClaude CodeやCursorにSuperpowersが必要なのか？

AIコーディングエージェントの最大の魅力はスピードです。人間なら数時間かかる下書きや修正案を、AIは数分で出します。

しかし、スピードが速いほど危険も増えます。

たとえば、AIが設計を確認せずに実装すると、ユーザーが本当に欲しかった機能と違うものができます。AIがテストを後回しにすると、動いているように見えるだけのコードが混ざります。AIが原因調査をせずに修正すると、バグの根が残ったまま、別の場所に副作用が出ます。

Superpowersが価値を持つのは、まさにここです。

Superpowersのスキルシステムでは、各スキルがSKILL.mdとして定義され、いつ使うべきか、何をするか、どの手順で進めるかが書かれています。ドキュメントでは、スキルは「提案」ではなく「必須ワークフロー」であり、該当するタスクではエージェントがそれを使わなければならないと説明されています。

これは非常に重要です。なぜなら、AIの弱点は「知識がないこと」だけではなく、「知っているのに手順を飛ばすこと」だからです。

Superpowersは、AIに知識を追加するだけでなく、行動パターンを変えることを狙っています。

Superpowersでできること

Superpowersには複数のスキルがあります。代表的なものは次の通りです。

1. brainstorming：いきなりコードを書かせない

AIに「この機能を作って」と言うと、普通はすぐに実装が始まります。しかし、Superpowersではまずbrainstormingが働きます。

このスキルは、要件を会話で整理し、複数案を比較し、設計を短い単位で提示し、ユーザーが理解・承認してから次へ進むためのものです。公式Quickstartでも、Todoアプリの例を使い、AIが質問し、文脈を調べ、複数のアプローチとトレードオフを提示し、設計承認を得る流れが示されています。

これにより、「AIが勝手に作ったけど、欲しかったものと違う」という失敗を減らせます。

2. writing-plans：作業を小さく分解する

Superpowersは、承認された設計をそのまま実装させるのではなく、実装計画に落とし込みます。

公式Quickstartでは、実装計画が2〜5分程度の小さなタスクに分解され、それぞれに対象ファイル、テスト、確認手順が含まれる例が示されています。

これは、AI開発で非常に重要です。タスクが大きすぎると、AIは途中で文脈を失ったり、不要な変更を混ぜたりします。小さなタスクに分けることで、人間もAIもレビューしやすくなります。

3. test-driven-development：テストなし実装を防ぐ

Superpowersの中でも特に強力なのが、TDDスキルです。

公式ドキュメントでは、TDDの中心原則として「失敗するテストを先に見ていなければ、そのテストが正しいものを検証しているとは分からない」と説明されています。さらに「本番コードを書く前に失敗するテストを書く」というルールが明確に示されています。

これはAI開発では非常に重要です。

AIは「テストを書いて」と頼むと、実装後にそれっぽいテストを書くことがあります。しかし、実装後に書いたテストは、実装に合わせただけのテストになる危険があります。Superpowersは、RED、GREEN、REFACTORの順番を守らせることで、AIが本当に仕様を満たしているかを確認しやすくします。

4. systematic-debugging：思いつき修正を防ぐ

バグ修正でAIを使うと、よくある失敗があります。

それは、AIがエラーメッセージを十分に読まず、再現条件も確認せず、「たぶんここが原因です」と言って修正を始めることです。

Superpowersのsystematic-debuggingスキルは、この失敗を防ぐためのものです。公式ドキュメントでは、根本原因を見つける前に修正してはいけない、エラーを丁寧に読み、再現し、最近の変更を確認し、多層システムでは証拠を集める、という流れが示されています。

AIにバグ修正を任せるなら、この考え方は必須です。なぜなら、AIは「もっともらしい修正」を出すのが得意ですが、「本当にその修正が原因に対応しているか」を検証するには、手順が必要だからです。

5. requesting-code-review：AIにレビュー役を持たせる

Superpowersは、実装したら終わりではありません。

公式READMEでは、作業タスクの間にコードレビューを行い、計画への適合性やコード品質を確認し、重大な問題があれば進行を止める流れが説明されています。

これは、AIエージェントを「作業者」として使うだけでなく、「レビュー体制を含む小さな開発チーム」のように使う発想です。

1つのAIに全部やらせるのではなく、設計、実装、レビュー、修正を分ける。この考え方が、Superpowersの実務的な強さです。

Superpowersが向いている人

Superpowersは、次のような人に向いています。

Claude Codeで機能開発をしている人。
Cursor Agentで既存コードを編集している人。
Codex CLIでリポジトリ全体の変更を任せたい人。
AIにテスト駆動開発をさせたい人。
AIが勝手に実装を広げるのを防ぎたい人。
AI生成コードをレビューしやすくしたい人。
個人開発でも品質を落としたくない人。
チーム開発でAI利用ルールを整えたい人。

特に、「AIを使うと速いけど、あとで確認するのが怖い」と感じている人には相性が良いです。

AIエージェントの問題は、能力不足だけではありません。むしろ、能力が高いからこそ、間違った方向にも高速で進んでしまいます。Superpowersは、その速度にブレーキをかけるのではなく、レールを敷くためのツールです。

Superpowersが向いていない人

一方で、Superpowersが向いていない人もいます。

とにかく一瞬でプロトタイプを出したい人。
テストを書きたくない人。
設計や確認の会話が面倒な人。
AIには自由に書かせたい人。
小さな使い捨てスクリプトだけ作りたい人。

Superpowersは、AIに厳格な開発手順を守らせるツールです。そのため、何でも最短でコード化したい人には、少し重く感じる可能性があります。

実際、公式Quickstartでも、SuperpowersはTDDを全ての本番コードに適用し、簡単な変更でもTDDを飛ばさない姿勢を示しています。

これは長所でもあり、短所でもあります。

品質を重視する人には安心材料です。しかし、実験的に雑に作りたいだけの人には、手順が多く感じられるでしょう。

Claude CodeでSuperpowersを使う方法

Claude Codeで使う場合、Superpowersはプラグインマーケットプレイス経由で導入できます。

公式インストールページでは、Claude Codeでマーケットプレイスを登録し、superpowers@superpowers-marketplaceをインストールする手順が紹介されています。インストール後は新しいセッションで「Do you have superpowers?」と確認し、利用可能なスキルが表示されるかを確認する流れです。

Claude CodeでSuperpowersを使う価値は非常に大きいです。Claude Codeは強力ですが、強力だからこそ、設計確認なしに大量の変更を入れてしまうリスクもあります。Superpowersを入れることで、「まず設計」「次に計画」「その後TDD」「最後にレビュー」という流れに乗せやすくなります。

CursorでSuperpowersを使う方法

Cursorで使う場合も、Agentチャットから導入できます。

公式ドキュメントでは、Cursor Agentを開き、プラグイン追加コマンドでSuperpowersを導入し、新しいAgentセッションで確認する手順が示されています。また、Cursor ComposerとCursor Agentは異なるインターフェースであり、SuperpowersはAgentチャット向けに最適化されていると説明されています。

Cursorユーザーにとって重要なのは、既存コードベースとの相性です。Cursor Agentはワークスペース文脈を扱えるため、Superpowersのbrainstormingやwriting-plansが既存コード構造を参照しながら働きやすいとされています。

つまり、Cursorで既存プロジェクトをAI編集している人ほど、Superpowersの価値を感じやすいはずです。

CodexでSuperpowersを使う方法

Codexで使う場合、Superpowersはネイティブなスキル検出の仕組みを使います。

公式ドキュメントでは、Codexが~/.agents/skills/からスキルを自動検出し、Superpowersをcloneしてsymlinkを作ることでスキルを読み込ませる方式が説明されています。macOS/Linuxでは~/.codex/superpowersにcloneし、~/.agents/skills/superpowersへsymlinkを作る流れです。Windowsではjunctionを使う手順も示されています。

CodexでSuperpowersを使うメリットは、CLIベースの作業に開発規律を持ち込みやすいことです。ターミナルからAIに作業させる場合、変更範囲が広くなりやすいため、計画、テスト、レビューの仕組みがより重要になります。

Superpowersの最大の価値は「AIに人間の開発習慣を移植すること」

Superpowersの本質は、便利なコマンド集ではありません。

本質は、「熟練エンジニアが当然やっている確認手順を、AIにもやらせること」です。

良いエンジニアは、いきなり大きな実装をしません。まず要件を確認します。設計を考えます。小さく分けます。テストを書きます。原因を調べます。レビューします。完了前に検証します。

しかし、AIは放っておくと、この流れを飛ばしがちです。

Superpowersは、AIに対して次のように言う仕組みです。

「まず考えなさい」
「計画しなさい」
「テストを書きなさい」
「原因を確認しなさい」
「レビューを受けなさい」
「証拠なしに完了と言ってはいけない」

これは、AI開発時代にかなり重要な考え方です。

2026年時点では、AIコーディングエージェントの導入が進む一方で、エージェントの設定・スキル・サブエージェントの使い方はまだ発展途上です。2026年の研究でも、Claude Code、GitHub Copilot、Cursor、Gemini、Codexなどのエージェント設定には、Context Files、Skills、Subagentsといった仕組みが存在する一方、SkillsやSubagentsの採用はまだ浅い段階だと報告されています。

だからこそ、Superpowersのように「AIにどう作業させるか」を体系化するリポジトリは、今後さらに重要になります。

Superpowers導入前に知っておくべき注意点

Superpowersは強力ですが、万能ではありません。

まず、導入すればAIが絶対に正しいコードを書くわけではありません。SuperpowersはAIの行動を改善する仕組みであって、AIの出力を完全保証するものではありません。

次に、ワークフローが厳格なため、最初は面倒に感じる可能性があります。設計確認、計画、TDD、レビューが入るため、短い修正でも手順が増えたように見えることがあります。

さらに、ツールごとに導入方法が異なります。Claude Code、Cursor、Codex、OpenCodeではインストール手順が違うため、自分の環境に合った公式手順を確認する必要があります。

それでも、長期的に見ると、手順がある方が安全です。

AIに雑に作らせてあとで壊れるより、最初に設計・テスト・レビューを通した方が、結果的に修正コストは下がります。

Superpowersは「AIに任せたい人」ほど必要になる

AIコーディングエージェントを少しだけ使う人なら、Superpowersは必須ではないかもしれません。

しかし、AIに任せる範囲が広がるほど、Superpowersの重要性は増します。

小さな関数の修正なら、人間がすぐ確認できます。
しかし、複数ファイルにまたがる機能追加は違います。
テスト、設計、依存関係、データ構造、UI、API、セキュリティ、例外処理まで関わります。

この規模になると、「AIが出したコードを人間が後から全部読む」だけでは限界があります。

だからこそ、AIが作業する前に計画させる。
作業中にテストさせる。
作業後にレビューさせる。
完了前に検証させる。

この流れが必要です。

Superpowersは、そのための実践的な土台になります。

迷っているなら、まず公式GitHubを確認すべき

Superpowersは、AIコーディングエージェントを本格的に使う人にとって、単なる便利ツールではありません。

「AIにコードを書かせる」段階から、
「AIに開発プロセスを守らせる」段階へ進むためのツールです。

Claude Codeで開発している人。
Cursor Agentで既存コードを編集している人。
CodexでCLI開発を進めたい人。
AI生成コードの品質に不安がある人。
TDDやレビューをAIにも守らせたい人。

このどれかに当てはまるなら、Superpowersを確認する価値があります。

導入手順、対応ツール、スキル一覧、更新状況は公式GitHubで確認できます。

👉 Superpowers公式GitHubで導入方法を確認する

まとめ：SuperpowersはAIコーディングの「安全装置」である

Claude Code、Cursor、CodexのようなAIコーディングエージェントは、今後さらに強力になります。

しかし、強力になるほど、問題も大きくなります。

速く書けるAIは、速く間違えるAIでもあります。
広範囲を編集できるAIは、広範囲を壊すAIにもなります。
自信満々に完了報告するAIは、未検証のまま終わったと言うAIにもなります。

Superpowersは、この問題に対する現実的な対策です。

AIにブレーキをかけるのではありません。
AIに正しいレールを敷くのです。

設計してから作る。
計画してから進める。
テストしてから実装する。
原因を調べてから直す。
レビューしてから完了する。
証拠を確認してから「終わった」と言う。

この当たり前をAIにも守らせたいなら、Superpowersは最初に試す価値があります。