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>
6.5 KiB
フェーズの検討方法
目的: プランニング開始前にフェーズが必要とする実装上の決定事項を収集します。これにより、リサーチャーとプランナーがあなたに再確認することなく作業を進められます。
前提条件: .planning/ROADMAP.md が存在すること。ない場合は先に /gsd-new-project を実行してください。
検討モードを選ぶ
GSD Core は 2 つのモードを提供します。コードベースへの理解度に応じて選択してください。
実装に関する自分の方針を最初に表明したい場合（インタビューモード、デフォルト）:
/gsd-discuss-phase 2
Claude はフェーズスコープのグレーゾーンを特定し、どこについて議論するかを選択させた後、各エリアについておよそ 4 つの質問に取り組みます。
コードベースに明確なパターンがすでにあり、ほとんどの質問が自明に感じる場合（仮定モード）:
node gsd-tools.cjs config-set workflow.discuss_mode assumptions
/gsd-discuss-phase 2
Claude はサブエージェント経由でコードベースの関連ファイルを 5〜15 個読み込み、証拠と確信度を添えて仮定を立て、確認または修正のために提示します。通常 2〜4 回のやり取りで済みます（インタビューモードの 15〜20 回と比較して）。
元に戻すには:
node gsd-tools.cjs config-set workflow.discuss_mode discuss
各モードの詳細な比較や、どちらが時間を節約しやすいかについては 検討モードの解説 を参照してください。
選択ステップなしで全グレーゾーンを検討する
デフォルトでは、Claude はグレーゾーンを提示し、どれをカバーするか選択を求めます。その選択プロンプトなしにすべてを順番に処理したい場合:
/gsd-discuss-phase 2 --all
わかりやすいフェーズを高速化する
フェーズが十分に理解されており、プロンプトなしで Claude に推奨デフォルトを選択させたい場合:
/gsd-discuss-phase 3 --auto
Claude はすべての質問に対して推奨回答を選択し、その選択を記録します。決定事項のリスクが低い、または以前のフェーズから既に示唆されているフェーズで使用してください。
リモートセッションの制約がある場合（TUI メニューが使えない）:
/gsd-discuss-phase 2 --text
すべてのプロンプトはインタラクティブなセレクターではなく、プレーンテキストの番号付きリストとして表示されます。
質問をグループでまとめて処理する
一度に 1 つずつではなく、複数の質問をまとめて回答したい場合:
/gsd-discuss-phase 2 --batch
Claude は 1 ターンに 2〜5 問をグループにまとめます。
各質問にトレードオフ分析を追加する
確定する前にオプションの比較表を見たい場合:
/gsd-discuss-phase 2 --analyze
準備済みファイルから一括回答する
回答ファイルを準備済みで、すべての決定事項を一度に投入したい場合:
/gsd-discuss-phase 1 --power
検討前に Claude の仮定を確認する
インタラクティブなセッションを始める前に Claude が何を仮定するかを確認したい場合 — 検討時間を投資する前にアラインメントを検証するのに役立ちます:
/gsd-discuss-phase 3 --assumptions
Claude は仮定（コードベースの証拠と確信度を添えて）を出力して終了します。CONTEXT.md は書き込まれません。出力を確認し、修正が必要な点があれば通常の discuss または仮定モードのセッションを実行してください。
CONTEXT.md の内容
discuss モードと仮定モードはどちらも同じ {phase}-CONTEXT.md をフェーズディレクトリに生成します。下流のエージェント（リサーチャー、プランナー、プランチェッカー）は、どちらのモードで生成されたかに関係なくこのファイルを同じように読み込みます。このファイルは 6 つのセクションで構成されています:
| セクション | 目的 |
|---|---|
<domain> |
フェーズの境界 — このフェーズが提供するもの |
<decisions> |
セッションで確定した実装上の決定事項 |
<canonical_refs> |
下流エージェントが必ず読むべき仕様書、ADR、ドキュメント |
<code_context> |
再利用可能なアセット、パターン、統合ポイント |
<specifics> |
ユーザーの参照情報と設定 |
<deferred> |
将来のフェーズに向けてメモされたアイデア |
<canonical_refs> セクションは必須です。検討中にドキュメント、仕様書、ADR を参照した場合、Claude はそれを即座に追加し、後続の質問に活用するために読み込みます。
完全なフィールドリファレンスは CONTEXT.md スキーマ を参照してください。
決定事項がプランニングにどう反映されるか
次に /gsd-plan-phase を実行すると、プランナーは CONTEXT.md を読み込み、どの決定事項が確定済みかを把握します。ここで既に回答された質問は再確認されません。リサーチャーも最初に CONTEXT.md を読んで調査すべき内容を把握します。
/gsd-plan-phase 実行時に CONTEXT.md がない場合、コンテキストなしで続行する（計画はあなたの設計方針なしにリサーチと要件のみを使用）か、先に /gsd-discuss-phase を実行するかの選択を求められます。
PRD または受け入れ基準ドキュメントがある場合
discuss-phase をスキップしてプランニングに直接進んでください:
/gsd-plan-phase 1 --prd path/to/prd.md
プランナーは PRD から CONTEXT.md を合成し、すべての要件を確定済みの決定事項として扱います。