【実践Tutorial】AIエージェントに「規律」を注入！Superpowersの導入手順からTDD自律開発まで徹底解説

監修：VNEXT エンジニアチーム

【クイック解説】Superpowersとは？（概要と本質）

「AIエージェントに指示を出したら、いきなりコードを書き始めてエラーが出まくった」「テストを書いてくれない」「Gitのブランチがコンフリクトだらけになった」といった経験はありませんか？
本記事では、著名インフラ開発者であるJesse Vincent氏が主導し、GitHubで驚異的な注目（221,000スター以上）を集める開発フレームワーク「Superpowers」を使い、AIエージェントを規律ある最強のシニアエンジニアに変貌させる具体的な手順をチュートリアル形式で徹底解説します。

AIエージェント開発における「5つの暴走」を解決する

AIにそのまま指示（プロンプト）を投げるだけのアドホックな開発スタイルでは、以下のような致命的な課題が頻発します。

• 仕様確認のスキップ：要件を深掘りせず推測で書き始め、実装後に大規模な手戻りが発生。
• テストの形骸化：テストを書かない、もしくは実装後に形だけの無意味なテストを配置。
• 同一ブランチでの作業：複数の並行タスクを1つのブランチで直接変更し、コンフリクトが多発。
• エラーコードのコミット：自己検証を行わず、ビルドエラーのあるままリポジトリへ送信。
• 長時間の迷走：実行から5〜10分経過すると、当初の計画設計から大きく逸脱（ハルシネーション）。

Superpowersは、AIエージェント自身に「ソフトウェア工学的プロセス（ブレインストーミング ➔ 計画 ➔ TDD ➔ レビュー ➔ 統合）」という規律をインストールし、すべてのステップを自律かつ自動で統制します。

【チュートリアル】Superpowersのインストールと導入手順

お使いのAI環境に応じて、以下のいずれかの手順でSuperpowersをインストールしてください。

｜1. Claude Code（推奨・最速）

Claude Codeでのセットアップは非常にシンプルです。公式プラグインマーケットプレイス、または独自のマーケットプレイスを登録してインストールします。

｜2. Cursor

Cursor Agentのチャット（Composer等）の中で、直接以下のコマンドを入力して実行、またはプラグイン一覧から検索します。

｜3. OpenAI Codex (CLI)

Codexを使用している場合は、以下のコマンドをエージェントに入力して指示を直接読み込ませます。

｜4. Gemini CLI

Gemini CLIの拡張機能管理を介して、リポジトリから直接インストールを実行します。

【動作検証】Superpowersが有効化されているかのチェック方法

インストール後、新しいセッションを開始してエージェントへ以下のいずれかのフレーズを投げてみてください。

【合格サイン】: もし、エージェントがすぐにコードファイルを生成せず、要件を確認するためのヒアリング（ブレインストーミング）や対話を自発的に提案してきたら、Superpowersのスキル群が正しく機能しています。

【実践シナリオ】Todoアプリ開発でみる、Superpowersの7ステップ制御

実際にReactでのシンプルな「Todoアプリ」開発をAIに指示した際の、Superpowersの7段階の動作制御とユーザーの挙動を追ってみましょう。

Step 1：Brainstorming（対話型要件定義）

指示を受けると、自動的に「brainstorming」スキルが起動します。エージェントはすぐにファイルを作成せず、ソクラテス式の質問で要件の輪郭を決定します。

Step 2：Git Worktree（作業の完全隔離）

要件定義が合意されると、エージェントは自動で git worktree add を走らせ、隔離された作業領域と独立した開発ブランチを作成します。他のタスクや現在のメインリポジトリに干渉せず、安全にプロジェクトのセットアップとテスト環境の初期動作（ベースライン検証）を行います。

Step 3：Writing Plans（超詳細なタスク設計図の構築）

エージェントは仕様書をもとに、1つのタスクが「2〜5分程度で終わる粒度」に細分化した計画書（Plan）を自動記述します。
計画書は非常に厳密に書かれ、変更するファイルパス、書き換えるコード範囲、そのタスクをどうやってテストで確認するかが網羅されます。

Step 4：Subagent-Driven Development（子エージェントへの分散）

計画された各タスクは、それまでの無駄なチャットの履歴をすべて排除した「完全にクリーンなコンテキスト」を持つ個別の子エージェント（Subagent）にディスパッチされます。トークンの浪費を防ぐとともに、AI特有の「コンテキストの肥大化による迷走」をここで未然に防ぎます。タスクが終わると、次の「仕様を満たしているか」「コードは清潔か」の2段階の自動レビューをパスさせます。

Step 5：Test-Driven Development（テスト駆動開発の強制）

Superpowersでは、TDD（RED-GREEN-REFACTOR）が物理的に強制されます。

「テストよりも先に記述されたコード」は、システムが自動的に全消去する仕組みになっています。これにより、すべてのロジックが確実にテストコードによって保護されます。

Step 6：Code Review（継続レビュー）

タスクが完了するたびに、元の計画書と実装にズレがないかをエージェント自身が照合します。修正項目は深刻度に応じて分類され、重大な問題（Critical）がある場合は修正が完了するまで次のタスクに進むことがブロックされます。

Step 7：Finishing Branch（クリーンアップとマージ）

全テストが通過（ALL GREEN）した段階で、エージェントはユーザーに対し「メインブランチへのマージ」「GitHubでのプルリクエスト作成」「ブランチ保持」の最終決断を仰ぎ、クリーンアップをして安全に作業環境を閉じます。

【応用テクニック】Superpowersの限界を押し広げる活用法

｜1. 独自の開発スキルを自己開発させる（writing-skills）

メタスキルである writing-skills を使えば、「新しい開発プロセス自体をAIに作らせる」ことが可能です。例えば、「弊社のDBマイグレーション規約に則ってSQLを実行するプロセス（SKILL.md）を自ら作成し、テストして永続化せよ」と指示すれば、エージェント自らが専用のスキルセットを生成・追加します。

｜2. 書籍やドキュメントからナレッジを吸い上げてプロセス化する

信頼性の高い技術書やPDFドキュメントを読み込ませ、「この内容を読み解き、実務で繰り返し守るべきスキルセット（SKILL.md）としてエクスポートせよ」と指示します。チーム内の過去の障害顛末書（ポストモーテム）を読ませれば、「二度と同じバグを再発させない自律レビュー・チェックリスト」へと瞬時に昇華させることができます。

｜3. エージェントがプロセスを守らない・忘れた時の対処法

時折、エージェントがスキル実行を忘れ、直接コードをゴリゴリ書き始めようとすることがあります。その際は、チャット画面で優しく以下のいずれかのコマンドを投げて修正してください。
・「Use your brainstorming skill.（ブレインストーミングをして）」
・「Check if you have a skill for this.（この作業に対応するスキルを持っていないか確認して）」
・「Don't skip the planning step.（計画書作成をスキップしないで）」

ビジネスとしての本質：企業の開発における「AIの限界」と「VNEXTの高品質ラボ型体制」

企業のビジネス競争力を支える実際のシステム開発においては、以下の3点が大きなボトルネックとなります。

• 戦略的な全体設計（グランドデザイン）の欠如：複数の既存システム群や複雑なクラウドインフラ（AWSやAzureなど）を統合的に、中長期のビジネススケールに耐える形で最適配置する判断は、AIには下せません。
• 曖昧な業務課題の上流要件への翻訳：「業務効率を上げたい」「新規システムを起ち上げたい」という、社内の曖昧なニーズからAIが実行可能な詳細設計プランへとブレイクダウンするには、高度なビジネス理解を持ったPMやコンサルタントの力が不可欠です。
• セキュリティ・著作権等の社会的品質保証（コミットメント）：生成AIが偶然混入させたライセンスの問題やセキュリティの潜在的脆弱性に対し、瑕疵担保責任を持って社会的・法的に品質を100%保証することは、AIには行えません。

｜最先端AIの推進力と「VNEXTのAIラボ型オフショア開発」を融合させる

これまで幅広い業界において800件以上のシステム開発実績を誇るVNEXTは、この「最先端AIエージェントの爆発的生産性」と「人間のプロフェッショナルな品質保証力」を完全に統合した**「AIラボ型オフショア開発」**を日本企業向けに提供しています。

1. 開発コストを約40%〜70%劇的に削減
   システム開発コストの7割以上を占める「エンジニアの人件費・採用コスト」を抑え、VNEXTの高度な専門チームを専属ラボ型で活用することで、日本国内での開発と比べて通常50%から70%（AIラボ型においては約40%）の大幅なコストカットを実現します。
2. 仕様変更に強い柔軟なアジャイル開発（最短1週間でアサイン）
   要件や仕様が完全には決まりきっていない初期段階でも、仕様変更が予想されるアジャイルプロジェクトでも、最短1週間でチームを構築し、開発しながらシステム詳細を詰めていくことができます。契約期間内であれば追加費用の発生なく柔軟に開発を推進可能です。
3. 優秀な日本語BrSE（ブリッジSE）による安心の品質ガバナンス
   コミュニケーションや「言わなくてもニュアンスでわかるはず」という認識の不一致を完全に解消するため、経験豊富なバイリンガルのブリッジSE（BrSE）がチーム全体を統制。最先端のAI自動化を制御しつつ、人間による二重三重のコードレビューと、日本品質のセキュリティレベルを徹底的に保証します。

まとめ：AIの爆発的スピードと人間の強固な品質ガバナンス of 融合

AI技術の急速な進化を開発現場のパフォーマンスへ変換する最大の秘訣は、「ツールを単に便利に使うこと」ではなく、「プロセス（規律）によるガバナンスを効かせること」に他なりません。Superpowersは、AI自身に品質を守らせ、エラーのないコードを約束させるための、ローカルで試せる最適なチュートリアルフレームワークです。

しかし、それをビジネス用途のプロダクト全体に適用し、システムレベルでの全体最適化や最終的なセキュリティ・安全性を担保するのは、人間の信頼できる開発ガバナンスチームです。

社内でのAI開発プロセスの構築、エージェントツールの効果的な活用に悩んでいるCTO・ITリーダーの皆様、あるいは圧倒的な開発速度と安心の日本品質、抜群のコストパフォーマンスを兼ね備えた専属開発チームをお求めのIT意思決定者様は、VNEXT JAPAN株式会社までお気軽にご相談ください。