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

14 KiB

Raw Permalink Blame History

MSD によるイシュー駆動オーケストレーション

ステータス： 安定したワークフローガイド
対象： GitHub Issues、Linear、Jira、または類似のイシュートラッカーで作業を追跡し、MSD の既存プリミティブを通じて AI 支援実装を推進したい開発者。

このガイドについて

MSD がすでに提供するコマンドをイシュートラッカー → ワークスペース → 計画/実行 → 検証/レビュー → PR ループに組み合わせるためのレシピです。これはドキュメントのみです。新しいコマンドなし、デーモンなし、トラッカー統合なし——以下で参照するすべてのコマンドは今日の MSD に既に存在します。

この形は OpenAI のオープンソース Symphony オーケストレーションリファレンス（リポジトリ）にインスパイアされています。MSD は Symphony をベンダリングまたはラッピングしません。オーケストレーションの概念は MSD がすでに公開しているプリミティブにきれいにマッピングされます；このガイドはグルーコードを書いたり MSD の安全ゲートを回避したりせずにパターンを採用できるようにマッピングを説明するだけです。

なぜこれが存在するか

MSD にはイシュー駆動 AI 開発のビルディングブロックがあります——/msd-workspace --new、/msd-manager、/msd-autonomous、/msd-verify-work、/msd-review、/msd-ship、さらに STATE.md とフェーズアーティファクトスイート——しかし、カスタムオーケストレーションスクリプトを書かずに単一のトラッカーイシューから端から端まで動かす方法を説明するガイドがありませんでした。そのガイドなしでは失敗モードは：

過少使用：開発者が discuss/plan/execute を手動で実行し、作業パターンが合致しているときでも /msd-manager や /msd-autonomous に手を出さない。
回避策スクリプト：開発者がトラッカーと claude 呼び出しの間にアドホックなシェルループを配線し、STATE.md、フェーズマニフェスト、検証ゲートを迂回する。

このガイドは正規ループを発見しやすくします。

概念マッピング

各行は Symphony スタイルのオーケストレーション概念を、それをすでに提供する MSD プリミティブにマッピングします。Symphony のドキュメント、ブログ投稿、サードパーティのオーケストレーション記事を読む際の変換キーとしてこのテーブルを使ってください。

Symphony の概念	MSD プリミティブ
`WORKFLOW.md`（トップレベルの意図）	`ROADMAP.md`（プロジェクトの意図）、`STATE.md`（ライブステータス）、フェーズ `CONTEXT.md`（フェーズごとのスコープ）、フェーズ `PLAN.md`（実行可能なステップ）
タスクごとの分離されたエージェントワークスペース	`/msd-workspace --new --strategy worktree`
エージェントのディスパッチと並列性	`/msd-manager`（インタラクティブダッシュボード）、`/msd-autonomous`（非同期）
フェーズごとの計画と議論ステップ	`/msd-discuss-phase` → `/msd-plan-phase` → `/msd-execute-phase`
作業の証明 / テスト証拠	`/msd-verify-work`（`/clear` をまたいで永続する UAT.md）
対立的レビュー	`/msd-review`（計画のクロス AI ピアレビュー）
ヒューマンマージゲート	`/msd-ship`（PR を作成し、オプションのコードレビュー、マージ準備）
フォローアップキャプチャ	`/msd-capture`、`/msd-capture --seed`、`/msd-new-milestone`、または手動で開いたトラッカーイシュー
並列性制御	マネージャー / バックグラウンドエージェントのセマンティクス（常時オンのポーラーなし）

このマッピングは一方向です：MSD が安全ゲート（検証、ヒューマンレビュー、フォローアップ作成の明示的確認）を所有します。Symphony の「継続的オーケストレーション」フレーミングは意図的に採用していません——非目標を参照してください。

エンドツーエンドフロー

単一のトラッカーイシューから端から端まで実行できるように書かれた、正規のイシュー → PR ループ。実行前に括弧内のプレースホルダーを置き換えてください。

トラッカーイシューを選ぶ。 トラッカー（GitHub、Linear など）から、自律的な実装に十分な範囲があるイシューを一つ選びます——境界が明確なスコープ、観察可能な受け入れ基準、実行をブロックする上流の依存関係なし。
MSD フェーズにマッピングする。 イシューが ROADMAP.md の既存フェーズにマッピングされる場合はそれを選択します。そうでない場合は、関連イシューの新しいマイルストーンのために /msd-new-milestone を実行するか、/msd-phase / /msd-phase --insert でフェーズを開きます。フェーズの CONTEXT.md にトラッカーイシューの URL を記録し、圧縮後もトレーサビリティが維持されるようにします。
分離されたワークスペースを作成する。 /msd-workspace --new --strategy worktree <slug> を実行して、独立した .planning/ ディレクトリを持つ git ワークツリーを立ち上げます。ワークツリーは安全境界です：探索、部分的なコミット、中断された計画はすべて main の外に留まります。
MSD を通じて discuss → plan → execute を実行する。 ワークスペース内から、/msd-discuss-phase で曖昧さを明確にし、/msd-plan-phase で PLAN.md を生成し、/msd-manager（インタラクティブダッシュボード）または /msd-execute-phase / /msd-autonomous（非同期）で実装します。MSD の外から生の claude 呼び出しを直接動かすことは避けてください——それは STATE.md の更新とフェーズマニフェストを迂回します。
作業の証明を要求する。 /msd-verify-work を実行して、フェーズの受け入れ基準に対して UAT をユーザーに案内します。テスト、スクリーンショット、ログキャプチャ、設定差分はすべて UAT.md に記録され、/clear をまたいで永続し、検証でミスしたスコープが発見されたときに /msd-plan-phase --gaps にフィードされます。
レビューと出荷ゲートを通過する。 /msd-review を実行して独立した AI CLI からの対立的ピアレビューを受け（モデルごとのブラインドスポットをキャッチ）、次に /msd-ship で計画アーティファクトから組み立てたリッチなボディ付きで PR を開きます。どちらのゲートもリモートに何かが届く前に人間の決定を必要とします。
フォローアップ作業を明示的にキャプチャする。 インラインメモには /msd-capture を、将来のフェーズの価値があるアイデアには /msd-capture --seed を、一貫したフォローアップグループには /msd-new-milestone を使います。発見されたフォローアップからトラッカーイシューを作成するには、明示的なユーザー確認が必要です——MSD はリモートトラッカーに自動投稿しません。

PR がマージされると、ループが閉じます。PR ボディのオートクローズキーワード（Closes #NNN / Fixes #NNN）がマージ時にトラッカーイシューを閉じます。

安全境界

このループが安全なのは、4 つの不変条件が設計上成立するからです：

分離されたワークツリー。 すべてのイシューが /msd-workspace --new ワークツリーで実行されるため、部分的な作業、中断された計画、探索的なコミットは main に触れません。msd-local-patches/ は、ワークツリーの手動編集をアップデートをまたいで持ち戻す必要がある場合の回復面です。
明示的な人間によるレビュー。 /msd-review と /msd-ship はどちらも人間の承認で停止します。オートマージはなく、実行からの自動 PR パスもありません。特定のリポジトリで人間ゲートを削除したい場合は、それはブランチ保護 / マージキューポリシーの決定であり、MSD があなたに代わってオプトインするものではありません。
自動公開投稿なし。 MSD は明示的なユーザー起動コマンドなしにトラッカーイシューを開いたり、コメントしたり、閉じたりしません。フォローアップキャプチャはデフォルトでローカルアーティファクト（メモ、シード、マイルストーン）になります；トラッカーに押し戻すことは別の手動ステップです。
出荷前の検証。 /msd-verify-work の UAT.md は /msd-ship が実行される前に証拠を記録しなければなりません。推奨される規律は、実装が正しく見えるときでも verification_failed をブロッカーとして扱うことです——失敗は通常フラキーなテストではなく、ミスした受け入れ基準を表面化します。

これらの不変条件のいずれかが迂回された場合（例：ワークツリーに直接 claude を実行する、/msd-verify-work をスキップする、またはユーザー確認なしにトラッカー API を通じてイシュー作成をスクリプト化する）、このガイドの保証は適用されません。

非目標

このガイドは意図的に以下のいずれも提案しません。将来のコントリビューターがコードレビューで再論争しないように、ここにリストされています：

Symphony コードのベンダリングまたはコピーなし。 MSD は独自のプリミティブを再利用します。上記のマッピングは概念的です；Symphony 由来のソースはこのリポジトリに同梱されません。
常時実行デーモンなし。 MSD は GitHub や Linear をポーリングしません。マネージャーと自律ワークフローは、デーモンではなくバックグラウンドエージェントのセマンティクスを通じて並列性を処理します。
必須のトラッカー依存関係なし。 このループはトラッカー統合なしで機能します。「トラッカーイシュー」ステップは 人間の入力 です——URL は CONTEXT.md に入ります。MSD はあなたが使用するトラッカーについても、トラッカーを使用するかどうかについても意見を持ちません。
検証、レビュー、または人間の決定ゲートの迂回なし。 /msd-autonomous を実行する場合でも、検証とレビューゲートは依然として発火します。「自律的」ラベルはフェーズからフェーズへの進行を指し、人間の承認をスキップすることではありません。
デフォルトのスキル / コマンド面の拡張なし。 このガイドで参照するすべてのコマンドはすでに存在します。このガイドはドキュメント面であり、機能面ではありません。

将来のフォローアップの可能性

このループでのメンテナーの経験がそれを正当化するなら、別の承認済み拡張として後で 最小限の トラッカーブリッジを追加できます：

一つの GitHub または Linear イシューを MSD ワークスペース / フェーズにインポートする。
UAT.md 証拠をソースイシューのコメントとしてエクスポートする。
/msd-capture --seed の出力からフォローアップトラッカーイシューを生成する。

これらはそれぞれ統合面と継続的なメンテナンス負担を追加するため、それぞれ独自の拡張提案になります。このガイドのスコープ外です。

フェーズループ — discuss → plan → execute → verify → ship が繰り返すサイクルとしてどう組み合わさるか。
ワークスペース how-to — 並列ワークツリーの作成と管理のステップバイステップガイド。
ドキュメント索引 — MSD Core ドキュメントの完全な目次。
docs/USER-GUIDE.md — 上で参照した個々のコマンドのタスク指向のウォークスルー。
docs/COMMANDS.md — /msd-* コマンドの完全なリファレンス。
docs/FEATURES.md — 機能レベルの能力マトリクス（ワークスペース、マネージャー、自律、検証、レビュー、出荷）。
docs/ARCHITECTURE.md — フェーズアーティファクトのライフサイクルと STATE.md の仕組み。

14 KiB Raw Permalink Blame History Unescape Escape