3bb2f8f1c5
* chore: wire docs/agents config into AGENTS.md Agent skills section
Add the `## Agent skills` discovery block pointing the engineering
skills at the existing docs/agents/{issue-tracker,triage-labels,domain}.md
files (issue tracker, triage label mapping, single-context domain docs).
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: rebrand to GSD Core and restructure docs with Diataxis
Reorganise the root README and docs/ around the Diataxis framework
(tutorials, how-to guides, reference, explanation), add new how-to
guides and schema references (STATE.md / CONTEXT.md / PLAN.md /
planning artifacts), and cross-link the whole set. Update the lone
legacy gsd-build reference to open-gsd; keep internal get-shit-done/
filesystem paths unchanged (directory rename tracked separately in
open-gsd/gsd-core#604). Regenerate the ja-JP, ko-KR, pt-BR and zh-CN
localised trees to mirror the new structure.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
* docs: backfill changeset PR number (#605)
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
---------
Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
4.9 KiB
4.9 KiB
ディスカッションモード：仮定 vs インタビュー
GSD Core のディスカッションフェーズは、計画を開始する前に実装コンテキストを収集するための 2 つのモードを提供します。どちらを使用するかを理解することで、質疑応答から確定した CONTEXT.md へとより少ない往復でたどり着けます。
どちらのモードを実行するかのステップバイステップの手順については、フェーズ議論の how-to を参照してください。
モード
discuss（デフォルト）
オリジナルのインタビュースタイルのフロー。Claude がフェーズのグレーエリアを特定し、選択のために提示し、エリアごとに約 4 つの質問をします。以下の場合に適しています：
- コードベースが新しい初期フェーズ
- ユーザーが積極的に表明したい強い意見を持っているフェーズ
- ガイドされた会話形式のコンテキスト収集を好むユーザー
assumptions
コードベースファーストのフロー。Claude はサブエージェント経由でコードベースを深く分析し（関連ファイルを 5〜15 件読み取り）、証拠付きで仮定を形成し、確認または修正のために提示します。以下の場合に適しています：
- 明確なパターンを持つ確立されたコードベース
- インタビューの質問が明らかに思えるユーザー
- より速いコンテキスト収集（約 2〜4 回のやり取り vs 約 15〜20 回）
設定
# assumptions モードを有効にする
node gsd-tools.cjs config-set workflow.discuss_mode assumptions
# インタビューモードに戻す
node gsd-tools.cjs config-set workflow.discuss_mode discuss
この設定はプロジェクトごとです（.planning/config.json に保存されます）。両方のモードが生成するファイルの完全な構造については、CONTEXT.md スキーマ を参照してください。
Assumptions モードの仕組み
- Init — discuss モードと同じ（以前のコンテキストを読み込み、コードベースを偵察し、todo を確認）
- 深い分析 — Explore サブエージェントがフェーズに関連する 5〜15 のコードベースファイルを読み取る
- 仮定の表示 — 各仮定には以下が含まれる：
- Claude が何をどのような理由で行うか（ファイルパスを引用）
- 仮定が誤っている場合に何が問題になるか
- 信頼レベル（Confident / Likely / Unclear）
- 確認または修正 — ユーザーが仮定を確認し、変更が必要なものを選択
- 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 スキーマ を参照してください。
Related
- フェーズの議論 — どちらのモードでも
/gsd-discuss-phaseを実行するためのステップバイステップの how-to。 - CONTEXT.md スキーマ — 両方のモードが生成するファイルの完全なフィールドリファレンス。
- フェーズループ — discuss がより広い discuss → plan → execute → verify → ship サイクルにどう組み込まれるか。
- ドキュメント索引 — GSD Core ドキュメントの完全な目次。