Files

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

6.5 KiB

Raw Blame History

フェーズの検討方法

目的: プランニング開始前にフェーズが必要とする実装上の決定事項を収集します。これにより、リサーチャーとプランナーがあなたに再確認することなく作業を進められます。

前提条件: .planning/ROADMAP.md が存在すること。ない場合は先に /msd-new-project を実行してください。

検討モードを選ぶ

MSD Core は 2 つのモードを提供します。コードベースへの理解度に応じて選択してください。

実装に関する自分の方針を最初に表明したい場合（インタビューモード、デフォルト）:

/msd-discuss-phase 2

Claude はフェーズスコープのグレーゾーンを特定し、どこについて議論するかを選択させた後、各エリアについておよそ 4 つの質問に取り組みます。

コードベースに明確なパターンがすでにあり、ほとんどの質問が自明に感じる場合（仮定モード）:

node msd-tools.cjs config-set workflow.discuss_mode assumptions
/msd-discuss-phase 2

Claude はサブエージェント経由でコードベースの関連ファイルを 5〜15 個読み込み、証拠と確信度を添えて仮定を立て、確認または修正のために提示します。通常 2〜4 回のやり取りで済みます（インタビューモードの 15〜20 回と比較して）。

元に戻すには:

node msd-tools.cjs config-set workflow.discuss_mode discuss

各モードの詳細な比較や、どちらが時間を節約しやすいかについては検討モードの解説を参照してください。

選択ステップなしで全グレーゾーンを検討する

デフォルトでは、Claude はグレーゾーンを提示し、どれをカバーするか選択を求めます。その選択プロンプトなしにすべてを順番に処理したい場合:

/msd-discuss-phase 2 --all

わかりやすいフェーズを高速化する

フェーズが十分に理解されており、プロンプトなしで Claude に推奨デフォルトを選択させたい場合:

/msd-discuss-phase 3 --auto

Claude はすべての質問に対して推奨回答を選択し、その選択を記録します。決定事項のリスクが低い、または以前のフェーズから既に示唆されているフェーズで使用してください。

リモートセッションの制約がある場合（TUI メニューが使えない）:

/msd-discuss-phase 2 --text

すべてのプロンプトはインタラクティブなセレクターではなく、プレーンテキストの番号付きリストとして表示されます。

質問をグループでまとめて処理する

一度に 1 つずつではなく、複数の質問をまとめて回答したい場合:

/msd-discuss-phase 2 --batch

Claude は 1 ターンに 2〜5 問をグループにまとめます。

各質問にトレードオフ分析を追加する

確定する前にオプションの比較表を見たい場合:

/msd-discuss-phase 2 --analyze

準備済みファイルから一括回答する

回答ファイルを準備済みで、すべての決定事項を一度に投入したい場合:

/msd-discuss-phase 1 --power

検討前に Claude の仮定を確認する

インタラクティブなセッションを始める前に Claude が何を仮定するかを確認したい場合 — 検討時間を投資する前にアラインメントを検証するのに役立ちます:

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

決定事項がプランニングにどう反映されるか

次に /msd-plan-phase を実行すると、プランナーは CONTEXT.md を読み込み、どの決定事項が確定済みかを把握します。ここで既に回答された質問は再確認されません。リサーチャーも最初に CONTEXT.md を読んで調査すべき内容を把握します。

/msd-plan-phase 実行時に CONTEXT.md がない場合、コンテキストなしで続行する（計画はあなたの設計方針なしにリサーチと要件のみを使用）か、先に /msd-discuss-phase を実行するかの選択を求められます。

PRD または受け入れ基準ドキュメントがある場合

discuss-phase をスキップしてプランニングに直接進んでください:

/msd-plan-phase 1 --prd path/to/prd.md

プランナーは PRD から CONTEXT.md を合成し、すべての要件を確定済みの決定事項として扱います。

6.5 KiB Raw Blame History Unescape Escape