Superpowers の Brainstorming スキルで設計品質を上げる

Superpowers の Brainstorming スキルで設計品質を上げる

Superpowers プラグインの brainstorming スキルは、実装前に要件と設計を徹底的に検討するための構造化プロセスを提供します。これにより、「作ってからやり直し」を防ぎ、高品質な設計を実現できます。

Brainstorming の基本原則

Superpowers の brainstorming スキルには強固なガードがあります。

• HARD-GATE: 設計が提示され承認されるまで、実装は一切禁止
• 1問ずつ確認: 一度に1つの質問で、多肢選択を推奨
• スコープ評価: 大規模プロジェクトはサブプロジェクトに分解

9ステップのチェックリスト

brainstorming スキルは以下の9ステップを TodoWrite で追跡します。

1. プロジェクトコンテキストの理解
2. ユーザーの意図の探索
3. 要件の明確化
4. 制約の特定
5. 2-3つのアプローチの提案
6. デザインのセクション別提示
7. スペック文書の作成
8. スペックの自己レビュー
9. ユーザー承認の取得

スペック文書の出力

スペックは docs/superpowers/specs/ に保存されます。

docs/superpowers/specs/2026-04-02-auth-system-design.md

自己レビューでは以下をチェックします。

• プレースホルダーの有無（TBD、TODO は不可）
• 一貫性
• スコープの妥当性
• 曖昧さの有無

ビジュアルコンパニオン

brainstorming には、ブラウザベースのビジュアルコンパニーンがオプションで利用できます。モックアップ、図、選択肢をブラウザで表示でき、テキストはターミナルでやり取りする棲み分けが可能です。

実践的な使い方

> ユーザー認証システムを実装したい。メール/パスワードとOAuthの両方に対応させる。

Superpowers は自動的に brainstorming スキルを検出し、以下のように進めます。

1. まず質問: 「認証プロバイダーは何をサポートしますか？」（選択肢: Google, GitHub, Apple 等）
2. 次の質問: 「セッション管理方法は？」（JWT, セッションベース, ハイブリッド）
3. アプローチの提案: 2-3つの実装アプローチを提示
4. スペックの作成: 承認された設計を文書化

次のフェーズへの移行

brainstorming が完了すると、自動的に writing-plans スキルに移行します。設計から実装計画へのスムーズな移行が可能です。

アンチパターンへの対策

Superpowers は「これはシンプルすぎて設計が必要ない」という合理化パターンを12種類検出します。どんなにシンプルな機能でも、brainstorming スキップは推奨されません。

Superpowers のインストール

/plugin install superpowers@claude-plugins-official

インストール後、SessionStart フックが自動的にコンテキストを注入するため、特別な設定なしで利用開始できます。

---

あわせて読む

• Superpowers のサブエージェント駆動開発パイプライン - brainstorming から実装までの全工程
• TDD ワークフローを Claude Code で実践する - 実装フェーズでのテスト駆動開発