Files
msd-core/docs/ja-JP/how-to/execute-a-phase.md
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

4.7 KiB
Raw Permalink Blame History

フェーズの実行方法

目的: プランニング済みのフェーズをウェーブベースの並列実行で処理し、各プランをアトミックな git コミットとしてランディングさせます。

前提条件: フェーズに少なくとも 1 つの PLAN.md ファイルがあること。プランニングがまだ完了していない場合は、先に /msd-plan-phase N を実行してください — フェーズのプランニング を参照。


フェーズ全体を実行する

/msd-execute-phase 1

MSD はフェーズのプランファイルを読み込み、依存関係ウェーブにグループ化し、プランごとに新鮮なエグゼキュータエージェントを起動します。各エグゼキュータは次のウェーブが始まる前にアトミックにコミットします。

エージェントがディスパッチされる前に、MSD はウェーブテーブルを表示します:

## Execution Plan

Phase 1: Core middleware — 3 plans across 2 wave(s)

| Wave | Plans          | What it builds            |
|------|----------------|---------------------------|
| 1    | 01-01, 01-02   | Core validation function  |
| 2    | 01-03          | Express middleware wrapper |

ウェーブ 1 のプランは並列実行されます(それぞれ独立した git ワークツリーで)。ウェーブ 2 はウェーブ 1 のすべてのコミットがマージされるまで待機します。

基礎となるエージェント調整モデルについては マルチエージェントオーケストレーション を参照してください。


単一ウェーブのみ実行する

ウェーブ 1 の出力を確認してからウェーブ 2 に進むなど、1 つのウェーブのみを実行したい場合は --wave N を使用します:

/msd-execute-phase 1 --wave 2

MSD はウェーブ 2 のプランのみを実行します。実行前に前のウェーブがすべて完了しているか確認します。ウェーブ 1 のプランがまだ未完了の場合は、先に前のウェーブを完了するよう指示して停止します。


停止した実行を再開する

クォータエラー、ネットワーク切断、セッションのクラッシュなどで実行が途中停止した場合、ウェーブレベルの進捗は保持されています。MSD は各プランの SUMMARY.md ファイルを確認し、すでに存在するプランは再実行時に自動的にスキップされます:

/msd-execute-phase 1

MSD は SUMMARY.md がすでに存在するプランをスキップし、最初の未完了プランから再開します。

コミットは存在するが SUMMARY.md がない場合(エグゼキュータはコミットしたが、セッションが終了する前にサマリーを書き込まなかった)、MSD はセーフ再開ゲートを表示し、3 つの選択肢を提示します:

  • close out manually — コミットを確認し、SUMMARY.md を書き込んで再実行する
  • re-execute from scratch — 部分的なコミットを差し戻すか上書きしてから新しいエグゼキュータをディスパッチする
  • mark-and-skip — 異常を記録して次に進む(明示的な確認が必要)

体系的な障害診断については 実行失敗のデバッグ を参照してください。


出力の場所

すべてのウェーブが完了すると、フェーズディレクトリには以下が含まれます:

.planning/phases/01-<name>/
  01-01-SUMMARY.md    # プラン 01 が構築したもの、主要ファイル、逸脱
  01-02-SUMMARY.md
  01-03-SUMMARY.md
  VERIFICATION.md     # 要件ごとの合格/不合格状態

STATE.md と ROADMAP.md はすべてのウェーブが完了すると自動的に更新されます。VERIFICATION.md はフェーズが完全に完了した時のみ書き込まれます。

Git の履歴には、各エグゼキュータからのタスクごとのコミットと、オーケストレータからのトラッキングコミットが表示されます。


クロス AI 実行

workflow.cross_ai_command で設定された外部 AI CLI(Codex、Antigravity など)に実行を委任するには:

/msd-execute-phase 2 --cross-ai

設定でクロス AI が有効であってもローカル実行を強制するには:

/msd-execute-phase 2 --no-cross-ai