Files
msd-core/docs/ja-JP/workflow-discuss-mode.md
Jakub Zych a9a7a328e6 refactor: hard-fork GSD -> MSD (Make Software Done)
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.
2026-10-06 01:47:40 +02:00

4.9 KiB
Raw Blame History

ディスカッションモード:仮定 vs インタビュー

MSD Core のディスカッションフェーズは、計画を開始する前に実装コンテキストを収集するための 2 つのモードを提供します。どちらを使用するかを理解することで、質疑応答から確定した CONTEXT.md へとより少ない往復でたどり着けます。

どちらのモードを実行するかのステップバイステップの手順については、フェーズ議論の how-to を参照してください。

モード

discuss(デフォルト)

オリジナルのインタビュースタイルのフロー。Claude がフェーズのグレーエリアを特定し、選択のために提示し、エリアごとに約 4 つの質問をします。以下の場合に適しています:

  • コードベースが新しい初期フェーズ
  • ユーザーが積極的に表明したい強い意見を持っているフェーズ
  • ガイドされた会話形式のコンテキスト収集を好むユーザー

assumptions

コードベースファーストのフロー。Claude はサブエージェント経由でコードベースを深く分析し(関連ファイルを 5〜15 件読み取り)、証拠付きで仮定を形成し、確認または修正のために提示します。以下の場合に適しています:

  • 明確なパターンを持つ確立されたコードベース
  • インタビューの質問が明らかに思えるユーザー
  • より速いコンテキスト収集(約 2〜4 回のやり取り vs 約 15〜20 回)

設定

# 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 スキーマ を参照してください。

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 スキーマ を参照してください。

  • フェーズの議論 — どちらのモードでも /msd-discuss-phase を実行するためのステップバイステップの how-to。
  • CONTEXT.md スキーマ — 両方のモードが生成するファイルの完全なフィールドリファレンス。
  • フェーズループ — discuss がより広い discuss → plan → execute → verify → ship サイクルにどう組み込まれるか。
  • ドキュメント索引 — MSD Core ドキュメントの完全な目次。