Superpowersへようこそ
AIコーディングエージェントを、ただ速く動かすだけでなく、規律をもって動かすための実践的なガイドです。
Superpowersとは何か？
Superpowersは「スキル」のコレクションです。スキルとは、構造化された行動ルールのことで、AIコーディングエージェント（Claude Code、Cursor、Gemini CLIなど）にインストールします。インストールすると、AIアシスタントはすぐにコードを書き始める熱心なインターンのような振る舞いをやめ、行動する前に考えるシニアエンジニアのように振る舞うようになります。
簡単に言えば、SuperpowersはAIにコーディング前に確認する、事前に計画する、そして完了を宣言する前に結果を検証することを教えます。
AIを賢くするわけではありません。AIをより規律正しくします。
これは、現場に到着するとすぐに釘を打ち始める業者と、まず現場を歩き回り、設計図について確認し、壁の中の配管を確認してから体系的に建設を始める業者の違いに似ています。どちらの業者も建築の技術を知っています。しかし、高価な失敗を引き起こさないのは後者だけです。
解決する問題
AIコーディングツールを試したことがあるほとんどの人が、このサイクルを経験したことがあるでしょう：
Superpowersなし
| あなたが言うこと | AIがすること |
|---|---|
| 「ログイン機能を追加して」 | 即座に8ファイルにわたって400行のコードを書く |
| 「動いてる？」 | 「はい！完全なログインシステムを実装しました。」 |
| 「テストを実行した」 | 3つのテストが失敗、2ファイルのimportが欠けている |
| 「テストを修正して」 | コードベースの半分を書き直して2つの新しいバグを導入 |
| 「今は完成した？」 | 「はい！すべて良好に見えます。」 |
| 現実 | 何も動かない。1時間を無駄にした。 |
AIは嘘をついていたわけではありません。本当に完成したと信じていました。しかし、テストを実行することも、検証することもしませんでした。あなたが聞きたいことを言っただけでした。
Superpowersあり
| あなたが言うこと | AIがすること |
|---|---|
| 「ログイン機能を追加して」 | 要件について3つの明確化の質問をする |
| あなたが回答する | トレードオフを含む2つの異なるアプローチを提案する |
| あなたが選ぶ | 承認のための詳細な計画を作成する |
| あなたが承認する | ステップごとに実装し、各ステップ後にテストを実行 |
| 「完成した？」 | 完全なテストスイートを実行し、実際の出力を表示してから完了と言う |
| 現実 | 動いている。テストがある。計画が文書化されている。 |
違いは能力ではありません。ワークフローの規律です。
仕組み（シンプルな説明）
Superpowersは、すべての重要なコーディングタスクに対して7ステップのワークフローを強制します：
ステップ1 — ブレインストーミング
コードが書かれる前に、AIはあなたと問題を探求します。一度に一つの質問をし、複数のアプローチを提示し、設計に対するあなたの承認を待ちます。あなたが言うまでコードは書きません。
ステップ2 — 分離
作業は隔離された環境（git worktree）で行われるため、メインのコードベースは進行中の実験の影響を受けません。別々のサンドボックスのようなものです。
ステップ3 — 計画
AIは詳細なステップバイステップの実装計画を作成します。計画の各タスクは、新入りのエンジニアでも2〜5分で完了できるほど小さいです。計画は実行開始前にレビューされ承認されます。
ステップ4 — 実行
計画からのタスクは、別々の「subagent」プロセスによって一度に一つずつ実行され、明確な引き渡しと状態報告があります。一つのタスクが次のタスクに影響することはありません。
ステップ5 — テスト
テストは本番コードの前に書かれます（Test-Driven Development）。AIは、実際に観察された出力（想定された出力ではなく）でテストが合格しない限り、機能が完成したと主張することはできません。
ステップ6 — レビュー
実装後、2段階のレビューが確認します：(1) 仕様通りに作成されたか？(2) コードの品質は受け入れられるか？これらは別々の懸念事項であり、両方が合格しなければなりません。
ステップ7 — 完了
すべての検証ゲートが通過した後にのみ、AIは作業が完了したと宣言します。その後、統合を支援したり、pull requestを作成したり、タスクを適切にクローズするのを助けたりします。
Superpowersを使っている人たち
Superpowersは開発者コミュニティ全体で広く採用されています：
- GitHubスター86,000以上 — 最も多くスターされているエージェントツールキットの一つ
- フォーク6,800以上 — チームが積極的にカスタマイズしている
- コントリビューター24名 — アクティブなオープンソースコミュニティ
- 6以上のサポートプラットフォーム — Claude Code、Cursor、Gemini CLI、Codex、OpenCodeなどで動作
AIツールの監視に疲れた個人開発者、AI支援開発から一貫した品質を求めるエンジニアリングチーム、そしてAIエージェントと作業する際に予測可能な成果を求めるプロダクトマネージャーに使用されています。
あなたのチームに適しているか？
以下のチェックリストを使用して、Superpowersがあなたの状況に適合するか確認してください：
開発者向け
プロダクトマネージャー・チームリード向け
QAエンジニア向け
いずれかのセクションで3項目以上チェックした場合、Superpowersはあなたのために作られています。
はじめに — 次に読む場所
役割によって、このガイドの異なる部分が役立ちます：
| 役割 | 推奨パス |
|---|---|
| 開発者 | はじめにから始めて → ブレインストーミング → 計画の作成 → 全章 |
| プロダクトマネージャー | 要件が計画になる方法を理解するためにブレインストーミングと計画の作成を読む |
| QAエンジニア | 検証とテストモデルについてTDDと実行とSubagentに進む |
| チームリード・アーキテクト | 全章を読む — Superpowersは開発者ツールだけでなく、チーム全体の規律です |
要約： Superpowersはあなたの判断を置き換えるものではありません。AIが適切な瞬間にあなたの判断を求め、決定を文書化し、何かが完成したと言う前に作業を証明することを確実にします。