Files
get-shit-done/docs/ja-JP/workflow-discuss-mode.md
2026-03-23 14:09:39 +09:00

3.5 KiB
Raw Permalink Blame History

ディスカスモード: Assumptions vs Interview

GSD の discuss フェーズには、プランニング前に実装コンテキストを収集するための2つのモードがあります。

モード

discuss(デフォルト)

従来のインタビュー形式のフローです。Claude がフェーズ内の不明瞭な領域を特定し、選択肢として提示した後、各領域について約4つの質問を行います。以下のケースに適しています:

  • コードベースが初めてで、初期フェーズの場合
  • ユーザーが積極的に意見を表明したい場合
  • ガイド付きの対話的なコンテキスト収集を好むユーザー

assumptions

コードベース優先のフローです。Claude がサブエージェントを通じてコードベースを深く分析し関連ファイルを5〜15個読み取り、根拠付きの仮説を立てて確認・修正を求めます。以下のケースに適しています:

  • 明確なパターンが確立されたコードベース
  • インタビューの質問が自明と感じるユーザー
  • より高速なコンテキスト収集約2〜4回のやり取り vs 約15〜20回

設定

# assumptions モードを有効にする
gsd-tools config-set workflow.discuss_mode assumptions

# interview モードに戻す
gsd-tools config-set workflow.discuss_mode discuss

この設定はプロジェクト単位です(.planning/config.json に保存されます)。

Assumptions モードの仕組み

  1. 初期化 — 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は、モードに関係なくこの出力を同一に消費します。