brainstorming

アイデアをデザインにまとめる

概要

自然で協調的な対話を通じて、アイデアを完成度の高いデザインと仕様にまとめます。

まず、現在のプロジェクトのコンテキストを把握し、アイデアを練り上げるための質問を一度に1つずつ行います。作りたいものを理解したら、デザインを200～300語の小さなセクションに分けて提示し、各セクションの後に、ここまでの内容に問題がないか確認します。

プロセス

アイデアを理解する：

• まず、現在のプロジェクトの状態（ファイル、ドキュメント、最近のコミット）を確認します
• アイデアを練り上げるための質問を一度に1つずつ行います
• 可能な場合は選択式の質問を優先しますが、自由回答形式でもかまいません
• 1回のメッセージにつき質問は1つだけにします。さらに掘り下げる必要がある場合は、複数の質問に分けます
• 目的、制約、成功基準の理解に重点を置きます

アプローチを検討する：

• トレードオフを含めて、2～3種類のアプローチを提案します
• 推奨案とその理由を添え、会話形式で選択肢を提示します
• 推奨する選択肢を最初に示し、その理由を説明します

デザインを提示する：

• 作りたいものを理解できたと判断したら、デザインを提示します
• 200～300語のセクションに分けます
• 各セクションの後に、ここまでの内容に問題がないか確認します
• アーキテクチャ、コンポーネント、データフロー、エラー処理、テストを取り上げます
• 内容がわかりにくい場合は、いつでも立ち戻って確認します

デザインの完成後

ドキュメント作成：

• 検証済みのデザインを docs/plans/YYYY-MM-DD-<topic>-design.md に書き込みます
• デザインドキュメントを Git にコミットします

実装（続ける場合）：

• 「実装の準備を始めますか？」と尋ねます
• using-git-worktrees スキルを使って、分離されたワークスペースを作成します
• writing-plans skill を使って、詳細な実装計画を作成します

主要な原則

• 質問は一度に1つ - 複数の質問で相手を圧倒しないようにします
• 選択式を優先 - 可能な場合は、自由回答よりも答えやすい選択式にします
• YAGNIを徹底 - すべてのデザインから不要な機能を取り除きます
• 代替案を検討 - 選択を決める前に、必ず2～3種類のアプローチを提案します
• 段階的に検証 - デザインをセクションごとに提示し、それぞれを検証します
• 柔軟に対応 - 内容がわかりにくい場合は、立ち戻って確認します