From design-discussion
Orchestrates design debates with 5-agent team to compare architectures, implementation options, tradeoffs, and generate ADRs. Use for technical decisions like API design, library selection, or multiple approaches.
npx claudepluginhub sean-sunagaku/claude-code-plugin --plugin design-discussionThis skill is limited to using the following tools:
5つの専門エージェント(Solution Architect・Engineer・Product Manager・User Liaison・Devil's Advocate)が
Guides structured design conversations for complex engineering tasks with depth modes (Quick, Standard, Deep), assumption surfacing, and decision matrices.
Facilitates technical design brainstorming through natural dialogue, adapting to user expertise via understanding, exploration, and validation stages. Use for new features or architectures before implementation.
Convene parallel role-specialized agents to debate cross-domain technical decisions like architecture pivots, API surfaces, or codebase audits, producing a decision log.
Share bugs, ideas, or general feedback.
5つの専門エージェント(Solution Architect・Engineer・Product Manager・User Liaison・Devil's Advocate)が 技術的トレードオフを議論・反論し合いながら設計案を比較検討するスキル。 Facilitator(この SKILL.md 自身)がオーケストレーションし、User Liaison がユーザーへの質問を一元管理する。
このスキルは 実装アプローチ・技術設計の比較 に特化している。
| ロール | ファイル | 専門領域 |
|---|---|---|
| Facilitator | この SKILL.md | 議論進行・合意形成・記録 |
| Solution Architect | agents/solution-architect.md | 設計案生成・アーキテクチャ比較・推奨案決定 |
| Engineer | agents/engineer.md | 技術的実現性・コードベース調査・工数評価 |
| Product Manager | agents/product-manager.md | ビジネス価値・スコープ・優先度・制約条件 |
| User Liaison | agents/user-liaison.md | ユーザーへの質問一元管理・AskUserQuestion で直接質問 |
| Devil's Advocate | agents/devils-advocate.md | 合意案への批判・リスク発掘・前提検証 |
Step 1: 課題・要件の明確化
担当: Solution Architect + Product Manager + Engineer
目的: 何を決定する必要があるか、制約条件は何かを明確化
↓
Step 2: 設計案の生成と初期評価
担当: Solution Architect + Engineer + Product Manager
目的: 2-4 の具体的な設計案を生成し、初期スコアリング
↓
Step 3: 深掘り比較・Devil's Advocate
担当: 全員参加(Devil's Advocate が合意を破壊)
目的: 各案の詳細な技術的比較、リスク分析、前提検証
↓
Step 4: 推奨案の決定・アクションプラン
担当: Solution Architect + User Liaison(ユーザー承認)
目的: 最終推奨案を決定し、ADR と実装アクションリストを生成
各ステップの詳細は references/discussion_protocol.md を参照。
壁打ちセッション開始時、以下を実行:
docs/, .claude/ 配下の設計関連 MD を Glob で検索).claude/design_discussion/sessions/<discussion-slug>/ ディレクトリを作成session.json を作成(下記テンプレート)discussion_log.md を作成references/discussion_protocol.md のチームライフサイクル参照){
"sessionId": "<discussion-slug>",
"topic": "<設計テーマ>",
"status": "in_progress",
"mode": "<light|standard|deep>",
"currentStep": 1,
"createdAt": "<ISO8601>",
"updatedAt": "<ISO8601>",
"steps": {
"1_clarification": false,
"2_proposals": false,
"3_comparison": false,
"4_decision": false
},
"proposals": [],
"selectedProposal": null
}
| 発言 | アクション |
|---|---|
| 「壁打ち開始:〇〇の設計」 | 新規セッション作成、Step 1 開始 |
| 「次のステップ」「進めて」 | 現在のステップを完了し次へ |
| 「戻って」「前のステップ」 | 前のステップに戻る |
| 「今どこ?」「進捗は?」 | 現在のステップと完了状況を表示 |
| 「もっと議論して」 | 現在のステップで追加の議論ラウンドを実行 |
| 「悪魔の代弁者を呼んで」 | Devil's Advocate による追加批判セッション |
| 「ADR を出して」 | 現在の議論状態から ADR ドラフトを生成 |
| 「一覧」「セッション一覧」 | 過去のセッション一覧を表示 |
| 「再開:〇〇」 | 指定セッションを再開 |
各ステップ開始時:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
[設計壁打ち] <設計テーマ>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
現在: Step <N>/4 - <ステップ名>
進捗: [████░░░░░░] 40%
モード: <Light|Standard|Deep>
担当: <リードエージェント> + <サブエージェント>
エージェントチームが議論中...
議論結果提示時:
━━━━ チーム議論結果 ━━━━
合意: [全員が同意した点]
対立: [論点と各エージェントの立場]
リスク: [Devil's Advocate が発掘したリスク]
どう判断しますか?
ステップ完了時:
Step <N> 完了: <ステップ名>
→ <簡潔なサマリー>
→ 議論ラウンド: <N>回
→ 候補案: <N>件
次へ進みますか?(「次へ」で続行)
全ステップが true の場合:
{
"status": "completed",
"completedAt": "<ISO8601>",
"decision": "<採用案の名前>",
"steps": {
"1_clarification": true,
"2_proposals": true,
"3_comparison": true,
"4_decision": true
}
}
生成物:
session.json - セッション進捗管理discussion_log.md - ディスカッション議事録(エージェント間の議論含む)1_clarification.md - 課題・要件・制約の明確化結果2_proposals.md - 設計案一覧(2-4案)3_comparison.md - 比較表・深掘り結果・Devil's Advocate 指摘4_decision.md - 推奨案・ADR・アクションリスト詳細ドキュメントはトピック別に分離。必要なファイルだけ Read する:
| ファイル | 内容 |
|---|---|
references/discussion_protocol.md | R1-R4 ラウンド詳細、チームライフサイクル、収束条件、ユーザー判断追跡 |
references/step_details.md | Step 1-4 の詳細フロー(担当・目的・完了条件) |
references/output_templates.md | 成果物テンプレート(比較表・ADR・アクションリスト) |
references/agent_spawn_templates.md | Step 1-4 のエージェント起動テンプレート |
references/quality_control.md | Quality Gate 基準(ステップ別・共通) |