a9a7a328e6
Mechanical rename produced by scripts/msd-rename.cjs: gsd/Gsd/GSD -> msd/Msd/MSD across contents and paths, upstream package/repo coordinates -> @golem15/msd-core and golem15com/msd-core. Deep links into upstream history, sibling upstream packages, the GSD-2 import feature, CHANGELOG.md and .changeset/ are kept as-is. Hand edits on top: MSD block-letter banner and logos, LICENSE copyright line, package/plugin identity, regenerated lockfile, install-tree fixtures, derived registries and benchmark baseline; migration checksum baseline re-locked (MSD keeps its own install state, so no install had applied the old sums); sort-order and regex-escaped expectations in tests adjusted.
76 lines
4.9 KiB
Markdown
76 lines
4.9 KiB
Markdown
# ディスカッションモード：仮定 vs インタビュー
|
||
|
||
MSD Core のディスカッションフェーズは、計画を開始する前に実装コンテキストを収集するための 2 つのモードを提供します。どちらを使用するかを理解することで、質疑応答から確定した `CONTEXT.md` へとより少ない往復でたどり着けます。
|
||
|
||
どちらのモードを実行するかのステップバイステップの手順については、[フェーズ議論の how-to](how-to/discuss-a-phase.md) を参照してください。
|
||
|
||
## モード
|
||
|
||
### `discuss`（デフォルト）
|
||
|
||
オリジナルのインタビュースタイルのフロー。Claude がフェーズのグレーエリアを特定し、選択のために提示し、エリアごとに約 4 つの質問をします。以下の場合に適しています：
|
||
|
||
- コードベースが新しい初期フェーズ
|
||
- ユーザーが積極的に表明したい強い意見を持っているフェーズ
|
||
- ガイドされた会話形式のコンテキスト収集を好むユーザー
|
||
|
||
### `assumptions`
|
||
|
||
コードベースファーストのフロー。Claude はサブエージェント経由でコードベースを深く分析し（関連ファイルを 5〜15 件読み取り）、証拠付きで仮定を形成し、確認または修正のために提示します。以下の場合に適しています：
|
||
|
||
- 明確なパターンを持つ確立されたコードベース
|
||
- インタビューの質問が明らかに思えるユーザー
|
||
- より速いコンテキスト収集（約 2〜4 回のやり取り vs 約 15〜20 回）
|
||
|
||
## 設定
|
||
|
||
```bash
|
||
# assumptions モードを有効にする
|
||
node msd-tools.cjs config-set workflow.discuss_mode assumptions
|
||
|
||
# インタビューモードに戻す
|
||
node msd-tools.cjs config-set workflow.discuss_mode discuss
|
||
```
|
||
|
||
この設定はプロジェクトごとです（`.planning/config.json` に保存されます）。両方のモードが生成するファイルの完全な構造については、[CONTEXT.md スキーマ](reference/context-md.md) を参照してください。
|
||
|
||
## Assumptions モードの仕組み
|
||
|
||
1. **Init** — discuss モードと同じ（以前のコンテキストを読み込み、コードベースを偵察し、todo を確認）
|
||
2. **深い分析** — Explore サブエージェントがフェーズに関連する 5〜15 のコードベースファイルを読み取る
|
||
3. **仮定の表示** — 各仮定には以下が含まれる：
|
||
- Claude が何をどのような理由で行うか（ファイルパスを引用）
|
||
- 仮定が誤っている場合に何が問題になるか
|
||
- 信頼レベル（Confident / Likely / Unclear）
|
||
4. **確認または修正** — ユーザーが仮定を確認し、変更が必要なものを選択
|
||
5. **CONTEXT.md の書き込み** — discuss モードと同一の出力フォーマット
|
||
|
||
## フラグの互換性
|
||
|
||
| フラグ | `discuss` モード | `assumptions` モード |
|
||
|------|----------------|-------------------|
|
||
| `--auto` | 推奨される答えを自動選択 | 確認ゲートをスキップし、Unclear 項目を自動解決 |
|
||
| `--batch` | 質問をバッチでグループ化 | N/A（修正はすでにバッチ化） |
|
||
| `--text` | プレーンテキストの質問（リモートセッション） | プレーンテキストの質問（リモートセッション） |
|
||
| `--analyze` | 質問ごとにトレードオフテーブルを表示 | N/A（仮定には証拠が含まれる） |
|
||
|
||
## 出力
|
||
|
||
両方のモードが同じ 6 つのセクションを持つ同一の `CONTEXT.md` を生成します：
|
||
|
||
- `<domain>` — フェーズ境界
|
||
- `<decisions>` — ロックされた実装上の決定
|
||
- `<canonical_refs>` — 下流エージェントが必ず読むべき仕様/ドキュメント
|
||
- `<code_context>` — 再利用可能なアセット、パターン、統合ポイント
|
||
- `<specifics>` — ユーザーの参照と好み
|
||
- `<deferred>` — 将来のフェーズのために記録されたアイデア
|
||
|
||
下流エージェント（researcher、planner、checker）は、どちらのモードで生成されたかに関わらず、このファイルを同様に消費します。完全なフィールドリファレンスについては [CONTEXT.md スキーマ](reference/context-md.md) を参照してください。
|
||
|
||
## Related
|
||
|
||
- [フェーズの議論](how-to/discuss-a-phase.md) — どちらのモードでも `/msd-discuss-phase` を実行するためのステップバイステップの how-to。
|
||
- [CONTEXT.md スキーマ](reference/context-md.md) — 両方のモードが生成するファイルの完全なフィールドリファレンス。
|
||
- [フェーズループ](explanation/the-phase-loop.md) — discuss がより広い discuss → plan → execute → verify → ship サイクルにどう組み込まれるか。
|
||
- [ドキュメント索引](README.md) — MSD Core ドキュメントの完全な目次。
|