Removes kilo, kimi, kimi-code, copilot, windsurf, augment, trae, qwen, hermes, cline, codebuddy and pi end to end: capability descriptors, installer branches and converters (bin/install.js 14.9k -> 11.2k lines), TypeScript converters, hook surfaces and runtime homes, review lanes qwen/kimi-code, the two pi migrations, Kimi payload normalization in the hook guards, dead hostBehaviors vocabulary, launcher home probes, fixtures, runtime-specific tests and the prose that presented them as supported. Installer output for the six kept runtimes is byte-identical to before the prune. The Kimi tool-vocabulary tests in workflow-guard, read-guard and read-injection-scanner are left in place pending a decision.
498 lines
67 KiB
Markdown
498 lines
67 KiB
Markdown
# MSD 出荷済みサーフェスインベントリ
|
||
|
||
> 出荷済みのすべての MSD サーフェスの正式な一覧: コマンド、エージェント、ワークフロー、リファレンス、CLI モジュール、フック。広範なドキュメント(AGENTS.md、COMMANDS.md、ARCHITECTURE.md、CLI-TOOLS.md)とファイルシステムが乖離している場合は、このファイルとリポジトリツリー自体を正式なソースとして扱ってください。
|
||
|
||
## このファイルの使い方
|
||
|
||
- ここに記載された数値は v1.36.0 時点のファイルシステムから導出されており、リリース間で変動する可能性があります。最新の数値を確認するには、チェックアウトに対して `ls commands/msd/*.md | wc -l`、`ls agents/msd-*.md | wc -l` などを実行してください。
|
||
- このファイルは出荷済みのすべてのサーフェスを 6 つのファミリー(エージェント、コマンド、ワークフロー、リファレンス、CLI モジュール、フック)にわたって列挙します。広範なドキュメントはナラティブや厳選されたサブセットを提示する場合があります。ファイルシステムと異なる場合は、このファイルとディレクトリ一覧が正式です。
|
||
- v1.36.0 以降に追加された新しいサーフェスはまずここに記載し、その後広範なドキュメントに伝播させてください。`tests/inventory-manifest-sync.test.cjs` のドリフト管理テストが、ファイルシステムに対してロスター内容を固定します。
|
||
|
||
これは出荷済みのすべての MSD Core サーフェスの正式な一覧です。トピック別のナビゲーションは [docs インデックス](README.md) を参照してください。
|
||
|
||
---
|
||
|
||
## エージェント (33 shipped)
|
||
|
||
完全な一覧は `agents/msd-*.md` を参照してください。"Primary doc" 列は [`docs/AGENTS.md`](../AGENTS.md) が完全なロールカードを掲載している場合(*primary*)、"Advanced and Specialized Agents" セクションに短いスタブがある場合(*advanced stub*)、または掲載がない場合(*inventory only*)を示します。
|
||
|
||
| エージェント | 役割(一行) | 起動元 | Primary doc |
|
||
|--------------|-------------|--------|-------------|
|
||
| msd-project-researcher | ロードマップ作成前にドメインエコシステムを調査(スタック、機能、アーキテクチャ、落とし穴)。 | `/msd-new-project`, `/msd-new-milestone` | primary |
|
||
| msd-phase-researcher | 計画前に特定フェーズの実装アプローチを調査。 | `/msd-plan-phase` | primary |
|
||
| msd-ui-researcher | フロントエンドフェーズ向けの UI デザインコントラクトを作成。 | `/msd-ui-phase` | primary |
|
||
| msd-assumptions-analyzer | discuss-phase(仮定モード)向けに証拠に基づく仮定を作成。 | `discuss-phase-assumptions` workflow | primary |
|
||
| msd-advisor-researcher | discuss-phase アドバイザーモード中に単一のグレーゾーン決定を調査。 | `discuss-phase` workflow (advisor mode) | primary |
|
||
| msd-research-synthesizer | 並列調査エージェントの出力を統合した SUMMARY.md にまとめる。 | `/msd-new-project` | primary |
|
||
| msd-planner | タスク分解とゴール後退型検証を含む実行可能なフェーズプランを作成。 | `/msd-plan-phase`, `/msd-quick` | primary |
|
||
| msd-roadmapper | フェーズ分解と要件マッピングを含むプロジェクトロードマップを作成。 | `/msd-new-project` | primary |
|
||
| msd-executor | アトミックコミットと逸脱処理を伴って MSD プランを実行。 | `/msd-execute-phase`, `/msd-quick` | primary |
|
||
| msd-plan-checker | プランがフェーズ目標を達成できるか検証(8 つの検証ディメンション)。 | `/msd-plan-phase` (verification loop) | primary |
|
||
| msd-integration-checker | クロスフェーズ統合とエンドツーエンドフローを検証。 | `/msd-audit-milestone` | primary |
|
||
| msd-ui-checker | UI-SPEC.md デザインコントラクトを品質ディメンションに対して検証。 | `/msd-ui-phase` (validation loop) | primary |
|
||
| msd-verifier | ゴール後退型分析によってフェーズ目標の達成を検証。 | `/msd-execute-phase` | primary |
|
||
| msd-nyquist-auditor | テストを生成して Nyquist バリデーションのギャップを埋める。 | `/msd-validate-phase` | primary |
|
||
| msd-ui-auditor | 実装済みフロントエンドコードの 6 本柱ビジュアル監査を遡及的に実施。 | `/msd-ui-review` | primary |
|
||
| msd-codebase-mapper | コードベースを探索して構造化分析ドキュメントを作成。 | `/msd-map-codebase` | primary |
|
||
| msd-debugger | 永続的な状態を持つ科学的手法でバグを調査。 | `/msd-debug`, `/msd-verify-work` | primary |
|
||
| msd-user-profiler | 8 つのディメンションで開発者の行動をスコアリング。 | `/msd-profile-user` | primary |
|
||
| msd-doc-writer | プロジェクトドキュメントを作成・更新。 | `/msd-docs-update` | primary |
|
||
| msd-doc-verifier | 生成されたドキュメントの事実に基づくクレームを検証。 | `/msd-docs-update` | primary |
|
||
| msd-security-auditor | PLAN.md の脅威モデルから脅威への対策を検証。 | `/msd-secure-phase` | primary |
|
||
| msd-pattern-mapper | 新しいファイルを最も近い既存の類似物にマッピングし、プランナー向けの PATTERNS.md を作成。 | `/msd-plan-phase` (between research and planning) | advanced stub |
|
||
| msd-debug-session-manager | メインコンテキストをスリムに保つために、完全な `/msd-debug` チェックポイントと継続ループを独立したコンテキストで実行。 | `/msd-debug` | advanced stub |
|
||
| msd-code-reviewer | バグ、セキュリティ問題、コード品質の問題についてソースファイルをレビューし、REVIEW.md を作成。 | `/msd-code-review` | advanced stub |
|
||
| msd-code-fixer | アトミックな修正コミットで REVIEW.md の指摘を適用し、REVIEW-FIX.md を作成。 | `/msd-code-review --fix` | advanced stub |
|
||
| msd-ai-researcher | 選択した AI フレームワークの公式ドキュメントを実装準備済みのガイダンス(AI-SPEC.md §3–§4b)に調査。 | `/msd-ai-integration-phase` | advanced stub |
|
||
| msd-domain-researcher | AI システムのドメイン専門家による評価基準と失敗モードを浮き上がらせる(AI-SPEC.md §1b)。 | `/msd-ai-integration-phase` | advanced stub |
|
||
| msd-eval-planner | AI フェーズの構造化された評価戦略を設計(AI-SPEC.md §5–§7)。 | `/msd-ai-integration-phase` | advanced stub |
|
||
| msd-eval-auditor | AI フェーズの評価カバレッジを遡及監査し、EVAL-REVIEW.md(COVERED/PARTIAL/MISSING)を作成。 | `/msd-eval-review` | advanced stub |
|
||
| msd-framework-selector | AI/LLM フレームワークをスコアリングして推奨する 6 問以内のインタラクティブな決定マトリクス。 | `/msd-ai-integration-phase` | advanced stub |
|
||
| msd-intel-updater | クエリ可能なコードベースナレッジベースとして使用される構造化インテルファイル(`.planning/intel/*.json`)を作成。 | `/msd-map-codebase --query` | advanced stub |
|
||
| msd-doc-classifier | 単一の計画ドキュメントを ADR、PRD、SPEC、DOC、UNKNOWN に分類し、ドキュメントコーパスを並列処理するために生成。 | `/msd-ingest-docs` | advanced stub |
|
||
| msd-doc-synthesizer | 分類された計画ドキュメントを優先規則、サイクル検出、3 バケット競合レポートで単一の統合コンテキストに合成。 | `/msd-ingest-docs` | advanced stub |
|
||
|
||
**カバレッジ注記。** `docs/AGENTS.md` は 21 のプライマリエージェントに完全なロールカードを、12 の上級エージェントに簡潔なスタブを提供します。同ファイルのエージェントツール権限サマリーはプライマリ 21 エージェントのみをカバーします。上級エージェントのツール一覧は `agents/msd-*.md` の各エージェントフロントマターに記載されています。
|
||
|
||
---
|
||
|
||
## コマンド (67 shipped)
|
||
|
||
完全な一覧は `commands/msd/*.md` を参照してください。以下のグループ分けは `docs/COMMANDS.md` のセクション順に対応しています。各行にはコマンド名、コマンドのフロントマター `description:` から導出された一行の役割、ソースファイルへのリンクが含まれます。`tests/command-count-sync.test.cjs` がこの数値をファイルシステムに対して固定します。
|
||
|
||
### 名前空間メタスキル
|
||
|
||
これら 6 つのルーターは記述子専用のエントリーで、モデルが最初に選択します。各エントリーの本体には正しい具体的なサブスキルを指すルーティングテーブルが含まれています。積極的なスキル列挙のトークンコストを低く抑えながら、完全なサーフェスに到達可能にするために存在します。根拠は [#2792](https://github.com/open-gsd/gsd-core/issues/2792) を参照してください。ルーティングテーブルは [#2790](https://github.com/open-gsd/gsd-core/issues/2790) 以降の統合サーフェスを対象とします。
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-workflow` | フェーズパイプラインルーター — discuss / plan / execute / verify / phase / progress。 | [commands/msd/ns-workflow.md](../../commands/msd/ns-workflow.md) |
|
||
| `/msd-project` | プロジェクトライフサイクルルーター — マイルストーン、監査、サマリー。 | [commands/msd/ns-project.md](../../commands/msd/ns-project.md) |
|
||
| `/msd-quality` | 品質ゲートルーター — コードレビュー、デバッグ、監査、セキュリティ、eval、UI。 | [commands/msd/ns-review.md](../../commands/msd/ns-review.md) |
|
||
| `/msd-context` | コードベースインテリジェンスルーター — map、graphify、docs、learnings。 | [commands/msd/ns-context.md](../../commands/msd/ns-context.md) |
|
||
| `/msd-manage` | 管理ルーター — config、workspace、workstreams、thread、update、ship、inbox。 | [commands/msd/ns-manage.md](../../commands/msd/ns-manage.md) |
|
||
| `/msd-ideate` | 探索・キャプチャルーター — explore、sketch、spike、spec、capture。 | [commands/msd/ns-ideate.md](../../commands/msd/ns-ideate.md) |
|
||
|
||
### コアワークフロー
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-new-project` | 深いコンテキスト収集と PROJECT.md で新しいプロジェクトを初期化。 | [commands/msd/new-project.md](../../commands/msd/new-project.md) |
|
||
| `/msd-onboard` | 既存コードベースをマッピング、ドキュメント取り込み、プロジェクト設定、onboarding summary へ案内。 | [commands/msd/onboard.md](../../commands/msd/onboard.md) |
|
||
| `/msd-workspace` | MSD ワークスペースを管理 — 独立したワークスペース環境を作成(`--new`)、一覧表示(`--list`)、削除(`--remove`)。 | [commands/msd/workspace.md](../../commands/msd/workspace.md) |
|
||
| `/msd-discuss-phase` | 計画前にアダプティブな質問でフェーズコンテキストを収集。 | [commands/msd/discuss-phase.md](../../commands/msd/discuss-phase.md) |
|
||
| `/msd-mvp-phase` | フェーズを垂直 MVP スライスとして計画 — ユーザーストーリー、SPIDR 分割、その後 plan-phase。 | [commands/msd/mvp-phase.md](../../commands/msd/mvp-phase.md) |
|
||
| `/msd-spec-phase` | 反証可能な要件を持つ SPEC.md を生成するソクラテス的仕様精緻化。 | [commands/msd/spec-phase.md](../../commands/msd/spec-phase.md) |
|
||
| `/msd-ui-phase` | フロントエンドフェーズ向けの UI デザインコントラクト(UI-SPEC.md)を生成。 | [commands/msd/ui-phase.md](../../commands/msd/ui-phase.md) |
|
||
| `/msd-ai-integration-phase` | フレームワーク選択、調査、eval 計画を経て AI デザインコントラクト(AI-SPEC.md)を生成。 | [commands/msd/ai-integration-phase.md](../../commands/msd/ai-integration-phase.md) |
|
||
| `/msd-plan-phase` | 検証ループ付きの詳細なフェーズプラン(PLAN.md)を作成。 | [commands/msd/plan-phase.md](../../commands/msd/plan-phase.md) |
|
||
| `/msd-plan-review-convergence` | クロス AI プラン収束ループ — HIGH の懸念がなくなるまでレビューフィードバックで再計画(最大 3 サイクル)。 | [commands/msd/plan-review-convergence.md](../../commands/msd/plan-review-convergence.md) |
|
||
| `/msd-ultraplan-phase` | [BETA] フェーズ計画を Claude Code の ultraplan クラウドにオフロード — リモートで下書きし、ブラウザでレビューし、`/msd-import` 経由でインポート。Claude Code のみ。 | [commands/msd/ultraplan-phase.md](../../commands/msd/ultraplan-phase.md) |
|
||
| `/msd-spike` | 使い捨ての実験でアイデアを素早くスパイク。`--wrap-up` で調査結果を永続的なスキルとしてパッケージ化。 | [commands/msd/spike.md](../../commands/msd/spike.md) |
|
||
| `/msd-sketch` | 使い捨ての HTML モックアップで UI/デザインアイデアを素早くスケッチ。`--wrap-up` で調査結果をパッケージ化。 | [commands/msd/sketch.md](../../commands/msd/sketch.md) |
|
||
| `/msd-execute-phase` | ウェーブベースの並列化でフェーズのすべてのプランを実行。 | [commands/msd/execute-phase.md](../../commands/msd/execute-phase.md) |
|
||
| `/msd-verify-work` | 自動診断付きの会話型 UAT で構築した機能を検証。 | [commands/msd/verify-work.md](../../commands/msd/verify-work.md) |
|
||
| `/msd-ship` | 検証後に PR を作成し、レビューを実行してマージ準備を行う。 | [commands/msd/ship.md](../../commands/msd/ship.md) |
|
||
| `/msd-fast` | サブエージェントや計画オーバーヘッドなしに些細なタスクをインラインで実行。 | [commands/msd/fast.md](../../commands/msd/fast.md) |
|
||
| `/msd-quick` | MSD の保証(アトミックコミット、状態追跡)付きでクイックタスクを実行し、オプションのエージェントをスキップ。 | [commands/msd/quick.md](../../commands/msd/quick.md) |
|
||
| `/msd-ui-review` | 実装済みフロントエンドコードの 6 本柱ビジュアル監査を遡及的に実施。 | [commands/msd/ui-review.md](../../commands/msd/ui-review.md) |
|
||
| `/msd-code-review` | フェーズ中に変更されたソースファイルをバグ、セキュリティ、コード品質の問題についてレビュー。`--fix` で指摘を自動適用。 | [commands/msd/code-review.md](../../commands/msd/code-review.md) |
|
||
| `/msd-eval-review` | 実行済み AI フェーズの評価カバレッジを遡及監査し、EVAL-REVIEW.md を作成。 | [commands/msd/eval-review.md](../../commands/msd/eval-review.md) |
|
||
|
||
### フェーズ & マイルストーン管理
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-phase` | フェーズの CRUD — ROADMAP.md でフェーズを追加(デフォルト)、挿入(`--insert`)、削除(`--remove`)、編集(`--edit`)。 | [commands/msd/phase.md](../../commands/msd/phase.md) |
|
||
| `/msd-add-tests` | UAT 基準と実装に基づいて完了したフェーズのテストを生成。 | [commands/msd/add-tests.md](../../commands/msd/add-tests.md) |
|
||
| `/msd-validate-phase` | 完了したフェーズの Nyquist バリデーションのギャップを遡及監査して埋める。 | [commands/msd/validate-phase.md](../../commands/msd/validate-phase.md) |
|
||
| `/msd-secure-phase` | 完了したフェーズの脅威への対策を遡及検証。 | [commands/msd/secure-phase.md](../../commands/msd/secure-phase.md) |
|
||
| `/msd-audit-milestone` | アーカイブ前に元の意図に対してマイルストーン完了を監査。 | [commands/msd/audit-milestone.md](../../commands/msd/audit-milestone.md) |
|
||
| `/msd-audit-uat` | 全未解決 UAT および検証項目のクロスフェーズ監査。 | [commands/msd/audit-uat.md](../../commands/msd/audit-uat.md) |
|
||
| `/msd-audit-fix` | 自律監査-修正パイプライン — 問題の発見、分類、修正、テスト、コミット。 | [commands/msd/audit-fix.md](../../commands/msd/audit-fix.md) |
|
||
| `/msd-complete-milestone` | 完了したマイルストーンをアーカイブし、次のバージョンに向けて準備。 | [commands/msd/complete-milestone.md](../../commands/msd/complete-milestone.md) |
|
||
| `/msd-new-milestone` | 新しいマイルストーンサイクルを開始 — PROJECT.md を更新して要件にルーティング。 | [commands/msd/new-milestone.md](../../commands/msd/new-milestone.md) |
|
||
| `/msd-milestone-summary` | マイルストーンアーティファクトから包括的なプロジェクトサマリーを生成。 | [commands/msd/milestone-summary.md](../../commands/msd/milestone-summary.md) |
|
||
| `/msd-cleanup` | 完了したマイルストーンから蓄積されたフェーズディレクトリをアーカイブ。 | [commands/msd/cleanup.md](../../commands/msd/cleanup.md) |
|
||
| `/msd-manager` | 1 つのターミナルから複数のフェーズを管理するインタラクティブなコマンドセンター。 | [commands/msd/manager.md](../../commands/msd/manager.md) |
|
||
| `/msd-workstreams` | 並列ワークストリームを管理 — list、create、switch、status、progress、complete、resume。 | [commands/msd/workstreams.md](../../commands/msd/workstreams.md) |
|
||
| `/msd-autonomous` | 残りのすべてのフェーズを自律的に実行 — フェーズごとに discuss → plan → execute。 | [commands/msd/autonomous.md](../../commands/msd/autonomous.md) |
|
||
| `/msd-undo` | 安全な git リバート — フェーズマニフェストを使ってフェーズまたはプランのコミットをロールバック。 | [commands/msd/undo.md](../../commands/msd/undo.md) |
|
||
|
||
### セッション & ナビゲーション
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-progress` | プロジェクトの進捗を確認し、コンテキストを表示して次のアクションにルーティング。`--next` で自動進行、`--do` で自由形式タスクを実行。 | [commands/msd/progress.md](../../commands/msd/progress.md) |
|
||
| `/msd-capture` | アイデア、タスク、メモ、シードをキャプチャ — todo(デフォルト)、`--note`、`--backlog`、`--seed`、または `--list` で保留中の TODO を一覧表示。 | [commands/msd/capture.md](../../commands/msd/capture.md) |
|
||
| `/msd-stats` | プロジェクト統計を表示 — フェーズ、プラン、要件、git メトリクス、タイムライン。 | [commands/msd/stats.md](../../commands/msd/stats.md) |
|
||
| `/msd-pause-work` | フェーズ途中で作業を一時停止する際にコンテキスト引き継ぎを作成。 | [commands/msd/pause-work.md](../../commands/msd/pause-work.md) |
|
||
| `/msd-resume-work` | 完全なコンテキスト復元で前のセッションから作業を再開。 | [commands/msd/resume-work.md](../../commands/msd/resume-work.md) |
|
||
| `/msd-explore` | コミットする前にアイデアを考え抜くためのソクラテス的アイデア創出とアイデアルーティング。 | [commands/msd/explore.md](../../commands/msd/explore.md) |
|
||
| `/msd-review-backlog` | バックログアイテムをレビューしてアクティブなマイルストーンに昇格。 | [commands/msd/review-backlog.md](../../commands/msd/review-backlog.md) |
|
||
| `/msd-thread` | クロスセッション作業のための永続的なコンテキストスレッドを管理。 | [commands/msd/thread.md](../../commands/msd/thread.md) |
|
||
|
||
### コードベースインテリジェンス
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-map-codebase` | 並列マッパーエージェントでコードベースを分析。`--fast` で軽量スキャン、`--query` でインテルクエリ。 | [commands/msd/map-codebase.md](../../commands/msd/map-codebase.md) |
|
||
| `/msd-graphify` | `.planning/graphs/` 内のプロジェクトナレッジグラフをビルド、クエリ、検査。 | [commands/msd/graphify.md](../../commands/msd/graphify.md) |
|
||
| `/msd-extract-learnings` | 完了したフェーズのアーティファクトから決定事項、教訓、パターン、驚きを抽出。 | [commands/msd/extract-learnings.md](../../commands/msd/extract-learnings.md) |
|
||
|
||
### レビュー、デバッグ & リカバリー
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-review` | 外部 AI CLI からフェーズプランのクロス AI ピアレビューをリクエスト。 | [commands/msd/review.md](../../commands/msd/review.md) |
|
||
| `/msd-debug` | コンテキストリセット全体で永続的な状態を持つ体系的なデバッグ。 | [commands/msd/debug.md](../../commands/msd/debug.md) |
|
||
| `/msd-forensics` | 失敗した MSD ワークフローのポストモーテム調査 — git、アーティファクト、状態を分析。 | [commands/msd/forensics.md](../../commands/msd/forensics.md) |
|
||
| `/msd-health` | 計画ディレクトリの健全性を診断し、任意で問題を修復。 | [commands/msd/health.md](../../commands/msd/health.md) |
|
||
| `/msd-import` | プロジェクト決定に対する競合検出付きで外部プランをインジェスト。 | [commands/msd/import.md](../../commands/msd/import.md) |
|
||
| `/msd-inbox` | プロジェクトテンプレートに対してすべてのオープンな GitHub イシューと PR をトリアージおよびレビュー。 | [commands/msd/inbox.md](../../commands/msd/inbox.md) |
|
||
|
||
### ドキュメント、プロファイル & ユーティリティ
|
||
|
||
| コマンド | 役割 | ソース |
|
||
|----------|------|--------|
|
||
| `/msd-docs-update` | コードベースに対して検証されたプロジェクトドキュメントを生成または更新。 | [commands/msd/docs-update.md](../../commands/msd/docs-update.md) |
|
||
| `/msd-ingest-docs` | リポジトリで混在した ADR/PRD/SPEC/DOC をスキャンし、分類・合成・競合レポートで `.planning/` セットアップをブートストラップまたはマージ。 | [commands/msd/ingest-docs.md](../../commands/msd/ingest-docs.md) |
|
||
| `/msd-profile-user` | 開発者の行動プロファイルと Claude が検出可能なアーティファクトを生成。 | [commands/msd/profile-user.md](../../commands/msd/profile-user.md) |
|
||
| `/msd-settings` | MSD ワークフロートグルとモデルプロファイルを設定。 | [commands/msd/settings.md](../../commands/msd/settings.md) |
|
||
| `/msd-config` | MSD 設定を構成 — ワークフロートグル(デフォルト)、高度なノブ(`--advanced`)、インテグレーション(`--integrations`)、またはモデルプロファイル(`--profile`)。 | [commands/msd/config.md](../../commands/msd/config.md) |
|
||
| `/msd-pr-branch` | `.planning/` コミットをフィルタリングしてクリーンな PR ブランチを作成。 | [commands/msd/pr-branch.md](../../commands/msd/pr-branch.md) |
|
||
| `/msd-surface` | サーフェスに出るスキルを切り替え — 再インストールなしでプロファイルを適用、一覧表示、またはクラスターを無効化。 | [commands/msd/surface.md](../../commands/msd/surface.md) |
|
||
| `/msd-update` | MSD を最新バージョンに更新。`--sync` でランタイム間でスキルを同期、`--reapply` でローカルパッチを再適用。 | [commands/msd/update.md](../../commands/msd/update.md) |
|
||
| `/msd-help` | 利用可能な MSD コマンドと使い方ガイドを表示。 | [commands/msd/help.md](../../commands/msd/help.md) |
|
||
|
||
---
|
||
|
||
## ワークフロー (88 shipped)
|
||
|
||
完全な一覧は `msd-core/workflows/*.md` を参照してください。ワークフローはコマンドが内部で参照する薄いオーケストレーターです。ほとんどはエンドユーザーが直接読むものではありません。以下の行は各ワークフローファイルをその役割(`<purpose>` ブロックから導出)と、該当する場合はそれを呼び出すコマンドにマッピングします。
|
||
|
||
| ワークフロー | 役割 | 呼び出し元 |
|
||
|-------------|------|-----------|
|
||
| `add-backlog.md` | 999.x 番号付けを使って ROADMAP.md にバックログアイテムを追加。 | `/msd-capture --backlog` |
|
||
| `add-phase.md` | ロードマップの現在のマイルストーン末尾に新しい整数フェーズを追加。 | `/msd-phase` (default) |
|
||
| `add-tests.md` | フェーズのアーティファクトに基づいて完了したフェーズのユニットテストと E2E テストを生成。 | `/msd-add-tests` |
|
||
| `add-todo.md` | セッション中に浮上したアイデアやタスクを構造化された todo としてキャプチャ。 | `/msd-capture` (default) |
|
||
| `ai-integration-phase.md` | フレームワーク選択 → AI 調査 → ドメイン調査 → eval 計画を AI-SPEC.md に統合してオーケストレーション。 | `/msd-ai-integration-phase` |
|
||
| `analyze-dependencies.md` | ROADMAP.md のフェーズをファイル重複とセマンティックな依存関係について分析し、`Depends on` エッジを提案。 | `/msd-manager --analyze-deps` |
|
||
| `audit-fix.md` | 自律監査-修正パイプライン — 監査実行、解析、分類、修正、テスト、コミット。 | `/msd-audit-fix` |
|
||
| `audit-milestone.md` | フェーズ検証を集約してマイルストーンが完了の定義を満たしているか検証。 | `/msd-audit-milestone` |
|
||
| `audit-uat.md` | UAT と検証ファイルのクロスフェーズ監査。優先順位付けされた未解決項目リストを作成。 | `/msd-audit-uat` |
|
||
| `autonomous.md` | マイルストーンのフェーズを自律的に進行 — 残り全部、範囲指定、または単一フェーズ。 | `/msd-autonomous` |
|
||
| `check-todos.md` | 保留中の TODO を一覧表示し、選択を許可してコンテキストを読み込み、適切なアクションにルーティング。 | `/msd-capture --list` |
|
||
| `cleanup.md` | 完了したマイルストーンから蓄積されたフェーズディレクトリをアーカイブ。 | `/msd-cleanup` |
|
||
| `code-review-fix.md` | msd-code-fixer を使って REVIEW.md の問題を修正ごとのアトミックコミットで自動修正。 | `/msd-code-review --fix` |
|
||
| `code-review.md` | msd-code-reviewer でフェーズのソース変更をレビュー。REVIEW.md を作成。 | `/msd-code-review` |
|
||
| `complete-milestone.md` | 出荷されたバージョンを完了としてマーク — MILESTONES.md エントリー、PROJECT.md の進化、タグ。 | `/msd-complete-milestone` |
|
||
| `diagnose-issues.md` | 並列デバッグエージェントをオーケストレーションして UAT のギャップを調査し、根本原因を特定。 | `/msd-verify-work` (auto-diagnosis) |
|
||
| `discuss-phase-assumptions.md` | 仮定モードの discuss — コードベースファーストの分析で実装決定を抽出。 | `/msd-discuss-phase` (when `discuss_mode=assumptions`) |
|
||
| `discuss-phase-power.md` | パワーユーザー discuss — すべての質問を JSON 状態ファイル + HTML UI に事前生成。 | `/msd-discuss-phase --power` |
|
||
| `discuss-phase.md` | 反復的なグレーゾーンの議論を通じて実装決定を抽出。 | `/msd-discuss-phase` |
|
||
| `mvp-phase.md` | フェーズを垂直 MVP スライスとして計画 — ユーザーストーリー、SPIDR 分割、その後 plan-phase。 | `/msd-mvp-phase` |
|
||
| `do.md` | ユーザーからの自由形式テキストを最も適合する MSD コマンドにルーティング。 | `/msd-progress --do` |
|
||
| `docs-update.md` | 正規のおよび手書きのプロジェクトドキュメントを生成、更新、検証。 | `/msd-docs-update` |
|
||
| `edit-phase.md` | ROADMAP.md の既存フェーズの任意フィールドを番号と位置を保ちながら編集。 | `/msd-phase --edit` |
|
||
| `eval-review.md` | 実装済み AI フェーズの評価カバレッジの遡及監査。 | `/msd-eval-review` |
|
||
| `execute-phase.md` | ウェーブベースの並列実行でフェーズのすべてのプランを実行。 | `/msd-execute-phase` |
|
||
| `execute-plan.md` | フェーズプロンプト(PLAN.md)を実行して成果サマリー(SUMMARY.md)を作成。 | `execute-phase.md` (per-plan subagent) |
|
||
| `explore.md` | ソクラテス的アイデア創出 — 開発者を探索的な質問を通じてガイド。 | `/msd-explore` |
|
||
| `debug.md` | 体系的なデバッグ — サブコマンドルーティング、セッション作成、msd-debug-session-manager への委任。 | `/msd-debug` |
|
||
| `extract-learnings.md` | 完了したフェーズのアーティファクトから決定事項、教訓、パターン、驚きを抽出。 | `/msd-extract-learnings` |
|
||
| `fast.md` | サブエージェントのオーバーヘッドなしに些細なタスクをインラインで実行。 | `/msd-fast` |
|
||
| `forensics.md` | 失敗したワークフローのフォレンジクス調査 — git、アーティファクト、状態分析。 | `/msd-forensics` |
|
||
| `graduation.md` | フェーズ横断で繰り返し出現する LEARNINGS.md アイテムをクラスタリングして HITL 昇格候補を浮き上がらせる。 | `transition.md` (graduation_scan step) |
|
||
| `health.md` | `.planning/` ディレクトリの整合性を検証し、対処可能な問題を報告。 | `/msd-health` |
|
||
| `help.md` | 完全な MSD Core コマンドリファレンスを表示。 | `/msd-help` |
|
||
| `import.md` | 既存のプロジェクト決定に対する競合検出付きで外部プランをインジェスト。 | `/msd-import` |
|
||
| `inbox.md` | プロジェクトのコントリビューションテンプレートに対してオープンな GitHub イシューと PR をトリアージ。 | `/msd-inbox` |
|
||
| `ingest-docs.md` | リポジトリで混在した計画ドキュメントをスキャンし、分類・合成して `.planning/` に競合レポート付きでブートストラップまたはマージ。 | `/msd-ingest-docs` |
|
||
| `insert-phase.md` | マイルストーン途中で発見された緊急作業のために小数フェーズを挿入。 | `/msd-phase --insert` |
|
||
| `list-phase-assumptions.md` | 計画前にフェーズに関する Claude の仮定を浮き上がらせる。 | `/msd-discuss-phase --assumptions` |
|
||
| `list-workspaces.md` | `~/msd-workspaces/` 内のすべての MSD ワークスペースをステータスとともに一覧表示。 | `/msd-workspace --list` |
|
||
| `manager.md` | インタラクティブなマイルストーンコマンドセンター — ダッシュボード、インライン discuss、バックグラウンド plan/execute。 | `/msd-manager` |
|
||
| `map-codebase.md` | 並列コードベースマッパーエージェントをオーケストレーションして `.planning/codebase/` ドキュメントを作成。 | `/msd-map-codebase` |
|
||
| `milestone-summary.md` | マイルストーンサマリー合成 — マイルストーンアーティファクトからオンボーディングとレビューアーティファクトを作成。 | `/msd-milestone-summary` |
|
||
| `new-milestone.md` | 新しいマイルストーンサイクルを開始 — プロジェクトコンテキストを読み込み、目標を収集して PROJECT.md/STATE.md を更新。 | `/msd-new-milestone` |
|
||
| `new-project.md` | 統合新プロジェクトフロー — 質問、調査(任意)、要件、ロードマップ。 | `/msd-new-project` |
|
||
| `onboard.md` | Brownfield onboarding orchestration — コードベースをマップし、docs を取り込み、planning を初期化し、次のステップを要約。 | `/msd-onboard` |
|
||
| `new-workspace.md` | リポジトリのワークツリー/クローンと独立した `.planning/` を持つ独立したワークスペースを作成。 | `/msd-workspace --new` |
|
||
| `next.md` | 現在のプロジェクト状態を検出して次の論理的なステップに自動的に進む。 | `/msd-progress --next` |
|
||
| `node-repair.md` | タスク検証が失敗した場合の自律修復オペレーター。`execute-plan` から呼び出し。 | `execute-plan.md` (recovery) |
|
||
| `note.md` | ゼロフリクションのアイデアキャプチャ — 1 回の Write 呼び出しと 1 行の確認。 | `/msd-capture --note` |
|
||
| `pause-work.md` | 構造化された `.planning/HANDOFF.json` と `.continue-here.md` 引き継ぎファイルを作成。 | `/msd-pause-work` |
|
||
| `plan-phase.md` | 統合された調査と検証ループを含む実行可能な PLAN.md ファイルを作成。 | `/msd-plan-phase`, `/msd-quick` |
|
||
| `plan-review-convergence.md` | クロス AI プラン収束ループ — HIGH の懸念がなくなるまでレビューフィードバックで再計画。 | `/msd-plan-review-convergence` |
|
||
| `plant-seed.md` | 先見的なアイデアをトリガー条件付きの構造化されたシードファイルとしてキャプチャ。 | `/msd-capture --seed` |
|
||
| `pr-branch.md` | `.planning/` コミットをフィルタリングしてプルリクエスト用のクリーンなブランチを作成。 | `/msd-pr-branch` |
|
||
| `profile-user.md` | 完全な開発者プロファイリングフローをオーケストレーション — 同意、セッションスキャン、プロファイル生成。 | `/msd-profile-user` |
|
||
| `progress.md` | 進捗レンダリング — プロジェクトコンテキスト、位置、次のアクションルーティング。 | `/msd-progress` |
|
||
| `quick.md` | MSD の保証付きのクイックタスク実行(アトミックコミット、状態追跡)。 | `/msd-quick` |
|
||
| `reapply-patches.md` | MSD 更新後にローカルの変更を再適用。 | `/msd-update --reapply` |
|
||
| `remove-phase.md` | ロードマップから将来のフェーズを削除し、後続フェーズを振り直し。 | `/msd-phase --remove` |
|
||
| `remove-workspace.md` | MSD ワークスペースを削除してワークツリーをクリーンアップ。 | `/msd-workspace --remove` |
|
||
| `resume-project.md` | 作業を再開 — STATE.md、HANDOFF.json、アーティファクトから完全なコンテキストを復元。 | `/msd-resume-work` |
|
||
| `review.md` | 外部 CLI 経由のクロス AI プランレビュー。REVIEWS.md を作成。 | `/msd-review` |
|
||
| `scan.md` | 迅速な単一フォーカスのコードベーススキャン — map-codebase の軽量代替。 | `/msd-map-codebase --fast` |
|
||
| `secure-phase.md` | 完了したフェーズの遡及的な脅威対策監査。 | `/msd-secure-phase` |
|
||
| `session-report.md` | セッションレポート — トークン使用量、作業サマリー、成果。 | `/msd-pause-work --report` |
|
||
| `settings.md` | MSD ワークフロートグルとモデルプロファイルを設定。 | `/msd-settings`, `/msd-config --profile` |
|
||
| `settings-advanced.md` | MSD パワーユーザーノブを設定 — プランバウンス、タイムアウト、ブランチテンプレート、クロス AI 実行、ランタイムノブ。 | `/msd-config --advanced` |
|
||
| `settings-integrations.md` | サードパーティ API キー(Brave/Firecrawl/Exa)、`review.models.<cli>` CLI ルーティング、`agent_skills.<agent-type>` インジェクションをマスク済み(`****<last-4>`)表示で設定。 | `/msd-config --integrations` |
|
||
| `ship.md` | 検証後に PR を作成し、レビューを実行してマージ準備を行う。 | `/msd-ship` |
|
||
| `sketch.md` | 1 スケッチにつき 2〜3 バリアントの使い捨て HTML モックアップでデザインの方向性を探索。 | `/msd-sketch` |
|
||
| `sketch-wrap-up.md` | スケッチの調査結果を厳選して永続的な `sketch-findings-[project]` スキルとしてパッケージ化。 | `/msd-sketch --wrap-up` |
|
||
| `spec-phase.md` | 曖昧さスコアリング付きのソクラテス的仕様精緻化。SPEC.md を作成。 | `/msd-spec-phase` |
|
||
| `spike.md` | 集中した使い捨ての実験によって迅速に実現可能性を検証。 | `/msd-spike` |
|
||
| `spike-wrap-up.md` | スパイクの調査結果を厳選して永続的な `spike-findings-[project]` スキルとしてパッケージ化。 | `/msd-spike --wrap-up` |
|
||
| `stats.md` | プロジェクト統計レンダリング — フェーズ、プラン、要件、git メトリクス。 | `/msd-stats` |
|
||
| `sync-skills.md` | クロスランタイム MSD スキル同期 — ランタイムルート間で `msd-*` スキルディレクトリを差分して適用。 | `/msd-update --sync` |
|
||
| `transition.md` | フェーズ境界遷移ワークフロー — ワークストリームチェック、状態進行。 | `execute-phase.md`, `/msd-progress --next` |
|
||
| `ui-phase.md` | msd-ui-researcher で UI-SPEC.md デザインコントラクトを生成。 | `/msd-ui-phase` |
|
||
| `ui-review.md` | msd-ui-auditor による遡及的な 6 本柱ビジュアル監査。 | `/msd-ui-review` |
|
||
| `ultraplan-phase.md` | [BETA] 計画を Claude Code の ultraplan クラウドにオフロードし、リモートで下書きして `/msd-import` 経由でインポート。 | `/msd-ultraplan-phase` |
|
||
| `undo.md` | 安全な git リバート — フェーズマニフェストを使ってフェーズまたはプランのコミットをロールバック。 | `/msd-undo` |
|
||
| `thread.md` | クロスセッション作業のための永続的なコンテキストスレッドを作成、一覧表示、クローズ、または再開。 | `/msd-thread` |
|
||
| `update.md` | 変更履歴の表示付きで MSD を最新バージョンに更新。 | `/msd-update` |
|
||
| `validate-phase.md` | 完了したフェーズの Nyquist バリデーションのギャップを遡及監査して埋める。 | `/msd-validate-phase` |
|
||
| `verify-work.md` | 自動診断付きの会話型 UAT — UAT.md と修正プランを作成。 | `/msd-verify-work` |
|
||
|
||
> **注記:** 一部のワークフローには直接ユーザー向けのコマンドがありません(例: `execute-plan.md`、`transition.md`、`node-repair.md`、`diagnose-issues.md`)— これらはオーケストレーターワークフローによって内部的に呼び出されます。
|
||
|
||
---
|
||
|
||
## リファレンス (62 shipped)
|
||
|
||
完全な一覧は `msd-core/references/*.md` を参照してください。リファレンスはワークフローとエージェントが `@-reference` として参照する共有ナレッジドキュメントです。以下のグループ分けは [`docs/ARCHITECTURE.md`](../ARCHITECTURE.md#references-msd-corereferencesmd) に対応します — コア、ワークフロー、思考モデルクラスター、モジュラープランナー分解。
|
||
|
||
### コアリファレンス
|
||
|
||
| リファレンス | 役割 |
|
||
|-------------|------|
|
||
| `checkpoints.md` | チェックポイントタイプの定義とインタラクションパターン。 |
|
||
| `gates.md` | plan-checker と verifier に組み込まれた 4 つの標準ゲートタイプ(Confirm、Quality、Safety、Transition)。 |
|
||
| `model-profiles.md` | エージェントごとのモデルティア割り当て。 |
|
||
| `model-profile-resolution.md` | モデル解決アルゴリズムのドキュメント。 |
|
||
| `verification-patterns.md` | 異なるアーティファクトタイプの検証方法。 |
|
||
| `verification-overrides.md` | アーティファクトごとの検証オーバーライドルール。 |
|
||
| `verifier-phase-gates.md` | msd-verifier が eager import する検証時ゲート(廃止された verify-phase ワークフローから移行、#1892):デシジョンカバレッジ検証(#2492)、テスト品質監査、インフラストラクチャフェーズの human-verification スコープ(#2504)。 |
|
||
| `planning-config.md` | 完全な設定スキーマと動作。 |
|
||
| `git-integration.md` | git コミット、ブランチ、履歴パターン。 |
|
||
| `git-planning-commit.md` | 計画ディレクトリのコミット規約。 |
|
||
| `questioning.md` | プロジェクト初期化のためのドリーム抽出哲学。 |
|
||
| `tdd.md` | テスト駆動開発の統合パターン。 |
|
||
| `ui-brand.md` | ビジュアル出力フォーマットパターン。 |
|
||
| `common-bug-patterns.md` | コードレビューと検証のための一般的なバグパターン。 |
|
||
| `debugger-philosophy.md` | `msd-debugger` が読み込む常緑のデバッグ規律。 |
|
||
| `mandatory-initial-read.md` | エージェントプロンプトに注入される共有の必読ボイラープレート。 |
|
||
| `project-skills-discovery.md` | エージェントプロンプトに注入される共有のプロジェクトスキル検出ボイラープレート。 |
|
||
|
||
### ワークフローリファレンス
|
||
|
||
| リファレンス | 役割 |
|
||
|-------------|------|
|
||
| `agent-contracts.md` | オーケストレーターとエージェント間の正式なインターフェース。 |
|
||
| `context-budget.md` | コンテキストウィンドウバジェット割り当てルール。 |
|
||
| `continuation-format.md` | セッション継続/再開フォーマット。 |
|
||
| `domain-probes.md` | discuss-phase 向けのドメイン固有のプロービング質問。 |
|
||
| `gate-prompts.md` | ゲート/チェックポイントのプロンプトテンプレート。 |
|
||
| `scout-codebase.md` | discuss-phase スカウトステップ向けのフェーズタイプ→コードベースマップ選択テーブル(discuss-phase/modes プログレッシブディスクロージャー分割により抽出、#717)。 |
|
||
| `revision-loop.md` | プラン修正の反復パターン。 |
|
||
| `universal-anti-patterns.md` | 検出して避けるべきユニバーサルアンチパターン。 |
|
||
| `worktree-path-safety.md` | エグゼキューターパスガード: 供給ルート pin(ステップ 0p、#4254 — 全モード。execute-phase.md がオーケストレーター検証済みルートをシーケンシャルディスパッチに `<project_root_pin>` として束縛する)、cwd ドリフトセンチネル(ステップ 0a、#3097)、絶対パスガード(ステップ 0b、#3099)— `<execution_context>` 経由でエグゼキュータースポーンプロンプトに読み込まれる。 |
|
||
| `artifact-types.md` | 計画アーティファクトタイプの定義。 |
|
||
| `phase-argument-parsing.md` | フェーズ引数の解析規約。 |
|
||
| `decimal-phase-calculation.md` | 小数サブフェーズの番号付けルール。 |
|
||
| `workstream-flag.md` | ワークストリームアクティブポインター規約(`--ws`)。 |
|
||
| `user-profiling.md` | ユーザー行動プロファイリングの検出ヒューリスティック。 |
|
||
| `thinking-partner.md` | 意思決定ポイントでの条件付き思考パートナー起動。 |
|
||
| `autonomous-smart-discuss.md` | 自律モード向けのスマート discuss ロジック。 |
|
||
| `ios-scaffold.md` | iOS アプリケーションスキャフォールディングパターン。 |
|
||
| `ai-evals.md` | `/msd-ai-integration-phase` 向けの AI 評価設計リファレンス。 |
|
||
| `ai-frameworks.md` | `msd-framework-selector` 向けの AI フレームワーク決定マトリクスリファレンス。 |
|
||
| `executor-examples.md` | msd-executor エージェントの実例。 |
|
||
| `doc-conflict-engine.md` | ingest/import ワークフロー向けの共有競合検出コントラクト。 |
|
||
| `execute-mvp-tdd.md` | MVP+TDD での execute-phase のランタイムゲートセマンティクス — タスク前の失敗テスト検証、フェーズ末尾のブロッキングレビュー。 |
|
||
| `mvp-concepts.md` | 6 つの MVP 関連リファレンスファイルのクロスリファレンスインデックス。各ファイルの目的とどのワークフローが読み込むかをマッピング。 |
|
||
| `verify-mvp-mode.md` | MVP モードフェーズの UAT フレーミングルール — ユーザーフローファーストの順序、延期された技術チェック、ユーザーストーリーフォーマットガード。 |
|
||
|
||
### スケッチリファレンス
|
||
|
||
`/msd-sketch` ワークフローとその wrap-up コンパニオンが使用するリファレンス。
|
||
|
||
| リファレンス | 役割 |
|
||
|-------------|------|
|
||
| `sketch-interactivity.md` | HTML スケッチをインタラクティブで生き生きとさせるためのルール。 |
|
||
| `sketch-theme-system.md` | クロススケッチの一貫性のための共有 CSS テーマ変数システム。 |
|
||
| `sketch-tooling.md` | すべてのスケッチに含まれるフローティングツールバーユーティリティ。 |
|
||
| `sketch-variant-patterns.md` | マルチバリアント HTML パターン(タブ、並排表示、オーバーレイ)。 |
|
||
|
||
### 思考モデルリファレンス
|
||
|
||
思考クラスモデル(o3、o4-mini、Gemini 2.5 Pro)を MSD ワークフローに統合するためのリファレンス。
|
||
|
||
| リファレンス | 役割 |
|
||
|-------------|------|
|
||
| `thinking-models-debug.md` | デバッグワークフロー向けの思考モデルパターン。 |
|
||
| `thinking-models-execution.md` | 実行エージェント向けの思考モデルパターン。 |
|
||
| `thinking-models-planning.md` | 計画エージェント向けの思考モデルパターン。 |
|
||
| `thinking-models-research.md` | 調査エージェント向けの思考モデルパターン。 |
|
||
| `thinking-models-verification.md` | 検証エージェント向けの思考モデルパターン。 |
|
||
|
||
### モジュラープランナー分解
|
||
|
||
`msd-planner` エージェントは、ランタイムの文字数制限に収めるためにコアエージェントとリファレンスモジュールに分解されます。
|
||
|
||
| リファレンス | 役割 |
|
||
|-------------|------|
|
||
| `planner-antipatterns.md` | プランナーのアンチパターンと具体性の例。 |
|
||
| `planner-chunked.md` | チャンクモードの戻り形式(`## OUTLINE COMPLETE`、`## PLAN COMPLETE`)— Windows stdio ハングの緩和策。 |
|
||
| `planner-gap-closure.md` | ギャップクロージャーモードの動作(VERIFICATION.md を読み込み、ターゲットを絞った再計画)。 |
|
||
| `planner-reviews.md` | クロス AI レビュー統合(`/msd-review` からの REVIEWS.md を読み込み)。 |
|
||
| `planner-revision.md` | 反復的な精緻化のためのプラン修正パターン。 |
|
||
| `planner-source-audit.md` | プランナーのソース監査と権威制限ルール。 |
|
||
| `planner-mvp-mode.md` | MVP モード向けの垂直スライス計画ルール。 |
|
||
| `planner-human-verify-mode.md` | `workflow.human_verify_mode = end-of-phase` のルール: `checkpoint:human-verify` タスク発行を抑制し、延期された項目を `<verify><human-check>` 経由でルーティング。 |
|
||
| `planner-graphify-auto-update.md` | `load_graph_context` が既存の鮮度アノテーションに加えて `.last-build-status.json` の自動更新状態(running / failed / stale head)をどのように表示するか。`graphify.auto_update` でオプトイン(#3347)。 |
|
||
| `planner-interface-context.md` | エグゼキューター向けのインターフェースコンテキストルール — 既存コードから主要なインターフェース/型/エクスポートを抽出する方法と、下流のプランが使用する新しいインターフェースのドキュメント化方法。 |
|
||
| `skeleton-template.md` | 新プロジェクトのウォーキングスケルトン(フェーズ 1 + `--mvp`)用に出力される SKELETON.md テンプレート。 |
|
||
| `user-story-template.md` | MVP 計画向けのユーザーストーリーフォーマット — "As a / I want to / So that" の構造化フィールド。 |
|
||
| `spidr-splitting.md` | MVP モードで大きなユーザーストーリーを処理するための SPIDR 分割ルール。 |
|
||
|
||
> **サブディレクトリ:** `msd-core/references/few-shot-examples/` には、特定のエージェントから参照される追加のフューショット例(`plan-checker.md`、`verifier.md`)が含まれます。これらは 62 のトップレベルリファレンスにはカウントされません。
|
||
|
||
---
|
||
|
||
## CLI モジュール (81 shipped)
|
||
|
||
完全な一覧: `msd-core/bin/lib/*.cjs`。
|
||
|
||
| モジュール | 責務 |
|
||
|-----------|------|
|
||
| `active-workstream-store.cjs` | ワークストリームソースの優先度と選択(CLI `--ws` > `MSD_WORKSTREAM` 環境変数 > 保存済みポインター)、名前のバリデーションと環境への伝播 |
|
||
| `adr-parser.cjs` | plan-phase インジェストエクスプレスパス向けの ADR 決定パーサー。セクションの同義語を正規化し、ステータス/決定/スコープフェンスを解析して、ステータス拒否ゲートを適用 |
|
||
| `agent-command-router.cjs` | `msd-tools agent` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `artifacts.cjs` | 標準的なアーティファクトレジストリ — 既知の `.planning/` ルートファイル名。`msd-health` W019 リントで使用 |
|
||
| `audit.cjs` | 監査ディスパッチ、監査オープンセッション、監査ストレージヘルパー |
|
||
| `check-command-router.cjs` | `msd-tools check` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `cjs-command-router-adapter.cjs` | マニフェストバックの CJS コマンドファミリールーター向けの共有互換アダプター |
|
||
| `clock.cjs` | 決定論的なロックテスト向けの注入可能なクロックシーム(now/sleep) |
|
||
| `clusters.cjs` | ランタイムサーフェスモジュール向けのスキルクラスター定義(ADR-0011 フェーズ 2) |
|
||
| `code-review-flags.cjs` | `/msd-code-review` 向けの型付きフラグパーサー。`parseCodeReviewFlags(argv)`(→ `{ fix, all, auto, depth, files }`)と `resolveCodeReviewWorkflow(flags)`(→ `'code-review.md' \| 'code-review-fix.md'`)をエクスポート。`--fix`/`--all`/`--auto` ルーティングの標準ディスパッチシーム |
|
||
| `command-aliases.cjs` | マニフェストバックのファミリールーター向けのエイリアス/サブコマンドメタデータ |
|
||
| `command-arg-projection.cjs` | コマンドファミリールーター間で共有される型付きフラグと位置引数のプロジェクションヘルパー |
|
||
| `command-routing-hub.cjs` | すべてのコマンドファミリールーターのモード決定(SDK vs CJS)、エラー分類、ノースロー契約を一元化する純粋結果ディスパッチハブ(#3788) |
|
||
| `commands.cjs` | その他の CLI コマンド(slug、タイムスタンプ、TODO、スキャフォールディング、統計) |
|
||
| `config-schema.cjs` | `VALID_CONFIG_KEYS` と動的キーパターンの単一ソース。バリデーターと config-schema-docs パリティテストの両方でインポートされる |
|
||
| `config.cjs` | `config.json` の読み書き、セクション初期化。`config-schema.cjs` からバリデーターをインポート |
|
||
| `config-types.cjs` | `model_policy` 設定ブロックの TypeScript 型定義 — `ModelPolicyConfig`、`TierEntry`、`RuntimeTiers`。発行時に `src/config-types.cts` からコンパイル(ADR-457) |
|
||
| `configuration.cjs` | 設定モジュール — 標準的な設定読み込み、レガシーキー正規化、デフォルトマージ、明示的なディスク上のマイグレーション。SDK と CJS 両方のコンシューマーの信頼できるソース |
|
||
| `context-utilization.cjs` | `msd-health --context` 向けの純粋なクラシファイアー — (tokensUsed, contextWindow)を 60%/70% の骨折点閾値に対する `{ percent, state }` トリアージ結果に変換(#2792) |
|
||
| `core.cjs` | エラー処理、出力フォーマット、共通ユーティリティ、ランタイムフォールバック。planning-workspace ヘルパーの互換性再エクスポート |
|
||
| `decisions.cjs` | CONTEXT.md の `<decisions>` ブロックを解析。数値(D-42)と英数字(D-INFRA-01)の ID を受け付け。`{id, text, category, tags, trackable}` を返す |
|
||
| `docs.cjs` | docs-update ワークフロー初期化、Markdown スキャン、モノリポ検出 |
|
||
| `drift.cjs` | 実行後のコードベース構造ドリフト検出器(#2003): ファイル変更を new-dir/barrel/migration/route カテゴリに分類し、`last_mapped_commit` フロントマターをラウンドトリップ |
|
||
| `fallow-runner.cjs` | `/msd-code-review` 向けのファロー監査アダプター: バイナリ解決(`node_modules/.bin` 次に `PATH`)、アクション可能なバイナリ欠落エラー、構造的な調査結果の正規化 |
|
||
| `frontmatter.cjs` | YAML フロントマター CRUD 操作 |
|
||
| `gap-checker.cjs` | 計画後のギャップ分析(#2493): REQUIREMENTS.md + CONTEXT.md 決定事項 vs PLAN.md カバレッジレポート(`msd-tools gap-analysis`)の統合 |
|
||
| `graphify.cjs` | `/msd-graphify` 向けのナレッジグラフビルド/クエリ/ステータス/差分 |
|
||
| `gsd2-import.cjs` | `/msd-import --from-gsd2` 向けの外部プランインジェスト |
|
||
| `init-command-router.cjs` | `msd-tools init` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `init.cjs` | 各ワークフロータイプの複合コンテキスト読み込み |
|
||
| `install-profiles.cjs` | `--minimal` インストール向けのインストールプロファイル許可リスト + スキルステージング(#2762)。どの `msd-*` スキル/エージェントがランタイム設定ディレクトリに配置されるかの単一ソース |
|
||
| `installer-migration-authoring.cjs` | レコードメタデータ、明示的スコープ、所有権の証拠、ランタイムコントラクト引用のインストーラーマイグレーション作成ガードレール |
|
||
| `installer-migration-report.cjs` | インストール/更新統合向けのインストーラーマイグレーションレポートプロジェクションとブロックアクションガード |
|
||
| `installer-migrations.cjs` | インストーラーマイグレーション計画、アーティファクト分類、インストール状態の永続化、ジャーナル化された適用、ロールバックヘルパー |
|
||
| `intel.cjs` | `/msd-map-codebase --query` と `msd-intel-updater` を支えるコードベースインテルストア |
|
||
| `learnings.cjs` | `/msd-extract-learnings` 向けのクロスフェーズ学習抽出 |
|
||
| `milestone.cjs` | マイルストーンアーカイブ、要件マーキング |
|
||
| `model-catalog.cjs` | 共有モデルカタログ JSON の CJS アダプター。すべての CLI コンシューマーの標準ランタイムティアデフォルト、エージェントプロファイルマップ、エイリアスマップ、ルーティングメタデータをエクスポート |
|
||
| `model-profiles.cjs` | `model-catalog.cjs` から派生した後方互換プロファイルヘルパー。独自のモデルテーブルは持たない |
|
||
| `package-identity.cjs` | MSD の公開パッケージ座標(npm 名、bin 名、リポジトリスラッグ、変更履歴 URL、手動インストールコマンド)の生成された単一ソース。package.json から導出。更新ワーカー、`check-latest-version`、インストーラーが読み込む(#498) |
|
||
| `phase-command-router.cjs` | `msd-tools phase` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `phase-lifecycle.cjs` | フェーズライフサイクル SDK ハンドラーから抽出された純粋計算フェーズライフサイクルヘルパー |
|
||
| `phase.cjs` | フェーズディレクトリ操作、小数番号付け、プランインデックス化 |
|
||
| `phases-command-router.cjs` | `msd-tools phases` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `plan-scan.cjs` | フラットおよびネストされたレイアウトでプランとサマリーファイルを検出するための標準フェーズプランスキャナー(k014) |
|
||
| `planning-workspace.cjs` | 計画パス/ワークストリームシーム(`planningDir`、`planningPaths`、アクティブワークストリームルーティング、`.planning/.lock` オーケストレーション) |
|
||
| `project-root.cjs` | 4 つのヒューリスティック(独自の `.planning/` ガード、`sub_repos` 設定、`multiRepo` フラグ、`.git` ヒューリスティック)を使って開始ディレクトリからプロジェクトルートを解決 |
|
||
| `profile-output.cjs` | プロファイルレンダリング、USER-PROFILE.md と dev-preferences.md の生成 |
|
||
| `profile-pipeline.cjs` | ユーザー行動プロファイリングデータパイプライン、セッションファイルスキャン |
|
||
| `prompt-budget.cjs` | レビュープロンプト向けの純粋なトークンバジェット計算 — トークンを見積もり、決定論的なトリム優先度を適用(PROJECT.md の head 縮小、比例プラン切り捨て、コンテキスト/調査/要件の削除、ハードフェイルガード)。`review.max_prompt_tokens` 向けの構造化メタデータを返す(#3081) |
|
||
| `review-reviewer-selection.cjs` | `/msd-review` デフォルトレビュアーポリシーと優先度向けのレビュアー選択/正規化ヘルパー |
|
||
| `roadmap-command-router.cjs` | `msd-tools roadmap` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `roadmap-upgrade.cjs` | レガシーの `Phase N` エントリーをマイルストーンプレフィックス付きの `Phase M-NN` 規約に変換するマイグレーションツール。`computeMigrationPlan` + `applyMigration`(デフォルトのドライランとアトミックロールバック付き) |
|
||
| `roadmap.cjs` | ROADMAP.md 解析、フェーズ抽出、プラン進捗 |
|
||
| `runtime-artifact-layout.cjs` | ランタイムアーティファクトレイアウトモジュール — サポートされている各ランタイムのアーティファクトディレクトリ形状(コマンド、エージェント、スキル)を解決。ランタイムごとのアーティファクト配置の単一ソース(#3663) |
|
||
| `runtime-name-policy.cjs` | ランタイム名正規化ポリシー — パス構築と表示に使用されるランタイム識別子の標準トークンサニタイゼーション |
|
||
| `runtime-homes.cjs` | 標準ランタイム → グローバル設定/スキルディレクトリマッピング。全ランタイムの一流サポート(#3126) |
|
||
| `runtime-slash.cjs` | ランタイム対応スラッシュコマンドフォーマッター — ユーザー向け出力と永続化されたアーティファクトで `/msd-<cmd>`(スキルベースのランタイム)と `$msd-<cmd>`(codex)を出力する単一ソース(#3584) |
|
||
| `schema-detect.cjs` | ORM パターンのスキーマドリフト検出(Prisma、Drizzle、Supabase、TypeORM、Payload)。`detectSchemaFiles`、`detectSchemaOrm`、`checkSchemaDrift`、`SCHEMA_PATTERNS`、`ORM_INFO` をエクスポート |
|
||
| `secrets.cjs` | インテグレーションキー向けのシークレット設定マスキング規約(`****<last-4>`)。`SECRET_CONFIG_KEYS`、`isSecretKey`、`maskSecret`、`maskIfSecret` をエクスポート |
|
||
| `semver-compare.cjs` | 共有 semver 比較ポリシーヘルパー(`compareSemverCore`、stable-triplet バリデーション、正規化タプル解析)。更新チェックフック、statusline dev-install 検出、changeset 抽出範囲ロジックで使用(#10) |
|
||
| `security.cjs` | パストラバーサル防止、プロンプトインジェクション検出、安全な JSON/シェルヘルパー |
|
||
| `shell-command-projection.cjs` | マネージドフック直列化のためのランタイム対応シェルコマンドプロジェクション: ランタイム/プラットフォームによる PowerShell コールオペレーターの使用を決定し、Windows スクリプトパストークンを正規化 |
|
||
| `state-command-router.cjs` | `msd-tools state` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `state.cjs` | STATE.md 解析、更新、進行、メトリクス |
|
||
| `state-document.cjs` | 純粋な STATE.md フィールド抽出、置換、ステータス正規化、進捗計算トランスフォーム |
|
||
| `surface.cjs` | ランタイムサーフェスモジュール — インストール時プロファイルマーカーとは独立してランタイムの有効/無効サーフェス状態を管理(ADR-0011 フェーズ 2) |
|
||
| `task-command-router.cjs` | `msd-tools task` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `template.cjs` | 変数置換によるテンプレート選択と穴埋め |
|
||
| `uat.cjs` | UAT ファイル解析、検証負債追跡、audit-uat サポート |
|
||
| `ui-safety-gate.cjs` | シェルフリーのワード境界 UI トークン検出器(#3706、#3718)。フェーズセクションテキストを標準入力から読み込み、0(UI 発見)または 1(UI なし)で終了。MSD インストーラーが `$RUNTIME_DIR` に配布するために `msd-core/bin/lib/` にもデプロイ(#448) |
|
||
| `update-context.cjs` | `/msd-update` 向けの純粋なインストールコンテキストリゾルバー — ランタイム/スコープ/設定ディレクトリ/バージョン検出(LOCAL/GLOBAL/UNKNOWN)。update.md bash からポート。`msd-tools update-context` を支える(#498) |
|
||
| `validate-command-router.cjs` | `msd-tools validate` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `validate.cjs` | 純粋なフェーズバリアント正規化ヘルパー(`phaseVariants`、`buildRoadmapPhaseVariants`、`buildNotStartedPhaseVariants`)。`verify.cjs` の W006/W007 チェックで使用。I/O なし、非同期なし |
|
||
| `verify-command-router.cjs` | `msd-tools verify` 向けの薄い CJS サブコマンドルーターアダプター |
|
||
| `verify.cjs` | プラン構造、フェーズ完全性、参照、コミットバリデーション |
|
||
| `workstream-inventory-builder.cjs` | 純粋なワークストリームインベントリプロジェクションビルダー |
|
||
| `workstream-inventory.cjs` | 共有ワークストリームインベントリプロジェクション: 状態フィールド、フェーズ/プラン/サマリーカウント、ロードマップフェーズカウント、アクティブマーカー — 純粋なプロジェクションを `workstream-inventory-builder.cjs` に委任する薄いオーケストレーター |
|
||
| `workstream-name-policy.cjs` | 標準ワークストリーム名バリデーション(`isValidActiveWorkstreamName`、`hasInvalidPathSegment`、`validateWorkstreamName`)とスラッグ正規化(`toWorkstreamSlug`) |
|
||
| `workstream.cjs` | ワークストリーム CRUD、マイグレーション、セッションスコープのアクティブポインター |
|
||
| `worktree-safety.cjs` | ワークツリールート解決と非破壊的プルーンポリシー決定。W017 ヘルスチェックロジックを所有 |
|
||
|
||
[`docs/CLI-TOOLS.md`](../CLI-TOOLS.md) はこれらのモジュールのサブセットを説明している場合があります。ファイルシステムと異なる場合は、このテーブルとディレクトリ一覧が正式です。
|
||
|
||
---
|
||
|
||
## フック (14 shipped)
|
||
|
||
完全な一覧: `hooks/`。
|
||
|
||
| フック | イベント | 目的 |
|
||
|--------|---------|------|
|
||
| `msd-statusline.js` | `statusLine` | モデル、タスク、ディレクトリ、コンテキスト使用率を表示 |
|
||
| `msd-context-monitor.js` | `PostToolUse` / `AfterTool` | 残量 35%/25% でエージェント向けコンテキスト警告を注入 |
|
||
| `msd-check-update.js` | `SessionStart` | 新しい MSD バージョンのバックグラウンドチェック |
|
||
| `msd-check-update-worker.js` | (worker) | check-update のバックグラウンドワーカーヘルパー |
|
||
| `msd-update-banner.js` | `SessionStart` | MSD statusline を使用していない場合に更新の可用性を表示するオプトインバナー(PR #2795) |
|
||
| `msd-prompt-guard.js` | `PreToolUse` | `.planning/` への書き込みのプロンプトインジェクションパターンをスキャン(アドバイザリー) |
|
||
| `msd-workflow-guard.js` | `PreToolUse` | MSD ワークフローコンテキスト外のファイル編集を検出(アドバイザリー、オプトイン) |
|
||
| `msd-read-guard.js` | `PreToolUse` | 未読ファイルへの Edit/Write を防ぐアドバイザリーガード |
|
||
| `msd-read-injection-scanner.js` | `PostToolUse` | ツール Read 結果のプロンプトインジェクションパターンをスキャン(v1.36+、PR #2201) |
|
||
| `msd-worktree-path-guard.js` | `PreToolUse` | ワークツリールート外の絶対パスを持つ Edit/Write/MultiEdit をハードブロック(PR #579、#260) |
|
||
| `msd-agent-isolation-guard.js` | `PreToolUse` | プロジェクトの解決済みディスパッチ分離が `harness-worktree` の場合、ハーネス分離パラメータを欠く executor の `Agent()` ディスパッチをハードブロック(#3045) |
|
||
| `msd-write-guard.js` | `PreToolUse` | キュレーションされた `.planning/` アーティファクト(ROADMAP.md、マイルストーンロードマップ、STATE.md)を大幅に縮小するファイル全体の `Write` をハードブロック。使い捨てセンチネル `.planning/.msd-allow-shrink`(ワークフローステップ)または `MSD_ALLOW_PLANNING_SHRINK=1`(対話時)でオーバーライド(#2255、#973 の修正 3) |
|
||
| `msd-secret-read-guard.js` | `PreToolUse` | Read / Grep / Bash による `.env`、`.env.<suffix>`(`.env.example` などのテンプレートは除外)、`.secrets` の読み取りをハードブロック。インストーラが書き込んでいた `Read(.env*)` の deny ルールを置き換える(#4221) |
|
||
| `msd-session-state.sh` | `SessionStart` | シェルベースランタイム向けのセッション状態追跡 |
|
||
| `msd-validate-commit.sh` | `PreToolUse` | Conventional Commit 適用のためのコミットバリデーション |
|
||
| `msd-phase-boundary.sh` | `PostToolUse` | ワークフロー遷移のためのフェーズ境界検出 |
|
||
| `msd-graphify-update.sh` | `PostToolUse` | メイン HEAD が進んだ後にナレッジグラフを自動再ビルド(オプトイン、デフォルトオフ — #3347) |
|
||
|
||
---
|
||
|
||
## メンテナンス
|
||
|
||
- 新しいコマンド、エージェント、ワークフロー、リファレンス、CLI モジュール、またはフックが出荷される際は、リリース前に対応するセクションをここで更新してください。
|
||
- `tests/` 配下のドリフトガードテスト(上記「このファイルの使い方」を参照)は、出荷されたすべてのファイルがこのインベントリに列挙されていることをアサートします。対応する行のない新しいファイルは CI で失敗します。
|
||
- ファイルシステムが `docs/ARCHITECTURE.md` の数値や厳選されたサブセットドキュメント(例: `docs/AGENTS.md` のプライマリロスター)と乖離した場合は、このファイルが正式なソースです。
|
||
|
||
## Related
|
||
|
||
- [Commands](COMMANDS.md) — ユーザー向けコマンドリファレンス
|
||
- [Architecture](ARCHITECTURE.md) — サーフェスがどのように組み合わさるか
|
||
- [docs index](README.md)
|