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

5.9 KiB

Raw Permalink Blame History

フェーズの検証とシッピング方法

目的: 実行済みの成果物をユーザー受け入れテストに通し、失敗を診断・修正してから、自動生成された本文でプルリクエストを作成します。

前提条件: フェーズが実行済みで SUMMARY.md ファイルが存在すること。実行がまだ完了していない場合はフェーズの実行を参照してください。

ユーザー受け入れテストを実行する

/msd-verify-work 1

MSD はフェーズの SUMMARY.md ファイルを読み込み、ユーザーが観察できる成果物を抽出して、それらを一つずつ確認します。各チェックポイントで、起こるべきことを提示し、実際にそうなっているかを尋ねます。

yes / y / 空白 → 合格、次のテストへ
それ以外 → 問題として記録され、あなたの説明から重要度が推定されます

重要度を分類する必要はありません — MSD があなたの言葉から推定します（「クラッシュする」→ ブロッカー、「動かない」→ メジャー、「見た目がおかしい」→ コスメティック）。

進捗は .planning/phases/01-<name>/01-UAT.md に書き込まれ、/clear 後も保持されます。セッションが中断された場合は /msd-verify-work 1 を再実行すると、最後のチェックポイントから再開するかどうか確認されます。

失敗が見つかった場合: 自動診断と修正プランニング

テストで問題が報告された場合、MSD は自動的に次を実行します:

根本原因を診断 — 問題ごとに並列デバッグエージェントを起動し、UAT.md に根本原因を追記します。
ギャップ修正をプランニング — msd-planner をギャップ修正モードで起動し、（診断を含む）UAT.md を読み込んで新しい PLAN.md ファイルを書き込みます。
修正プランを検証 — msd-plan-checker を起動してプランが実行可能かを確認します。問題があれば、プランナーとチェッカーが最大 3 回反復します。
次のステップを提示 — プランがチェッカーを通過すると:

Plans verified and ready for execution.

`/clear` then `/msd-execute-phase 1 --gaps-only`

提示されたコマンドを実行して修正を適用し、/msd-verify-work 1 を再実行してすべてが合格することを確認してください。

すべてのテストが合格した場合: フェーズをシップする

すべての UAT テストが合格した場合（または最初の実行で問題が見つからなかった場合）、フェーズは ROADMAP.md と STATE.md で自動的に完了としてマークされます。

/msd-ship 1

MSD はプリフライトチェック（検証状態、クリーンなワーキングツリー、ブランチ、リモート、gh CLI 認証）を実行し、ブランチをプッシュして PR を作成します:

/msd-ship 1          # レビュー準備完了の PR
/msd-ship 1 --draft  # ドラフト PR — 後続フェーズが続く場合に便利

PR の本文はプランニング成果物から自動的に組み立てられます:

ROADMAP.md からのフェーズ目標
SUMMARY.md ファイルとその主要ファイルからのプランごとのサマリー
対応した要件（REQ-ID）
VERIFICATION.md からの検証状態
STATE.md からの主要な決定事項

本文を手動で書く必要はありません。

オプション: シッピング前後のコードレビュー

/msd-ship はコードレビューを自動的に実行しませんが、任意のタイミングで挿入できます:

検証前（UAT 前に問題を検出）:

/msd-code-review 1          # 標準レビュー
/msd-code-review 1 --fix    # レビュー後に Critical + Warning の発見事項を自動修正

PR オープン後（マージ前に品質をゲート）:

/msd-code-review 1 --depth=deep  # インポートグラフを含むクロスファイル分析

サイクルの早い段階でのプランレビューに Antigravity、Codex、その他のレビュアーを設定するにはクロス AI レビューの設定を参照してください。

オプション: クリーンな PR ブランチを作成する

ブランチにレビュアーに見せたくない .planning/ のコミットが含まれている場合:

/msd-pr-branch          # main に対してフィルタリング
/msd-pr-branch develop  # develop に対してフィルタリング

/msd-pr-branch はコードの変更のみを含む新しいブランチを作成します。プランニング成果物のコミットは除外されます。チームのレビューポリシーでプランニングのノイズを除外する場合は、/msd-ship の前にこれを実行してください。

マイルストーンのクローズ

これがマイルストーンの最後のフェーズだった場合は、マイルストーンの監査とアーカイブを実行します:

/msd-audit-milestone      # すべての要件がシップされたかを確認
/msd-complete-milestone   # アーカイブ、git タグの作成

/msd-complete-milestone は PR マージ後の自然な次のステップです。検証とシッピングがプロジェクト全体のライフサイクルにどう組み込まれるかについてはフェーズループを参照してください。

5.9 KiB Raw Permalink Blame History Unescape Escape