brainstorming について
複雑、不明確、または変更を伴う依頼に対応するエージェント向けの、コミュニケーションとブレインストーミングのスキルです。実装前の範囲確認に加え、進捗報告やエラー対応の指針を示します。
主な機能
- 01実装前の要件確認
- 02過去の決定事項の確認
- 03判断に結び付く質問の作成
- 04進捗状況の報告
- 05構造化されたエラー説明
活用シーン
- 01新機能の要件を明確化
- 02変更依頼の範囲を確認
- 03作業中の進捗を報告
- 04問題を説明して選択肢を提示
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/brainstormingを入力して読み込まれたか確認します。
同梱ファイルdynamic-questioning.md
詳細
ブレインストーミングとコミュニケーションのプロトコル
必須： 複雑な依頼や曖昧な依頼、新機能、更新に使用してください。
🛑 ソクラテス式ゲート（徹底）
発動するタイミング
| パターン | アクション |
|---|---|
| 詳細を伴わない「構築／作成／制作 [対象]」 | 🛑 3つ質問する |
| 複雑な機能やアーキテクチャ | 🛑 実装前に明確にする |
| 更新／変更の依頼 | 🛑 対象範囲を確認する |
| 要件が曖昧 | 🛑 目的、ユーザー、制約を尋ねる |
🧠 メモリの確認（2026.5.13 — 質問の前に）
質問する前に、過去のコンテキストがあるか確認してください。
0. CHECK MEMORY — Does .agents/memory/MEMORY.md exist?
→ YES: Read index. Apply relevant past decisions silently.
Skip questions already answered in memory.
→ NO: Proceed with standard Socratic Gate.
🚫 必須：実装前に3つ質問する
- 停止 - コーディングを始めないでください
- 確認 - このトピックに関する過去のコンテキストを
.agents/memory/で確認してください - 質問 - 最低3つ質問してください（メモリですでに回答済みの質問は省略します）。
- 🎯 目的：どのような問題を解決しようとしていますか？
- 👥 ユーザー：誰がこれを使いますか？
- 📦 対象範囲：必須の要件と、あると望ましい要件は何ですか？
- 待機 - 先に進む前に、回答を待ってください
- 保存 - ブレインストーミングの後、重要な決定を保存してください：
/remember [decision]
🧠 動的な質問の生成
⛔ 静的なテンプレートは絶対に使用しないでください。 原則については dynamic-questioning.md を読んでください。
基本原則
| 原則 | 意味 |
|---|---|
| 質問で結果を明らかにする | 各質問をアーキテクチャ上の判断に結び付けます |
| 内容より先にコンテキストを把握する | まず、新規開発／機能追加／リファクタリング／デバッグのどれに当たるかを理解します |
| 必要最小限の質問 | 各質問で、実装の選択肢を絞り込む必要があります |
| 推測ではなく情報を得る | 推測せず、トレードオフを示して質問します |
質問の生成プロセス
1. Parse request → Extract domain, features, scale indicators
2. Identify decision points → Blocking vs. deferable
3. Generate questions → Priority: P0 (blocking) > P1 (high-leverage) > P2 (nice-to-have)
4. Format with trade-offs → What, Why, Options, Default
質問形式（必須）
### [PRIORITY] **[DECISION POINT]**
**Question:** [Clear question]
**Why This Matters:**
- [Architectural consequence]
- [Affects: cost/complexity/timeline/scale]
**Options:**
| Option | Pros | Cons | Best For |
|--------|------|------|----------|
| A | [+] | [-] | [Use case] |
**If Not Specified:** [Default + rationale]
詳細な分野別質問集とアルゴリズムについては、 dynamic-questioning.md を参照してください。
進捗報告（原則に基づく）
原則： 透明性は信頼を築きます。状況は見える形で、次の行動につながるものでなければなりません。
状況ボードの形式
| エージェント | 状況 | 現在のタスク | 進捗 |
|---|---|---|---|
| [Agent Name] | ✅🔄⏳❌⚠️ | [Task description] | [% or count] |
状況アイコン
| アイコン | 意味 | 用途 |
|---|---|---|
| ✅ | 完了 | タスクが正常に完了しました |
| 🔄 | 実行中 | 現在実行中です |
| ⏳ | 待機中 | ブロックされており、依存関係を待っています |
| ❌ | エラー | 失敗しており、対応が必要です |
| ⚠️ | 警告 | 問題の可能性がありますが、処理は停止していません |
エラー処理（原則に基づく）
原則： エラーは明確に伝える機会です。
エラー応答のパターン
1. Acknowledge the error
2. Explain what happened (user-friendly)
3. Offer specific solutions with trade-offs
4. Ask user to choose or provide alternative
エラーのカテゴリー
| カテゴリー | 対応方針 |
|---|---|
| ポートの競合 | 別のポートを提示するか、既存のプロセスを終了します |
| 依存関係の不足 | 自動でインストールするか、許可を求めます |
| ビルドの失敗 | 具体的なエラーと、推奨する修正方法を示します |
| 不明瞭なエラー | スクリーンショットやコンソール出力など、詳細を尋ねます |
完了メッセージ（原則に基づく）
原則： 成功を祝い、次のステップを案内します。
完了時の構成
1. Success confirmation (celebrate briefly)
2. Summary of what was done (concrete)
3. How to verify/test (actionable)
4. Next steps suggestion (proactive)
コミュニケーションの原則
| 原則 | 実践方法 |
|---|---|
| 簡潔 | 不要な詳細を省き、要点を伝えます |
| 視覚的 | すばやく把握できるよう、絵文字（✅🔄⏳❌）を使います |
| 具体的 | 「しばらく待つ」ではなく「約2分」と伝えます |
| 代替案 | 行き詰まった場合は、複数の選択肢を提示します |
| 先回り | 完了後に次のステップを提案します |
避けるべきアンチパターン
| アンチパターン | 理由 |
|---|---|
| 理解する前に解決策に飛びつく | 間違った問題に時間を費やします |
| 質問せずに要件を推測する | 誤った成果物につながります |
| 最初のバージョンを過剰に設計する | 価値を届けるのが遅れます |
| 制約を無視する | 使えない解決策につながります |
| 「思うに」という表現 | 不確かなら、代わりに質問してください |
コメント
Markdown 対応