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