Claude Codeは標準でも強力ですが、構造がないと計画もテストも体系的なアプローチもなく、すぐにコーディングに飛び込んでしまいます。Superpowersプラグインは、混乱を防ぐ実証済みの開発ワークフローを強制することで、この問題を解決します。
Superpowersが実際に行うこと
Superpowersは、重要な瞬間にClaude Codeを介入するスキルフレームワークです。何かを依頼したときにすぐにコードを書く代わりに、まず停止して質問をします。その後、TDDを強制し、実装計画を作成し、次に進む前に自身の作業をレビューします。
コアワークフロー:
- ブレインストーミング:ソクラテス式の質問を通じてアイデアを洗練
- 計画:正確なファイルパスを含む小さなタスク(各2〜5分)を作成
- 実行:2段階レビューを伴うタスクごとのサブエージェント派遣
- 完了:テストを検証し、PR/マージオプションを提供し、クリーンアップ
インストール(10秒)
bash
プラグインメニューを開く
/plugin
「Discover」タブに移動
「superpowers」を検索
選択してインストール
インストール後、Claude Codeを再起動します。「SessionStart:startup hook succeeded: Success」と表示され、プラグインがアクティブであることが確認できます。
インストールされるもの
プラグインには必要なものがすべて含まれています:
| コンポーネント | 含まれるもの |
|---|---|
| コマンド | execute-plan、write-plan、brainstorm |
| エージェント | code-reviewer |
| スキル | TDD、デバッグ、gitワークツリー、コードレビューを含む14のスキル |
| フック | SessionStart(ワークフローを自動ブートストラップ) |
3つのコアコマンド
/superpowers:brainstorm
新機能の前に必ず使用してください。Claudeは以下を行います:
- 目標について明確化する質問をする
- 考慮していなかった代替案を探る
- 検証のために設計を理解しやすい塊で提示
- 参照用の設計ドキュメントを保存
**トリガーするタイミング:**任意の機能、リファクタリング、または移行の開始時。
/superpowers:write-plan
ブレインストーミング後、以下のような実装計画を作成します:
- 各タスクは最大2〜5分
- すべてのタスクに正確なファイルパスと完全なコードスニペット
- 各タスクに検証ステップが組み込まれている
- 計画は「コンテキストのない熱心なジュニアエンジニア」が実行することを想定
/superpowers:execute-plan
サブエージェント駆動開発を使用して計画を実行:
- タスクごとに新しいサブエージェントを生成(クリーンなコンテキスト)
- 2段階レビュー:仕様準拠、次にコード品質
- バッチ間の人間によるチェックポイント
- 重大な問題は自動的に進行をブロック
14のスキルの説明
| スキル | 機能 |
|---|---|
| test-driven-development | RED-GREEN-REFACTORを強制。テスト前に書かれたコードを削除。 |
| systematic-debugging | 多層防御を伴う4段階の根本原因プロセス |
| using-git-worktrees | 分離されたブランチを作成し、セットアップを実行し、クリーンなベースラインを検証 |
| using-superpowers | スキルシステムの紹介 |
| dispatching-parallel-agents | 並行サブエージェントワークフロー |
| executing-plans | チェックポイント付きバッチ実行 |
| finishing-a-development-branch | マージ/PR/保持/破棄オプション、クリーンアップ |
| brainstorming | ソクラテス式の設計洗練 |
| writing-plans | 詳細な実装計画 |
| requesting-code-review | レビュー前チェックリスト、重大な問題でブロック |
| receiving-code-review | フィードバックへの体系的な対応 |
| writing-skills | 新しいスキルを作成するためのメタスキル |
| verification-before-completion | 修正が実際に機能することを保証 |
| subagent-driven-development | タスクごとの2段階レビュー |
スキルが自動的にトリガーされる仕組み
スキルは呼び出すコマンドではなく、コンテキストに基づいて起動します:
- 新機能の議論を開始 → brainstormingが起動
- 設計が承認 → using-git-worktreesが起動
- 実装開始 → test-driven-developmentが起動
- タスク完了 → requesting-code-reviewが起動
- すべてのタスク完了 → finishing-a-development-branchが起動
Claudeは各タスクの前に関連するスキルをチェックします。これらは提案ではなく、必須のワークフローです。
gitワークツリー統合
Superpowersは分離された開発のためにgitワークツリーを使用します: bash
裏で起こること:
git worktree add ../project-feature feature-branch cd ../project-feature
Claudeはここで作業し、mainブランチはクリーンなまま
メリット:
- 異なる機能で複数のClaudeインスタンスを実行
- 実験中もmainブランチを安定に保つ
- 問題が発生した場合の簡単なクリーンアップ
サブエージェント駆動開発
最も強力なパターンです。1つの長いClaudeセッションの代わりに:
- メインエージェントが計画を作成
- 新しいサブエージェントが各タスクを実行
- レビューエージェント(code-reviewer)が作業をチェック
- メインエージェントが続行または修正を要求
これが機能する理由:各サブエージェントは1つのタスクに集中したクリーンなコンテキストで開始します。長いセッションからの蓄積された混乱がありません。
TDD強制
SuperpowersはTDDを真剣に扱います。このスキルは:
- 実装前に失敗するテストを要求
- テストが失敗するのを確認(何かをテストしていることを証明)
- 合格するための最小限のコードを実装
- グリーンでコミット
- グリーン後にのみリファクタリング
Claudeがテスト前にコードを書いた場合、スキルはそのコードを削除してやり直すよう指示します。
実践例
あなた:Expressアプリにユーザー認証が必要です
Claude(Superpowers使用時): → brainstormingスキルを起動 → 質問:OAuthかパスワード?セッションかJWT?どのプロバイダー? → 探索:レート制限?アカウントロックアウト?パスワード要件? → 承認のためにセクションごとに設計を提示
あなた:良さそうです、計画しましょう
Claude: → writing-plansスキルを起動 → 各2〜5分の12タスクを作成 → タスク1:/signupエンドポイントの失敗するテストを作成 → タスク2:テストに合格するsignupハンドラーを実装 → 各タスクに正確なファイルパスとコード
あなた:実行
Claude: → タスク1のサブエージェントを生成 → code-reviewerエージェントが出力を検証 → タスク2のサブエージェントを生成 → 進捗を報告し、続行の承認を求める
プラグインの管理
/pluginメニューから以下が可能です:
- プラグインを無効化:一時的にオフにする
- 更新をマーク:次の更新サイクルのためにフラグを立てる
- 今すぐ更新:最新バージョンをすぐに取得
- アンインストール:完全に削除
- GitHubで表示:ソースコードを見る
Superpowersを使用すべきでない場合
- 簡単な一度限りの質問
- シンプルなファイル編集
- 5分未満のタスク
これらの場合、オーバーヘッドは見合いません。Superpowersは、体系的な実行を必要とする複数ファイルの機能、リファクタリング、移行で真価を発揮します。
クイックリファレンス
| アクション | 方法 |
|---|---|
| インストール | /plugin → Discover → superpowers |
| 設計開始 | /superpowers:brainstorm |
| 計画作成 | /superpowers:write-plan |
| 計画実行 | /superpowers:execute-plan |
| 更新 | /plugin → superpowersを選択 → 今すぐ更新 |
Superpowersは、Claude Codeを「時々脱線する便利なアシスタント」から「実証済みのプロセスに従う体系的な開発パートナー」へと変革します。構造化されたワークフローは、最も一般的な失敗モードを防ぎます:スキップされたテスト、見逃されたエッジケース、要件から逸脱した機能。
