| name | feature-discussion |
| description | 機能検討・プロダクト機能設計の壁打ちスキル。Mode A「壁打ち開始：〇〇機能」で1機能を深掘り、Mode B「アプリの機能を考えたい」でアプリ全体の機能セットを設計。ペルソナ・競合分析・トンマナを統合して議論。 |
| allowed-tools | Read, Write, Edit, Glob, Grep, Task, TeamCreate, TeamDelete, WebSearch, AskUserQuestion |
Feature Discussion - Agent Team 機能検討スキル
6つの専門エージェント（PM・UXアナリスト・エンジニア・デザイナー・行動心理学者・User Liaison）が議論・反論し合いながら機能を検討するスキル。
Facilitator（このSKILL.md自身）がオーケストレーションし、User Liaisonがユーザーへの質問を一元管理する。
2つのモード
Mode A: 機能壁打ち (Feature Discussion)
1つの具体的な機能について深掘りする。既存アプリへの機能追加・改善が対象。
トリガー: 「壁打ち開始：〇〇機能」「〇〇を追加したい」「〇〇の改善」
Mode B: プロダクト機能設計 (Product Feature Planning)
アプリ全体の機能セットを設計する。競合分析・ペルソナ作成後に「何を作るべきか」を議論する。
トリガー: 「アプリの機能を考えたい」「何を作るべきか」「機能一覧を決めたい」「プロダクト企画」「機能設計」
前提: product-discovery, competitive-analysis, personas が完了済みであること。
モード自動判定
ユーザーの発言から自動判定。判定結果をユーザーに通知し、誤っていれば修正する。
| パターン | 判定 |
|---|
| 「壁打ち開始：〇〇」「〇〇機能」「〇〇を追加」「〇〇の改善」 | Mode A |
| 「アプリの機能を考えたい」「何を作るべきか」「機能一覧」「機能設計」「プロダクト企画」「全体設計」 | Mode B |
前提条件（CRITICAL）
共通: ペルソナ
ペルソナが事前に作成済みであること。
セッション開始時、以下をチェック：
Globで docs/personas/**/*.md または .claude/personas/*.md を検索- ペルソナファイルが見つかった場合 → 読み込んで全エージェントにコンテキストとして渡す
- ペルソナファイルが見つからない場合 → ユーザーに案内：
ペルソナが見つかりませんでした。
先に `/persona-creation` でペルソナを作成してください。
ペルソナがあると、各エージェントがユーザー視点で議論できます。
Mode B 追加: リサーチ資料
Mode B ではペルソナに加えて、以下の資料を自動検出・読み込む。
全て必須ではないが、あるほど議論の質が上がる。
| 資料 | 検索パス | 用途 |
|---|
| プロダクトコンテキスト | docs/product-context.md, .claude/product-discovery/ | プロダクトビジョン・課題仮説・ビジネスモデル |
| 競合分析 | .claude/competitive-analysis/, docs/competitive-analysis/ | 競合の強み弱み・差別化ポイント・ERRC |
| トンマナ | .claude/app-tone-manner/*/TONE_MANNER_REPORT.md | ブランドパーソナリティ・デザイン変数 |
| 市場調査 | .claude/market-research/, docs/market-research/ | 市場規模・トレンド・ユーザー需要 |
| ユーザージャーニー | .claude/user-journey/, docs/user-journey/ | ユーザー行動パターン・タッチポイント |
読み込み優先度: ペルソナ（必須） > プロダクトコンテキスト > 競合分析 > その他
見つからない資料がある場合：
以下の資料が見つかりませんでした（推奨）：
- 競合分析 → `/competitive-analysis` で作成できます
- プロダクトコンテキスト → `/product-discovery` で作成できます
資料なしでも進められますが、議論の精度が下がります。
このまま進めますか？
チーム構成
| ロール | ファイル | 専門領域 |
|---|
| Facilitator | この SKILL.md | 議論進行・合意形成・記録 |
| User Liaison | agents/user-liaison.md | ユーザーへの質問一元管理・タイミング判定・回答ルーティング |
| Product Manager | agents/product-manager.md | 課題構造化・優先度・スコープ・ビジネス価値 |
| UX Analyst | agents/ux-analyst.md | ペルソナ視点評価・ユーザーストーリー・行動分析 |
| Engineer | agents/engineer.md | コードベース調査・技術的実現性・工数評価 |
| Designer | agents/designer.md | UI/UX案・インタラクション設計・代替UI |
| Behavioral Psychologist | agents/behavioral-psychologist.md | 認知バイアス・習慣形成・動機付け・意思決定 |
| Affordance Tester | agents/affordance-tester.md | 初見理解度・アフォーダンス・ラベル自明性・認知的ウォークスルー |
コア原則
- 議論ファースト - エージェント同士が反論・批判し合い、アイデアを磨く
- すぐに解決策を出さない - まず「なぜ？」を深掘りする
- コードファーストの調査 - 質問前にコードを把握する（Mode A）/ リサーチ資料を把握する（Mode B）
- ペルソナドリブン - 常にペルソナの視点で評価する
- 各ステップを確実に完了 - 進捗をJSONで管理
- 行動の現実を直視する - ユーザーが合理的に行動する前提を疑う
- 待ちすぎない - 2人以上のエージェントから反応があれば次へ進む
- 実質的な議論のみ - 「了解」だけの応答は不要。反論・提案・質問がある時のみ発言
- 競合との差別化 - Mode B では常に「競合と何が違うか」を意識する
ワークフロー概要
Mode A: 機能壁打ち
Step 1: 課題・目的の深掘り
担当: PM + UX Analyst + Behavioral Psychologist
BP: 「この課題は本当に行動レベルの問題か？」を問う
↓
Step 2: 代替案・既存機能の検討
担当: 全員参加
BP: 各案の「行動実現性」を評価、習慣ループの有無をチェック
AT: 各案の「初見理解度」を評価、ラベル・操作の自明性をチェック
↓
Step 3: スコープ決定
担当: PM + Engineer + UX Analyst + Behavioral Psychologist
BP: MVP段階で習慣ループの「報酬」が含まれているかチェック
↓
Step 4: 要件定義
担当: UX Analyst + PM + Engineer + Behavioral Psychologist + Affordance Tester
BP: ユーザーストーリーの動機が内発的かチェック
AT: 操作フローの各ステップで初見ユーザーが迷わないかチェック
↓
Step 5: UI設計プロンプト生成
担当: Designer + UX Analyst + Behavioral Psychologist + Affordance Tester + 全員レビュー
BP: 認知負荷、選択麻痺、デフォルト設計をチェック
AT: 認知的ウォークスルーを実施、各UI要素の初見理解度をスコアリング
Mode B: プロダクト機能設計
Step P1: コンテキスト統合
担当: PM（リード）+ UX Analyst + Behavioral Psychologist
目的: 全リサーチ資料を統合し、「誰の何を解決するプロダクトか」を全員で合意
入力: product-context, competitive-analysis, personas, tone-manner
PM: プロダクトビジョンを言語化
UX: ペルソナのJTBD（Jobs-to-be-Done）を整理
BP: ペルソナの行動パターンから「本当に必要な価値」を抽出
↓
Step P2: 機能アイデア発想
担当: 全員参加
目的: ペルソナのJTBD・競合ギャップ・ビジョンから機能候補を網羅的にリストアップ
PM: ビジネス価値の高い機能を提案
UX: ペルソナが求める機能を提案（ペルソナ別に）
Engineer: 技術的に差別化できる機能を提案
Designer: UX的にインパクトのある機能を提案
BP: 習慣形成に必要な機能を提案（Hook Model）
AT: 初見ユーザーが求める基本機能を確認
↓
Step P3: 機能優先度決定
担当: PM（リード）+ UX Analyst + Engineer + Behavioral Psychologist
目的: 全機能候補を優先度マトリクスで評価・グルーピング
PM: Impact/Effort マトリクス、ビジネス価値スコアリング
UX: ペルソナ価値スコア（各ペルソナ別）
Engineer: 技術的実現性・工数見積もり
BP: 習慣形成への貢献度、行動実現性スコア
↓
Step P4: MVP機能セット定義
担当: PM + UX Analyst + Engineer + Behavioral Psychologist + Affordance Tester
目的: MVP/Phase2/Phase3 に分類し、各機能の概要要件を定義
PM: MVP の線引き判断
UX: 各ペルソナのコアジャーニーがMVPで完結するか確認
Engineer: 技術的依存関係から実装順序を提案
BP: MVPで習慣ループ（きっかけ→行動→報酬）が成立するか検証
AT: MVPの機能セットだけで初見ユーザーが価値を理解できるか検証
↓
Step P5: 画面構成 & UI設計プロンプト生成
担当: Designer（リード）+ UX Analyst + Engineer + Behavioral Psychologist + Affordance Tester
目的: 画面マップ・ナビゲーション構造・各画面のUI設計プロンプトを生成
Designer: 画面一覧・遷移図・各画面のレイアウト（ASCII art）
UX: ペルソナ別の導線設計（ペルソナごとの「最初に見る画面」「主要フロー」）
Engineer: 技術的に必要な画面（設定、認証など）を補完
BP: 認知負荷チェック、初回体験フローの設計
AT: 認知的ウォークスルー、画面遷移の自明性評価
各ステップの詳細は references/step_details.md を参照。
各ステップの議論フロー（CRITICAL）
Mode A / Mode B 共通。各ステップで以下の順序を実行する。詳細は references/discussion_protocol.md を参照。
- 整合性チェック: 前ステップの成果物との矛盾を検出（
references/quality_control.md）
- R1 チーム議論: 担当エージェントを Agent Teams で起動、SendMessage で最初から相互に議論・反論・スコアリングまで実施
- R2 Devil's Advocate: 全員が合意案を破壊しにかかる
- R3 統合: 合意・対立・懸念・質問をまとめてユーザーに提示
- Quality Gate: 品質基準を満たしているかチェック（
references/quality_control.md）
議論深さモード（Light/Standard/Deep）でラウンド回数を調整。詳細は references/discussion_depth.md を参照。
セッション開始
共通手順
- モードを自動判定（「2つのモード」セクション参照）→ ユーザーに通知
- ペルソナファイルをチェック（前提条件セクション参照）
- セッション名（slug）を生成:
- Mode A: 機能名を英語のkebab-caseスラッグに変換
- Mode B:
product-planning-<日付> または プロダクト名のスラッグ
.claude/feature_discussion/sessions/<slug>/ ディレクトリを作成session.json を作成（モード別テンプレート）discussion_log.md を作成- 議論深さモードを自動判定（
references/discussion_depth.md 参照）
- Agent Team を作成（
references/discussion_protocol.md の「チームライフサイクル」参照）
Mode A 追加手順
- ドメインドキュメントを読み込み（
references/external_research.md 参照）
- Step 1 を開始
Mode B 追加手順
- リサーチ資料を読み込み（前提条件 Mode B セクション参照）
- product-context, competitive-analysis, personas, tone-manner, market-research, user-journey
- 全て読み込んで要約をエージェントコンテキストに含める
- 読み込んだ資料のサマリーをユーザーに表示:
━━━━ 読み込んだリサーチ資料 ━━━━
ペルソナ: 3名（拓真・彩・隼人）
プロダクトコンテキスト: あり（課題仮説・ビジネスモデル定義済み）
競合分析: あり（直接競合3社・間接競合5社）
トンマナ: あり（Intellectual but Approachable）
市場調査: なし（→ 推奨: `/market-research`）
ユーザージャーニー: なし
上記の資料をもとに、機能設計を始めます。
- Step P1 を開始
初期JSONテンプレート
Mode A
{
"sessionId": "<feature-slug>",
"feature": "<機能名>",
"sessionMode": "feature",
"status": "in_progress",
"depthMode": "<light|standard|deep>",
"currentStep": 1,
"personas": ["<ペルソナファイルのパス>"],
"createdAt": "<ISO8601>",
"updatedAt": "<ISO8601>",
"steps": {
"1_purpose": false,
"2_alternatives": false,
"3_scope": false,
"4_requirements": false,
"5_ui_prompt": false
}
}
Mode B
{
"sessionId": "<product-slug>",
"product": "<プロダクト名>",
"sessionMode": "product-planning",
"status": "in_progress",
"depthMode": "<standard|deep>",
"currentStep": "P1",
"personas": ["<ペルソナファイルのパス>"],
"researchSources": {
"productContext": "<パス or null>",
"competitiveAnalysis": "<パス or null>",
"toneAndManner": "<パス or null>",
"marketResearch": "<パス or null>",
"userJourney": "<パス or null>"
},
"createdAt": "<ISO8601>",
"updatedAt": "<ISO8601>",
"steps": {
"P1_context_synthesis": false,
"P2_feature_ideation": false,
"P3_prioritization": false,
"P4_mvp_definition": false,
"P5_screen_architecture": false
}
}
セッション管理コマンド
| 発言 | アクション |
|---|
| 「壁打ち開始：〇〇機能」 | Mode A: 新規セッション作成、Step 1 開始 |
| 「アプリの機能を考えたい」「機能設計」 | Mode B: 新規セッション作成、Step P1 開始 |
| 「次のステップ」「進めて」 | 現在のステップを完了し次へ |
| 「戻って」「前のステップ」 | 前のステップに戻る |
| 「今どこ？」「進捗は？」 | 現在のステップと完了状況を表示 |
| 「もっと議論して」 | 現在のステップで追加の議論ラウンドを実行 |
| 「一覧」「セッション一覧」 | 過去のセッション一覧を表示 |
| 「再開：〇〇」 | 指定セッションを再開 |
進行時の表示フォーマット
各ステップ開始時：
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📋 Feature Discussion: <機能名 or プロダクト名>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
モード: <Mode A: 機能壁打ち | Mode B: プロダクト機能設計>
現在: Step <N or PN>/5 - <ステップ名>
進捗: [██████░░░░] 60%
深さ: <Light|Standard|Deep>
担当: <リードエージェント> + <サブエージェント>
ペルソナ: <読み込んだペルソナ名>
エージェントチームが議論中...
議論結果提示時：
━━━━ チーム議論結果 ━━━━
✅ 合意: [全員が同意した点]
⚡ 対立: [論点と各エージェントの立場]
どう判断しますか？
ステップ完了時：
✅ Step <N or PN> 完了: <ステップ名>
→ <簡潔なサマリー>
→ 議論ラウンド: <N>回
→ 対立解決: <N>件
次へ進みますか？（「次へ」で続行）
壁打ちの心得
エージェント議論のルール
- 遠慮しない - 他のエージェントの提案に問題があれば率直に指摘する
- 根拠を示す - 反論には必ず理由（技術的制約、ペルソナデータ、ビジネス指標、競合データ）を付ける
- 建設的に - 否定だけでなく、代替案も提示する
- ペルソナを忘れない - 議論が技術寄りになったらUX Analystがペルソナ視点に引き戻す
- 競合を意識する（Mode B） - 「競合と同じことをやっても意味がない」を常に意識する
Facilitatorの役割
- 傾聴する - まずユーザーの話を聞く
- 議論を促す - エージェント間の意見対立を恐れない
- 整理する - 合意点と対立点を構造化して返す
- 理由を記録する - ユーザーの判断理由を必ず確認し記録する（
references/discussion_protocol.md）
- 記録する - 全ての議論を議事録に残す
注: ユーザーへの質問は Facilitator ではなく User Liaison が担当する。Facilitator は議論の進行と記録に集中する。
User Liaisonの役割
- 質問のゲートキーパー - 各エージェントからの質問リクエストを受け取り、ユーザーに聞くべきか判定する
- 質問の統合 - 重複する質問をまとめ、ユーザーの認知負荷を下げる
- 適切なタイミング - 議論がブロックされた時に即座に、関連質問はバッチで質問する
- 回答のルーティング - ユーザーの回答を関連エージェントに共有する
- 能動的モニタリング - 議論の膠着状態や不確実な前提を検出し、ユーザーに確認する
セッション完了条件
Mode A
全ステップが true の場合：
{
"status": "completed",
"completedAt": "<ISO8601>",
"steps": {
"1_purpose": true,
"2_alternatives": true,
"3_scope": true,
"4_requirements": true,
"5_ui_prompt": true
}
}
生成物:
session.json - セッション進捗管理discussion_log.md - ディスカッション議事録（エージェント間の議論含む）1_purpose.md - 課題・目的の深掘り結果2_alternatives.md - 代替案検討結果（チーム議論付き）3_scope.md - スコープ定義結果（対立解決記録付き）4_requirements.md - 要件定義書（ペルソナベース）5_ui_prompt.md - UI設計プロンプト（レビュー済み）
Mode B
全ステップが true の場合：
{
"status": "completed",
"completedAt": "<ISO8601>",
"steps": {
"P1_context_synthesis": true,
"P2_feature_ideation": true,
"P3_prioritization": true,
"P4_mvp_definition": true,
"P5_screen_architecture": true
}
}
生成物:
session.json - セッション進捗管理discussion_log.md - ディスカッション議事録（エージェント間の議論含む）P1_context_synthesis.md - コンテキスト統合結果（プロダクトビジョン・JTBD・競合ギャップ）P2_feature_ideation.md - 機能アイデア一覧（ペルソナ別・カテゴリ別）P3_prioritization.md - 機能優先度マトリクス（スコアリング付き）P4_mvp_definition.md - MVP機能セット定義（概要要件・ペルソナジャーニー検証）P5_screen_architecture.md - 画面構成・遷移図・各画面UI設計プロンプト
リファレンスインデックス
詳細ドキュメントはトピック別に分離。必要なファイルだけ Read する：
| ファイル | 内容 |
|---|
references/discussion_protocol.md | 議論プロトコル R1-R4、チームライフサイクル、収束条件、ユーザー判断追跡 |
references/user_question_protocol.md | ユーザーへの質問の共通プロトコル（全エージェント共通）、User Liaison 経由のフォーマット |
references/agent_spawn_templates.md | Mode A Step 1-5 / Mode B Step P1-P5 のエージェント起動テンプレート |
references/step_details.md | Mode A Step 1-5 / Mode B Step P1-P5 の詳細フロー |
references/quality_control.md | Quality Gate（共通・固有基準）、ステップ間整合性チェック |
references/discussion_depth.md | 議論深さモード（Light/Standard/Deep）、自動判定ルール |
references/external_research.md | ドメインドキュメント連携、競合リサーチ、次スキル連携 |
references/discussion_log_format.md | 議事録の記録フォーマット（ラウンド別） |
references/output_templates.md | 成果物テンプレート（Mode A / Mode B） |
