docs: rebrand to GSD Core and restructure docs with Diataxis (#605)
* 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>
This commit is contained in:
@@ -1,65 +1,75 @@
|
||||
# ディスカスモード: Assumptions vs Interview
|
||||
# ディスカッションモード:仮定 vs インタビュー
|
||||
|
||||
GSD の discuss フェーズには、プランニング前に実装コンテキストを収集するための2つのモードがあります。
|
||||
GSD Core のディスカッションフェーズは、計画を開始する前に実装コンテキストを収集するための 2 つのモードを提供します。どちらを使用するかを理解することで、質疑応答から確定した `CONTEXT.md` へとより少ない往復でたどり着けます。
|
||||
|
||||
どちらのモードを実行するかのステップバイステップの手順については、[フェーズ議論の how-to](how-to/discuss-a-phase.md) を参照してください。
|
||||
|
||||
## モード
|
||||
|
||||
### `discuss`(デフォルト)
|
||||
|
||||
従来のインタビュー形式のフローです。Claude がフェーズ内の不明瞭な領域を特定し、選択肢として提示した後、各領域について約4つの質問を行います。以下のケースに適しています:
|
||||
オリジナルのインタビュースタイルのフロー。Claude がフェーズのグレーエリアを特定し、選択のために提示し、エリアごとに約 4 つの質問をします。以下の場合に適しています:
|
||||
|
||||
- コードベースが初めてで、初期フェーズの場合
|
||||
- ユーザーが積極的に意見を表明したい場合
|
||||
- ガイド付きの対話的なコンテキスト収集を好むユーザー
|
||||
- コードベースが新しい初期フェーズ
|
||||
- ユーザーが積極的に表明したい強い意見を持っているフェーズ
|
||||
- ガイドされた会話形式のコンテキスト収集を好むユーザー
|
||||
|
||||
### `assumptions`
|
||||
|
||||
コードベース優先のフローです。Claude がサブエージェントを通じてコードベースを深く分析し(関連ファイルを5〜15個読み取り)、根拠付きの仮説を立てて確認・修正を求めます。以下のケースに適しています:
|
||||
コードベースファーストのフロー。Claude はサブエージェント経由でコードベースを深く分析し(関連ファイルを 5〜15 件読み取り)、証拠付きで仮定を形成し、確認または修正のために提示します。以下の場合に適しています:
|
||||
|
||||
- 明確なパターンが確立されたコードベース
|
||||
- インタビューの質問が自明と感じるユーザー
|
||||
- より高速なコンテキスト収集(約2〜4回のやり取り vs 約15〜20回)
|
||||
- 明確なパターンを持つ確立されたコードベース
|
||||
- インタビューの質問が明らかに思えるユーザー
|
||||
- より速いコンテキスト収集(約 2〜4 回のやり取り vs 約 15〜20 回)
|
||||
|
||||
## 設定
|
||||
|
||||
```bash
|
||||
# assumptions モードを有効にする
|
||||
gsd-tools config-set workflow.discuss_mode assumptions
|
||||
node gsd-tools.cjs config-set workflow.discuss_mode assumptions
|
||||
|
||||
# interview モードに戻す
|
||||
gsd-tools config-set workflow.discuss_mode discuss
|
||||
# インタビューモードに戻す
|
||||
node gsd-tools.cjs config-set workflow.discuss_mode discuss
|
||||
```
|
||||
|
||||
この設定はプロジェクト単位です(`.planning/config.json` に保存されます)。
|
||||
この設定はプロジェクトごとです(`.planning/config.json` に保存されます)。両方のモードが生成するファイルの完全な構造については、[CONTEXT.md スキーマ](reference/context-md.md) を参照してください。
|
||||
|
||||
## Assumptions モードの仕組み
|
||||
|
||||
1. **初期化** — discuss モードと同様(前回のコンテキスト読み込み、コードベース調査、TODO チェック)
|
||||
2. **深層分析** — Explore サブエージェントがフェーズに関連するコードベースファイルを5〜15個読み取る
|
||||
3. **仮説の提示** — 各仮説には以下が含まれる:
|
||||
1. **Init** — discuss モードと同じ(以前のコンテキストを読み込み、コードベースを偵察し、todo を確認)
|
||||
2. **深い分析** — Explore サブエージェントがフェーズに関連する 5〜15 のコードベースファイルを読み取る
|
||||
3. **仮定の表示** — 各仮定には以下が含まれる:
|
||||
- Claude が何をどのような理由で行うか(ファイルパスを引用)
|
||||
- 仮説が間違っていた場合のリスク
|
||||
- 確信度レベル(Confident / Likely / Unclear)
|
||||
4. **確認または修正** — ユーザーが仮説をレビューし、変更が必要なものを選択
|
||||
5. **CONTEXT.md の生成** — discuss モードと同一の出力フォーマット
|
||||
- 仮定が誤っている場合に何が問題になるか
|
||||
- 信頼レベル(Confident / Likely / Unclear)
|
||||
4. **確認または修正** — ユーザーが仮定を確認し、変更が必要なものを選択
|
||||
5. **CONTEXT.md の書き込み** — discuss モードと同一の出力フォーマット
|
||||
|
||||
## フラグの互換性
|
||||
|
||||
| フラグ | `discuss` モード | `assumptions` モード |
|
||||
|--------|-----------------|---------------------|
|
||||
| `--auto` | 推奨回答を自動選択 | 確認ゲートをスキップし、Unclear 項目を自動解決 |
|
||||
| `--batch` | 質問をバッチでグループ化 | N/A(修正は既にバッチ化済み) |
|
||||
| `--text` | プレーンテキスト形式の質問(リモートセッション向け) | プレーンテキスト形式の質問(リモートセッション向け) |
|
||||
| `--analyze` | 質問ごとにトレードオフ表を表示 | N/A(仮説に根拠が含まれる) |
|
||||
|------|----------------|-------------------|
|
||||
| `--auto` | 推奨される答えを自動選択 | 確認ゲートをスキップし、Unclear 項目を自動解決 |
|
||||
| `--batch` | 質問をバッチでグループ化 | N/A(修正はすでにバッチ化) |
|
||||
| `--text` | プレーンテキストの質問(リモートセッション) | プレーンテキストの質問(リモートセッション) |
|
||||
| `--analyze` | 質問ごとにトレードオフテーブルを表示 | N/A(仮定には証拠が含まれる) |
|
||||
|
||||
## 出力
|
||||
|
||||
両モードとも、同じ6セクション構成の CONTEXT.md を生成します:
|
||||
- `<domain>` — フェーズの境界
|
||||
- `<decisions>` — 確定した実装上の決定事項
|
||||
- `<canonical_refs>` — 下流エージェントが読むべき仕様・ドキュメント
|
||||
- `<code_context>` — 再利用可能なアセット、パターン、統合ポイント
|
||||
- `<specifics>` — ユーザーの参照情報と好み
|
||||
- `<deferred>` — 将来のフェーズに先送りするアイデア
|
||||
両方のモードが同じ 6 つのセクションを持つ同一の `CONTEXT.md` を生成します:
|
||||
|
||||
下流エージェント(researcher、planner、checker)は、モードに関係なくこの出力を同一に消費します。
|
||||
- `<domain>` — フェーズ境界
|
||||
- `<decisions>` — ロックされた実装上の決定
|
||||
- `<canonical_refs>` — 下流エージェントが必ず読むべき仕様/ドキュメント
|
||||
- `<code_context>` — 再利用可能なアセット、パターン、統合ポイント
|
||||
- `<specifics>` — ユーザーの参照と好み
|
||||
- `<deferred>` — 将来のフェーズのために記録されたアイデア
|
||||
|
||||
下流エージェント(researcher、planner、checker)は、どちらのモードで生成されたかに関わらず、このファイルを同様に消費します。完全なフィールドリファレンスについては [CONTEXT.md スキーマ](reference/context-md.md) を参照してください。
|
||||
|
||||
## Related
|
||||
|
||||
- [フェーズの議論](how-to/discuss-a-phase.md) — どちらのモードでも `/gsd-discuss-phase` を実行するためのステップバイステップの how-to。
|
||||
- [CONTEXT.md スキーマ](reference/context-md.md) — 両方のモードが生成するファイルの完全なフィールドリファレンス。
|
||||
- [フェーズループ](explanation/the-phase-loop.md) — discuss がより広い discuss → plan → execute → verify → ship サイクルにどう組み込まれるか。
|
||||
- [ドキュメント索引](README.md) — GSD Core ドキュメントの完全な目次。
|
||||
|
||||
Reference in New Issue
Block a user