本文へ移動
cccskills
無料GitHub で公開

design-discussion

「こんな機能を作りたい」「この設計どうしよう」という技術的な意思決定を、 5人の専門エージェントチームで壁打ちするスキル。実装アプローチの比較・技術設計の選択・アーキテクチャの意思決定に特化。Use when: 複数の実装方法があって迷っている時、設計の良し悪しを議論したい時、 技術的トレードオフを整理したい時。

Triggers: "設計壁打ち", "design discussion", "どう設計すべき", "実装アプローチを比較", "アーキテクチャ相談", "設計どうしよう", "技術選定したい", "ADR を作りたい", "設計の議論", "技術的トレードオフ"

インストール方法を見る

含まれるファイル(6)

  • SKILL.md9.0 KB
  • references/agent_spawn_templates.md15.6 KB
  • references/discussion_protocol.md8.5 KB
  • references/output_templates.md6.6 KB
  • references/quality_control.md5.8 KB
  • references/step_details.md7.7 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Design Discussion - 技術設計壁打ちスキル

5つの専門エージェント(Solution Architect・Engineer・Product Manager・User Liaison・Devil's Advocate)が 技術的トレードオフを議論・反論し合いながら設計案を比較検討するスキル。 Facilitator(この SKILL.md 自身)がオーケストレーションし、User Liaison がユーザーへの質問を一元管理する。

スキルのフォーカス(CRITICAL)

このスキルは 実装アプローチ・技術設計の比較 に特化している。

  • 対象: データベース設計、API 設計、アーキテクチャパターン、ライブラリ選定、実装戦略、パフォーマンス最適化手法など
  • 対象外: UI/UX デザイン、ビジュアルデザイン、ユーザーフロー(それらは feature-discussion スキルを使用)
  • 成果物: 比較表(MD)、議論ログ、アクションリスト、ADR(Architecture Decision Record)

チーム構成

ロールファイル専門領域
Facilitatorこの SKILL.md議論進行・合意形成・記録
Solution Architectagents/solution-architect.md設計案生成・アーキテクチャ比較・推奨案決定
Engineeragents/engineer.md技術的実現性・コードベース調査・工数評価
Product Manageragents/product-manager.mdビジネス価値・スコープ・優先度・制約条件
User Liaisonagents/user-liaison.mdユーザーへの質問一元管理・AskUserQuestion で直接質問
Devil's Advocateagents/devils-advocate.md合意案への批判・リスク発掘・前提検証

コア原則

  1. 技術的客観性 - データと根拠で比較する。感情的な好み・馴染みで判断しない
  2. トレードオフを明示 - 「完璧な案」はない。各案の利点と欠点を等価に扱う
  3. コードファースト - 質問前に既存コードを把握する
  4. ユーザー主導の進行 - ステップ完了時に自動で次のステップに進まない。必ずユーザーに「次へ進みますか?」と確認し、明示的な承認を得てから次のステップを開始する
  5. 意思決定の記録 - なぜその案を選んだかを ADR 形式で残す
  6. 悪魔の代弁者を活用 - 全員が合意した後で必ず批判的レビューを行う
  7. 実質的な議論のみ - 「了解」だけの応答は不要。反論・提案・質問がある時のみ発言

ワークフロー概要

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 を参照。

セッション開始

壁打ちセッション開始時、以下を実行:

  1. ドメインドキュメントを読み込み(docs/, .claude/ 配下の設計関連 MD を Glob で検索)
  2. 既存の設計パターンを把握(コードベースがあれば Engineer に初期調査を依頼)
  3. セッション名(discussion-slug)を生成:
    • テーマを英語の kebab-case スラッグに変換
    • 日本語の場合は英訳してからスラッグ化
  4. .claude/design_discussion/sessions/<discussion-slug>/ ディレクトリを作成
  5. session.json を作成(下記テンプレート)
  6. discussion_log.md を作成
  7. 議論深さモードを自動判定:
    • Light: 明らかに 2 択で、制約が明確な場合
    • Standard: 3 案以上 or 影響範囲が広い場合(デフォルト)
    • Deep: アーキテクチャ全体に影響する、後戻りが難しい決定
  8. Agent Team を作成(references/discussion_protocol.md のチームライフサイクル参照)
  9. Step 1 を開始

初期 JSON テンプレート

{
  "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.mdR1-R4 ラウンド詳細、チームライフサイクル、収束条件、ユーザー判断追跡
references/step_details.mdStep 1-4 の詳細フロー(担当・目的・完了条件)
references/output_templates.md成果物テンプレート(比較表・ADR・アクションリスト)
references/agent_spawn_templates.mdStep 1-4 のエージェント起動テンプレート
references/quality_control.mdQuality Gate 基準(ステップ別・共通)

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

This skill should be used when the user asks to "create a team", "spawn agents", "parallel execution", "delegate tasks to agents", "use a swarm", "team workflow", "split work across agents", "run tasks in parallel", or mentions wanting multiple agents to collaborate on a complex task.

日本語の概要は準備中です。原文の説明を表示しています。

sean-sunagaku/claude-code-plugin382026年7月30日 更新

agent-team-guide

無料日本語概要

Agent Teams スキルを設計・構築するためのベストプラクティスガイド。 サブエージェント定義、SendMessage 通信プロトコル、タスク依存管理、 PostToolUse Hook によるログ、MCP ツール統合、コンテキストファイル設計を網羅。 7つの実績あるチームスキル(app-naming, ui-review, logo-design, persona-creation, skill-creator-team, ui-variations, aso-optimize)から抽出したパターン集。 Use when: Agent Teams を使ったスキルを新規作成したい、 既存のチームスキルの品質を改善したい、エージェント間通信のデバッグ、 チームスキルの設計パターンを知りたい。 Triggers: "agent team", "チームスキル", "エージェントチーム", "サブエージェント定義", "SendMessage パターン", "チーム設計", "エージェント間通信", "team skill", "swarm pattern"

sean-sunagaku/claude-code-plugin382026年7月30日 更新

app-naming

無料日本語概要

アプリ名・サービス名の命名を、5つの専門エージェントチームで多角的に評価・決定するスキル。 ブランディング、商標/法的リスク、デジタルプレゼンス(SEO/ASO/SNS)、国際展開(多言語/発音)の 4観点から候補を提案・調査・議論し、コンテキストファイルと議事録で次回セッションへ引き継ぐ。 Use when: アプリ名を決めたい、サービス名を変更したい、プロダクト名を検討したい、 ネーミングブレスト、名前の商標チェック、アプリ名のリネーム。 Triggers: "アプリ名", "サービス名", "プロダクト名", "ネーミング", "名前を決め", "リネーム", "rename", "app name", "naming", "ブランド名", "商標チェック"

sean-sunagaku/claude-code-plugin382026年7月30日 更新

app-store-preview-movie

無料日本語概要

App Store プレビュー動画を Remotion (React) で生成する Agent Team スキル。 video-director が構成を設計し、script-writer がナレーション台本を作成し、 motion-designer が Remotion コードを実装し、preview-reviewer がコードレビューし、 frame-inspector がレンダリング結果を目視検証する。 Use when: App Store プレビュー動画を作りたい、アプリのプロモーション動画を作りたい、 Remotion で動画を生成したい。 Triggers: "プレビュー動画", "App Store 動画", "アプリ動画", "preview movie", "Remotion", "動画作成", "app preview"

sean-sunagaku/claude-code-plugin382026年7月30日 更新

app-tone-manner

無料日本語概要

アプリのトーン&マナー(トンマナ)を8名のエージェントチームで設計するスキル。 ブランドアーキタイプ・パーソナリティ定義から、カラー・タイポグラフィ・ビジュアルスタイル・ トーン・オブ・ボイスまでを一貫設計し、Pencil (.pen) + Markdown で成果物を出力する。 「デザインテンション」(矛盾ペア)を核に、AIっぽくない独自のブランドアイデンティティを生成する。

sean-sunagaku/claude-code-plugin382026年7月30日 更新

arch-design

無料日本語概要

仕様書・要件定義からソフトウェアアーキテクチャを設計するスキル。 5人の専門エージェント(Architecture Lead・Module Designer・Dependency Analyst・ Platform Expert・Devil's Advocate)が協議しながら、 モジュール分割・依存関係・データフロー・インターフェース設計を行う。 成果物は構造化されたアーキテクチャ設計書(Markdown)。 Use when: 仕様書からどう設計するか迷っている時、モジュール分割の方針を決めたい時、 技術スタックに合ったアーキテクチャパターンを選びたい時、 設計書を作成したい時。 Triggers: "アーキテクチャ設計", "arch design", "仕様書から設計", "モジュール分割", "設計書を作りたい", "アーキテクチャを考えて", "コンポーネント設計", "依存関係を設計", "どう設計する", "design the architecture", "design from spec"

sean-sunagaku/claude-code-plugin382026年7月30日 更新

sean-sunagaku のスキルをすべて見る

このスキルの問題を報告する