utility-pm-workflow-orchestrator

PM Workflow Orchestrator（ディスパッチスキル）

pm-workflow-orchestrator サブエージェント用の、クライアント間で使えるディスパッチラッパーです。実行環境を検出し、Claude Code ではネイティブのサブエージェントにディスパッチします。Claude 以外のクライアントでは、agents/pm-workflow-orchestrator.md を読み込み、「参照してインラインで実行する」パターンで実行ループを進めます。オーケストレーターは、保存済みの優先順位付きアクションプラン（モード A）またはユーザーが指定したチェーン（モード B）から、pm スキルを順序どおりに実行します。デフォルトでは続行可否を確認するために一時停止し、ステップが失敗した場合、または空の場合は停止します。

ステータス概要（v2.26.0 更新）： ネイティブの Claude Code 経路でスモークテスト済み。他の環境では実験段階です。

• Claude Code（ネイティブ）：モード B チェーンのスモークテストに合格（2026-06-10、インストール済みプラグイン）。 実環境での実行により、エンジンが下流のスキルを Skill ツール経由で呼び出し、それらがエンジンのコンテキスト内でインライン実行されること（Skill ツールが呼び出し元のコンテキストに対象の SKILL.md を挿入し、サブエージェントは起動されません）、実際の成果物が作成されること、およびチェックポイントで一時停止することを確認しました。モード A のネイティブ実行と、複数のチェックポイントをまたいで単一の対話型エンジンインスタンスを継続する方法は、まだ検証されていません。詳細と注意点については、互換性マトリックスの v2.26.0 スモークゲート記録を参照してください。
• Claude 以外のすべてのクライアント（Codex CLI、Cursor、Windsurf、Copilot CLI、Gemini CLI）： 実際の複数成果物を作成するインライン WRITE 実行を専任メンテナーゲートテストで検証するまでは、実験段階です。オーケストレーターは最大 3 つの完全な PM 成果物を作成し、状態を引き継ぐ場合があります。これはコンダクターのインライン経路よりも厳しい条件であり、Claude Code 以外では実環境で検証されたことがありません。

どのクライアントでも、準備状況の確認として、まず --dry-run を実行してください（影響を伴うスキルを呼び出さずに、解析、チェックポイント、失敗時の停止、ツール機能の事前確認を行います）。正式な安全な使用方法のマトリックスについては、サブエージェント互換性マトリックスを参照してください。

使用する場合

• foundation-prioritized-action-plan を作成済みで、その実行可能なセクション 7 のプロンプトを順に実行し、続行可否の確認を挟みたい場合（モード A）。
• 共有コンテキストを使って、ユーザーがその場で指定する pm スキルのチェーンを実行したい場合（モード B）。たとえば、deliver-prd の後に deliver-user-stories を実行します。Claude Code では、/chain コマンドがこのモードへの簡潔な入り口です。
• あらかじめ用意された workflow-* コマンドではない、動的なチェーンに対応する汎用ランナーが必要な場合。

クライアントとは独立した実行モード：

• チェックポイント方式（デフォルト）： 各 OK ステップの後に一時停止し、承認／編集／スキップ／やり直しを選べます。
• ガード付き自動実行（--auto、オプトイン）： 問題のないステップでは一時停止せずに実行します。失敗時は引き続き停止し、空の場合は一時停止します。また、--force-auto を指定しない限り、Complex／Chaotic プランではチェックポイント方式を維持します。

--thread は直線的な依存関係を宣言します。各ステップは、直前のステップで確認済みの成果物を受け取ります。詳細については、references/PARSE-CONTRACT.md のモード B チェーン式の仕様を参照してください。

使用しない場合

• 作成者が手作業で保守する、固定のキュレーション済みの名前付きチェーン（完全な Foundation Sprint や Customer Discovery など）を使いたい場合 -> 既存の workflow-* コマンド（workflow-foundation-sprint、workflow-customer-discovery、...）を使用してください。このオーケストレーターはこれらに取って代わるものではなく、ワークフローのステップはネストせずに MANUAL として表示します。
• 優先順位付きアクションプランを作成するだけで、実行する必要がない場合 -> foundation-prioritized-action-plan を使用してください（作成したプランをここに渡すこともできます）。
• 成果物を 1 つだけレビューしたい場合 -> utility-pm-critic を使用してください。
• ライブラリ保守の仕組みを PM 作業として実行したい場合 -> オーケストレーターは Tier-3 保守スキルを拒否します。
• 今すぐチェーンを実行するのではなく、再利用可能なワークフローを作成したい場合 -> utility-pm-workflow-builder を使用してください。このスキルは永続化される名前付きワークフローを作成しますが、このスキルが実行するのは一時的なチェーンであり、定義は保存しません。

手順

実行環境の検出ステップ。 このスキルを呼び出している AI クライアントを判定します。実行モード（チェックポイントあり／自動）はユーザーのフラグに基づき、クライアントとは独立しています。

pm-skills プラグインをインストールした Claude Code で実行している場合

@agent-pm-skills:pm-workflow-orchestrator を、ユーザーの入力と $ARGUMENTS のフラグ（--auto、--force-auto、--dry-run）とともに呼び出します。ネイティブのサブエージェントが入力を解析してステップリストを作成し、Skill ツールを通じて各ステップを実際の後続スキルに委譲し、確認の一時停止を含む各ステップ独自のループを実行します。エンジンの各ステップの出力ブロックと最終出力をユーザーに伝えます。

この経路は v2.24.0 時点で実験的です（ステータスの概要を参照）。まず --dry-run を実行するようユーザーに案内してください。

その他の AI クライアントで実行している場合

Codex CLI、Cursor、Windsurf、Copilot CLI、Gemini CLI、またはネイティブの pm-skills プラグインサブエージェントに対応していないクライアントの場合：

1. ツール機能の事前確認（最初のアクションとして、解析やステップ 1 より前に実施）。 クライアントが（a）_pm-skills/plan-orchestrator/<run>/ 配下にファイルを書き込めること、（b）後続スキルが必要とする Bash を実行できることを確認します。
   • ファイルを書き込めない場合：短い実行では、複数ステップの信頼性が低下し、すべての成果物をコンテキスト内に保持するためコンテキスト予算が増えることを警告したうえで、明示的にチャットのみのモードに切り替えます。長い実行は、理由を明確に伝えて拒否します。途中で失敗してはいけません。
   • Bash が必要なステップで Bash を利用できない場合：そのステップに到達した時点で、実行がブロックされていることを示します。
   • 検出した機能を記録します。これにより、後述のディスク書き込みの動作を決定します。
2. 正規のサブエージェント定義である agents/pm-workflow-orchestrator.md を読みます。
3. 共有の解析およびステータス判定の契約である references/PARSE-CONTRACT.md を読みます（エンジンも同じファイルを読みます。これにより、インライン分岐とエンジンの動作の乖離を防ぎます）。
4. エンジンの本文を実行手順として適用します。事前確認による拒否条件を確認し、順序付きステップリストを作成してから（モード A の解析、またはモード B の名前付きチェーン）、ステップごとのループを進めます。
5. 各ステップで、後続スキルの SKILL.md を読み、その手順をこのウィンドウ内でインライン実行します。references/PARSE-CONTRACT.md の基準に従って、戻り値を PRODUCED／EMPTY／FAILED に分類します。ディスク書き込みが有効な場合は、実行ディレクトリに NN-<skill-name>.md を書き込みます。
6. 実行モードを遵守します。CHECKPOINTED では OK の各ステップで一時停止します。GUARDED AUTO では、明確に PRODUCED と判定できるステップのみ自動で次に進みます。FAILED のステップがあれば実行を停止します。EMPTY または判定が曖昧なステップでは、--force-auto にかかわらず、必ず確認のために一時停止します（ユーザーが解除できる強制チェックポイントです）。
7. エンジンのセクション 4.5 に従い、最終出力（完了または停止）を出力します。

「参照してインライン実行する」方式により、複数のクライアント間での互換性が実現します。この方式は、メンテナーゲートの WRITE ハーネスによって各クライアントで実際の複数成果物実行が検証されるまでは、実験的なものです。

--dry-run（準備状況の確認。どのクライアントでも最初に実行）

--dry-run は、すべてのステップを順に確認し、解析、チェックポイント、失敗時の停止、ツール機能の事前確認を試行しますが、影響を伴う後続スキルは呼び出しません。各ステップでは、「NOT EXECUTED - dry run」と、実際に行う場合の内容（対象スキル、モード、ディスク書き込みの有無）が出力されます。実際の委譲にトークンを費やす前に、計画が正しく解析されること、チェーンが解決されること、クライアントが本番実行に必要なツールアクセスを備えていることを確認するために使用します。

クライアント間の注意事項

Claude 以外のクライアントでは、ループを実行し、すべてのステップを 1 つのコンテキストウィンドウ内でインライン実行するため、次の点に注意してください。

1. コンテキストの予算。 エンジン本体、ステップごとに後続で読み込むスキル、生成される成果物の合計は、複数ステップの実行でコンテキストの上限に近づくことがあります。エンジンは 2 ステップ以上の実行でディスク書き込みを自動的に有効にし、完了した各ステップについては 1 行の要約だけをコンテキストに残します。CHAT-ONLY モードではこの軽減策が機能しないため、長いチェーンでは書き込み可能なクライアントを推奨します。
2. ツールの認可。 インライン実行には、ファイル書き込みと Bash へのアクセスが必要です（読み取り専用では不可）。これについては、事前チェック（上記のステップ 1）で確認します。Codex ではサンドボックスの書き込みフラグを有効にする必要がある場合があります。Cursor と Gemini では、ステップごとに承認を求められる場合があります。
3. ネイティブなチェーン実行はありません。 このため、エンジンはサブエージェントを起動せず、Skill（Claude Code）またはインラインでの読み取りと実行（Claude 以外）を使って処理を委譲します。Mode A のステップが、サブエージェントに処理を振り分けるディスパッチスキル（utility-pm-critic のみ）に解決される場合は、チェーン実行せず、リーフエージェントをインライン実行します（エンジンのセクション 7.2）。

参照ファイル

• サブエージェントの標準定義：agents/pm-workflow-orchestrator.md
• 共通の解析およびステータス契約：references/PARSE-CONTRACT.md
• 出力テンプレート：references/TEMPLATE.md
• 実行例：references/EXAMPLE.md
• 生成元（HANDOFF モードでプランをここに渡します）：skills/foundation-prioritized-action-plan/SKILL.md
• サブエージェント互換性マトリックス：docs/reference/sub-agent-compatibility.md
• ランタイムコンポーネントのカタログ：docs/reference/runtime-components.md
• ライブラリのサンプル（チェックポイント付きの単一実行）：library/sub-agent-samples/pm-workflow-orchestrator/