コーディングエージェントに「模範的な開発フロー」を強制する OSS「Superpowers」

Claude Codeをはじめとするコーディングエージェント向けに、模範的な開発手法を強制してくれるオープンソースの「アウターハーネス」がSuperpowersです。導入はプラグインコマンド1つで完了し、複雑な設定ファイルも不要です。

背景・課題

コーディングエージェントを日常的に使っていると、次のような経験に心当たりがある方も多いのではないでしょうか。

• 要件を詰めきる前にエージェントがいきなりコードを書き始め、大きな手戻りが発生する
• プランモードを試したものの使いこなせず、結局使わなくなった
• プランモードの出力を十分にレビューしないまま承認してしまい、練り込まれていない計画のまま実装が進んでしまう
• テストコードを伴わないコードが量産され、あとで収拾がつかなくなる

これらは必ずしもモデルの性能不足が原因ではなく、エージェントを取り巻く「ハーネス」が不足していることが一因かもしれません。

ハーネスとは何か

「ハーネス」という言葉自体は最近よく聞かれますが、改めて定義すると、エージェント（Agent）はモデル（Model）とハーネス（Harness）の組み合わせで構成されるという捉え方が分かりやすくなります。式にすると次の通りです。

Agent = Model + Harness

つまりハーネスとは、エージェントからモデルを取り除いた残りすべてを指します。

モデル単体は、入力に対して出力を返すだけの存在です。「今日の天気は？」と聞かれても学習データにない情報には答えられず、当たり障りのない一般論を返すだけになりがちでした。これを解消するために構造化出力が生まれ、モデルは「get_weatherツールを使いたい」というアウトプットを返せるようになりました。しかし、それだけではまだ「プロとして仕事を完成させる」エージェントとは呼べません。モデルとエージェントの間にあるこのギャップを埋めるのが、ハーネスの役割です。

ハーネスにはさらに2種類あります。

• ビルダーハーネス：Claude Code、GitHub Copilot Agent／CLI、Codexなどのコーディングエージェントに標準搭載されているハーネス。ツールコールの解釈・実行、コンテキストが上限に近づいた際のコンパクション、ユーザーの好みをメモリーに保存する機能、サブエージェントの起動などが該当します。
• アウターハーネス：ビルダーハーネスが提供しない部分を、ユーザー側が拡張するものです。CLAUDE.mdにプロジェクトのルールを書く、Gitフックでリントを強制する、特定の振る舞いをスキルとして追加するといった工夫は、すべてアウターハーネスの一種と言えます。

今回紹介するSuperpowersも、このアウターハーネスに分類されます。

Superpowersとは

Superpowersは、コーディングエージェント向けのアウターハーネスの中でもひときわ大きな支持を集めているOSSです。開発しているのはJesse Vincent氏らPrime Radiantのチームで、MITライセンスで公開されています。GitHubのスター数は執筆時点（2026年7月）で20万を超えており、なお増加が続いているようです（急成長中のため最新値はリポジトリで確認することをおすすめします）。

名前だけ聞くと派手な印象を受けますが、実際にやっていることは模範的な開発手法をエージェントに強制するだけ、というシンプルな設計思想です。ベクトルデータベースやナレッジグラフのような技術は使わず、次のような開発フローを一貫して踏ませます。

1. ブレインストーミング：専用スキルが対話形式で要件を徹底的に詰める
2. ワークツリーの分離：作業環境をGit worktreeで隔離する
3. プランファイルの作成とレビュー：計画をファイルに書き起こし、セルフレビューと人間によるレビューを経て承認を得る
4. TDD実装：承認後はサブエージェント駆動で実装が進む。タスクごとにコンテキストが分離されるため、大きな開発でもコンテキストが肥大化しにくい
5. コードレビュー：実装完了後にレビューを行い、完了とする

Claude Code、Codex、Cursor、GitHub Copilot CLIなど複数のコーディングエージェントに対応していますが、公式には各ハーネスごとに個別インストールが必要と案内されています。

導入方法

Superpowersはそのほとんどがスキルのみで構成されており、セッション開始時にSuperpowersの使い方をコンテキストへ注入するフックが1つあるだけです。複雑な設定ファイルや外部ツールへの依存がないため、環境を問わず動作し、トラブルが起きにくい点も支持されている理由のひとつと言えそうです。

Claude Codeの場合、Anthropic公式のプラグインマーケットプレイスから、次の1コマンドでインストールできます。

/plugin install superpowers@claude-plugins-official

インストール後は、スキルが自動的に発動する設計になっているため、特別なコマンドを覚える必要はありません。実装したい内容をエージェントに伝えるだけで、ブレインストーミングのスキルが自動的に立ち上がり、要件を詰める対話が始まります。

チームでの活用に向けて

個人での利用では、要件が固まった段階でスムーズに実装フェーズへ進めるため、大きな手戻りを感じにくいという声があります。一方で、チームで導入する場合には検討すべき論点もあります。

• プランファイルの内容をレビュー前に共有してもらえると、レビューの手戻りを減らせる可能性がある
• チームでツールの使用を一律ルール化すると、後からより良いツールが登場した際に柔軟に乗り換えにくくなるというトレードオフもある

「メリットしかない」と決めつけず、チーム内でのレビュー運用も含めて設計すると、より効果を引き出しやすくなりそうです。

まとめ

ハーネスエンジニアリングに時間を割く余裕がない方でも、Superpowersなら手軽に模範的な開発フローを取り入れられます。気になる方はぜひ試してみてください。