ブレインストーム

概要

このスキルを使用して、構造化された対話を通じて、粗いアイデアを明確でレビュー可能な設計アウトプットに変換します。

目標は以下の通りです:

1. 要件と制約を明確にする
2. トレードオフを伴う代替案を探索する
3. 具体的で検証済みの設計ブリーフを成果物またはプランニングへの引き継ぎとして作成する

ワークフロー

ステップ 1: プロジェクトコンテキストを収集する

共有コンテキスト読み込みプロトコルに従ってプロジェクトコンテキストを読み込みます。また、アイデアに関連する主要な実装ファイルを確認し、既存のアーキテクチャ、依存関係、規約からの制約を記録します。

このステップは焦点を絞ります。現在のアイデアに必要なもののみを収集してください。

ステップ 2: 要件を明確にする

曖昧さを除去するために、順序立てたターゲット質問を投げかけます。Question Tool の要件に従います。

• 以下に焦点を当てます:
  • 目的とユーザー価値
  • スコープの境界
  • 制約 (技術、UX、パフォーマンス、期間)
  • 成功基準
  • 非目標

実装の詳細には早すぎる段階で飛び込まないでください。

ステップ 3: アプローチを探索する

2～5 つの実行可能なアプローチを提案します。

各アプローチに対して以下を含めます:

• 簡潔な概要
• 利点
• 欠点/リスク
• 複雑さの推定
• 推奨される使用条件

推奨オプションから始め、それがプロジェクトコンテキストと制約にどのように適合しているかを説明します。

すべてのアプローチを提示した後、Question Tool を使用してユーザーが好むアプローチを選択させます。概要オプションをリストアップします。例:

1. アプローチ A、簡潔な概要
2. アプローチ B、簡潔な概要
3. アプローチ C、簡潔な概要
4. その他 (具体的に指定してください)

推奨アプローチにタグを追加して、ユーザーを導きます。

ステップ 4: 設計を段階的に提示する

要件が明確になったら、ユーザーを圧倒しないよう、論理的なフェーズで段階的に設計を提示します (フェーズあたり約 200～300 単語)。

• フェーズ 1: 基礎 - 問題フレーミング、目標、提案されたアーキテクチャ/フロー。
• フェーズ 2: 技術詳細 - データモデル、インターフェース、エラーハンドリング、エッジケース。
• フェーズ 3: 納品 - テスト/検証戦略とロールアウトの考慮事項 (該当する場合)。

各フェーズ を提示した後、Question Tool を直ちに使用して以下を質問します:

1. 次のフェーズに進む
2. 現在のフェーズを調整する
3. 前のフェーズを再検討する

ステップ 5: ループを閉じる

あなたとユーザーが要件を検討し、設計が検証されたら、次のアクションを決定します。

1. Question Tool を使用して、ユーザーに 3 つの高レベルな次のアクションを提示します:

   • "プランを直ちに書く (現在のコンテキストで)" - 成果物ステップをスキップして、write-plan への引き継ぎに直接進みます。
   • "成果物を書く" - ステップ 6 で説明するブレインストーム文書を作成することで続行します。
   • "セッション終了 (ユーザーに十分な情報を既に提供)" - 停止; 対話は現時点で十分な洞察を生み出しています。

2. ユーザーが 成果物を書く を選択した場合、ステップ 6 に進みます。ドラフト成果物が存在したら、Question Tool を再度使用して以下のオプションで検証します:

   • "現在の成果物とコンテキストでプランを書く"
   • "セッション終了 - 成果物は現在のところ十分です"
   • "変更が必要" (自由形式のテキスト) - フィードバックを収集し、成果物を修正して、再度質問します。

3. ユーザーが プランを直ちに書く を選択した場合、現在のブレインストーミングコンテキストを使用してスキル write-plan を使用する引き継ぎを開始します; 追加の成果物検証は不要です。

4. ユーザーが セッション終了 を選択した場合、単に停止してください。これまで収集された情報は十分と見なされます。

ステップ 6 (オプション): ブレインストーム成果物を書く

ステップ 5 でユーザーが明示的に "成果物を書く" を選択した後にのみ、このステップを実行します。

結果を標準化された場所に保存します:

• ディレクトリ: docs/brainstorms/YYMMDD-HHmm-<topic-slug>/
• メインファイル (必須): docs/brainstorms/YYMMDD-HHmm-<topic-slug>/SUMMARY.md
• オプションのサポートファイル:
  • docs/brainstorms/YYMMDD-HHmm-<topic-slug>/section-01-<slug>.md
  • docs/brainstorms/YYMMDD-HHmm-<topic-slug>/section-02-<slug>.md
  • など

SUMMARY.md フォーマット: references/summary-template.md 内のテンプレートに厳密に従います。

ルール

• このスキルでブレインストームセッション中に本番コードを書いたり、実装の変更を加えたりしないでください。
• やり取りを軽量で反復的に保ちます; すべてのステップは同じセッション内で実行すべきです。
• 不確かな場合は、完全性よりも明確性を優先します; フォローアップ質問をしてください。
• すべての推奨事項をプロジェクトドキュメントと標準に合わせます。
• 仮定を明示的に保ちます; 沈黙のうちに推測しないでください。
• コーディングの前に考える: 仮定を明示的に表面化させます。複数の解釈が存在する場合は、それらを提示してください — 沈黙のうちに選択しないでください。より単純なアプローチが存在する場合は、それを言及して、必要に応じてプッシュバックしてください。