Skip to content
cccskills
FreePublished on GitHub

design-discussion

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

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

The English summary is being prepared. Showing the original description.

See how to install

Files included (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 (original)

Review the instructions the agent will receive before you install.

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 基準(ステップ別・共通)

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

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.

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

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"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

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

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

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"

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

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

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

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

The English summary is being prepared. Showing the original description.

sean-sunagaku/claude-code-plugin38Updated Jul 30, 2026

See all skills by sean-sunagaku

Report a problem with this skill