loom-plan-execution

/loom-plan-execution

ガイド優先の計画実行スキルです。

ミッション

このスキルは、独自のテンプレートでパッケージのセットアップを隠しません。まず、現在の CI/CD 管理対象スキルパッケージのバージョンブロックに一致するパッケージとガイドの参照先をユーザーに示し、その後、該当する Loom Agent Plan-Execution Orchestrator のランタイム参照先を通じて実行に進みます。

スキルに紐づくバージョンが選択されたら、サポート対象のホスト RID を 1 つ検出し、そのバージョンの公開済み AO セルフコンテインドパッケージを取得して検証し、安全に展開したうえで、Windows では ao.exe --guide、Unix では ao --guide を直接実行します。計画や後続作業に進む前に、JSON のバージョンと、読み取り可能な guide_path の内容を検証します。パッケージには英語のドキュメントが含まれています。アプリホストにはガイドページは埋め込まれていません。

呼び出し元が現在のリポジトリ内でこのスキルを明示的にデバッグしており、現在のソースツリーを使うよう求めている場合、このスキルはパッケージアセットをダウンロードする代わりに、ローカルの Loom Agent Plan-Execution Orchestrator リポジトリの出力をビルドして使用できます。このローカルソースの上書きはリポジトリのデバッグ専用であり、公式実行権限の主体を追加するものではありません。

このスキルは、公式実行権限の主体として Loom Agent Plan-Execution Orchestrator を使用します。Windows では ao.exe run／ao.exe resume を、Unix では ao run／ao resume を直接実行する場合のみ、公式なスキル実行とみなされます。それ以外の方法は、公式実行の範囲外です。

ビジネス成果優先のルール：呼び出し元の依頼または計画の内容（たとえば testplan.md）がビジネス実行の成果を明確に目標としている場合、このスキルはそのビジネス成果を主要な完了目標として扱い、AO のメタ実行だけに終始してはなりません。

まずお読みください

• 用語の共通参照先：../../../docs/en/architecture/workflow-terminology.md（人が理解しやすいステータスのバイリンガル対応表。ユーザー向けの出力を行う前にお読みください）。

• ランタイムのバインドに関する参照先：このスキルが記録するのは、バインドされた AO パッケージの正確なバージョンのみです。ホストは現在のマシンから OS、アーキテクチャ、Linux libc、RID、アプリホストを判定します。これらの一時的な詳細をチェックイン済みのスキル状態に保存しないでください。

公開済みランタイムの転送ルール

公開済み AO の実行には、セルフコンテインドのアプリホストを直接使用し、MCP は必要ありません。オプションの SO／MCP サポートは別の後続ワークフロー上の検討事項であり、AO パッケージの取得やガイドの取得を妨げてはなりません。ディスパッチされた MCP アプリケーションの失敗は、失敗として扱われます。

名前付きエージェントの解決

このスキルで指定されている各 .agent.md は、その役割に対する正確な動作契約です。ホストへの登録はディスパッチの仕組みにすぎず、機能の利用可否を決めるものではありません。

• ファイルのステムではなく、ファイルのフロントマターに記載された正確な name で役割を特定してください。ワークフローデザイナーの名前は loom-plan-execution Workflow Designer です。このスキルの assets/agents/ フォルダーからファイルを解決してください。スタンドアロンでインストールされている場合は、~/.agents/skills/<skill-folder>/ や ~/.claude/skills/<skill-folder>/ など、アクティブなスキルのルートから同じ相対パスで解決してください。現在のリポジトリ／ワークスペースのコピーを優先し、次に対応するグローバルインストール済みスキルのコピーを使用してください。
• ディスパッチ前に事前確認を行ってください。その正確な名前と、ホストがサブエージェント呼び出し用に公開しているエージェント一覧を照合します。スキル内の assets/agents/ ファイルは通常、登録されていません（VS Code では登録されません）。そのため、名前が見つからない場合は下記のドライバールートに進み、失敗が予想される直接呼び出しは行わないでください。
• 名前が登録されている場合は、直接呼び出してください。次のいずれかの結果になった場合は、未登録として扱い、同じ手順内でドライバールートに切り替えてください。agent not found、不明なエージェント名または無効なエージェント名、agentName（または同等のパラメーター）を持たないサブエージェントツール、または宣言された役割を認識したことを示さないデフォルトエージェントによる無言の処理。
• ドライバールート：編集、コマンドの実行、検証が可能な、登録済みの汎用エージェントを呼び出してください（VS Code では、agentName を省略したデフォルトエージェント）。契約で設計、編集、検証が必要な場合は、Explore のような読み取り専用エージェントを使用せず、似た名前の役割で代用しないでください。ディスパッチでは、フロントマターに記載された正確な名前と、該当する .agent.md へのクリック可能な Markdown リンクを示し、次のいずれかの方法で契約を渡してください。
  • インライン：ファイルの内容全体を含めます。
  • パスのみ：ハッシュを含めずに解決済みのファイルパスを示し、作業を始める前にドライバー自身がファイル全体を読むよう指示します。ドライバーは、まず読み取ったフロントマターの name を復唱し、ファイルを読めない場合はそこで停止しなければなりません。
• どちらの受け渡し方法でも、必要な入力と参照コンテキストをすべて渡してください。大きな入力はパスで渡してください。契約の代わりに要約だけを渡してはいけません。
• エージェントファイルと入力が大きい場合は、パスのみでの受け渡しを優先してください。リクエストサイズエラー、HTTP 408、またはタイムアウトは転送エラーであり、エージェントが未登録という意味ではありません。パスのみの方法で入力もパスで渡して一度だけ再試行してください。それでも失敗する場合は、転送上の障害を報告してください。
• ドライバーへのフォールバックにユーザーの承認は不要です。これは通常の運用です。専用の名前が登録されていないという理由だけで処理を止め、ユーザーに確認を求めないでください。
• 正確なファイルが存在しない、または曖昧な場合、あるいは読み取り専用でない有能なドライバーが存在しない場合に限り、停止してください。その場合は失敗を示す証拠を保全し、具体的な障害を報告し、完了したと主張したり、依存する確認へ進んだりしないでください。サブエージェントのドライバーを介さず、メインの会話で役割の作業を直接行うには、ユーザーの明示的な承認が必要です。
• ディスパッチごとに、フロントマターに記載された正確な名前、.agent.md へのリンク、ルート（direct または driver-fallback）、受け渡し方法（inline または path-only）、フォールバックのきっかけとなった証拠、ドライバーが復唱した名前を記録してください。

ワークフローファイルの言語

ワークフロー定義ファイルは、Loom Skill Orchestrator のガバナンス下で強化される AO、SO、スキル全体を通じた、正規の英語情報伝達手段です。ワークフローが所有するスキーマキー、ノード名と遷移名／説明、ワークフローフェーズ、式、ヒント、失敗時のガイダンス、証拠の参照、制御メタデータは英語のままにしてください。ユーザー／ビジネス向けのペイロード値とローカライズされたユーザー向け出力は、元の言語または指定された言語のままにしてください。ローカライズはプレゼンテーション層で行い、ワークフローキーや制御の意味を変更してはいけません。

呼び出し元ファイルの準備契約

CLI を 1 回呼び出す前に、呼び出し元は入力一式をディスク上に用意し、すべての入力ファイルを閉じておく必要があります。--script-file、--input-file、--base-workflow-file、--verify-script、--reference-workflow-file、--patch-content-file、--patch-target、--workflow-file、--objective-file、--context-file、--instance-file、--result-file には、パスのみを渡してください。

スクリプトのソース、JSON、パッチの置換テキスト、参照コンテンツをインラインで渡さないでください。欠けている入力を作成したり、先行する不完全なファイルを修復したりするよう、CLI や後続の手順に依頼しないでください。CLI は、読み取りや書き込みの前に必要な入力ファイルをすべて事前チェックします。候補、検証、監査の出力先などのファイルは、CLI によって作成される場合があります。

ガイドハブの構成

AO ガイドの正本ページは ../../../docs/en/guides/ 以下にあり、実行時ドキュメントバンドルに再帰的にパッケージ化されます。抽出されたパッケージでは、guides/ao-guide.md を --guide のエントリとして使用し、隣接するページとして ao-guide-flow.md、ao-guide-reference.md、ao-guide-reference-<chapter>.md を配置します。このスキルは AO ガイドファイルを公開しません。実行時の取得には reference/ao-skill-reference.md を、バージョン固有の正本には新たに抽出したガイドを使用してください。

• 現在公開されている AO パッケージの実行時バージョン：0.4.0。
• このブロックは、AO パッケージのバージョンが変わるたびに公開ワークフローによって更新されるため、スキルの契約は常に最新の安定版パッケージ一式と整合します。

まず現在のスキルパッケージのバージョンブロックに従い、次に対応するパッケージの構成を特定してください。

• パッケージインデックスは、引き続きスキル内の参照資料です。AO ガイドの正本ソースは ../../../docs/en/guides/ao-guide.md であり、抽出された実行時エントリは guides/ao-guide.md です。対象ローカルの AO コピーは、正確に紐づけられた実行時パッケージから抽出された完全なパッケージガイドページです。これらはローカルでの確認には使用できますが、新たに公開された実行時の guide_path に代わるものではありません。

• このスキルの下に AO ガイドファイルを追加または公開しないでください。正確にロックされたパッケージの ao.exe --guide または ao --guide を直接実行して返される新しいガイドを使用してください。

• ワークフローデザイナーサブエージェント：assets/agents/loom-plan-execution-workflow-designer.agent.md

• AO 拡張に関する Loom Skill Orchestrator のガバナンス基準アセット：

  • 実行ごとの計画出力：<execution-output-root>/plan/skill-plan.md（ランタイム管理。安定したスキルアセットではありません）
  • assets/so-workflow/so-template.json
  • assets/so-workflow/so-package-lock.json
  • assets/so-workflow/node-to-file-map.md

• assets/so-workflow/reference/ao/runtime-contracts.md

• assets/so-workflow/reference/ao/runtime-behavior.md

• assets/so-workflow/reference/document-copy-manifest.json

あらゆる言語で、わかりやすくフィードバックする

このスキルからユーザーに伝える進捗、停止、エラー、完了のすべての更新は、ワークフローの知識がない高校生にも理解できるよう、ユーザーが指定した言語で書いてください。英語だからといって、自動的にわかりやすい表現になるわけではありません。このルールは、対応するすべての言語に等しく適用されます。

短い文、なじみのある言葉、直接的な動詞を使ってください。次の4点を、この順番で伝えてください。何が起きたか、ユーザーの作業やデータが安全か、またはどの結果が引き続き有効か、その理由、そして次に何をするかを具体的に説明してください。

ステータス値、ステップの種類、ノード ID、ゲート名、引き継ぎ用語、実行環境の詳細、監査用語を、読者に解読させないでください。技術用語が必要な場合は、正確な用語を示す前に、普通の言葉で説明してください。コマンド、パス、ID、ペイロードのフィールドは、ユーザーが対応したり結果を確認したりするのに役立つ場合に限り、独立した Technical details の行に記載してください。FPx、xxx_preflight_xxx、ノード ID、ゲート ID、内部フィールド名など、ワークフロー内部だけで使うラベルをユーザー向けの説明に使わないでください。正確な識別子は、技術的な詳細または証拠にのみ記載してください。同じルールと以下の用語例は、AO を通じてフィードバックを報告する、改良対象のあらゆるスキルに適用されます。改良対象のスキル向けの指示には、このルールの要点を簡潔に盛り込んでください。

わかりやすい用語の例

左の列は機械記録用です。右の列は、ユーザーに伝える意味を示しています。以下の英語の文は例であり、決まった出力ではありません。意味をユーザーが指定した言語に訳してください。他の言語で英語を使っても、わかりやすい表現の代わりにはなりません。

内部用語	ユーザーの言語で伝える内容
Done	「依頼された作業が完了しました。」
WaitResume	「続けるには、情報または確認が必要です。」
SubagentCall	「担当者がこの部分を確認しています。」
gate	「必要な確認がまだ完了していません。」
transition	「次に、〜を行います。」
seam または boundary	「作業は引き継ぎ地点で待機しています。」
frontier	「次に行える作業がいくつかあります。」
runtime	「タスクを実行しているプログラム」
render unchanged	「以前の図は引き続き有効です。新しい図は必要ありませんでした。」

例：出力フォルダーにすでに記録がある場合

内部メモ：step-0008-compiled はすでに存在し、描画結果に変更はありません。

ユーザー向けの更新：「タスク自体に問題はありません。出力フォルダーには以前の記録がすでにあるため、今回の実行で上書きされませんでした。以前の図とレポートは引き続き有効です。新しい出力フォルダーを使い、保存済みの同じ実行を続けます。」

例：レビューで未解決の問題が見つかった場合

内部メモ：レビューで4件の指摘がありましたが、分類と修正を行う前にレビュー合格の確認が済んだと判断されました。

ユーザー向けの更新：「レビューで4つの問題が見つかりました。問題が修正されたかを確認せず、レビューが終わったと判断したため、処理が早く止まりました。4つの問題を整理して修正し、その後もう一度確認します。」

例：判断を待っている場合

内部メモ：タスクはユーザー入力のステップで待機しています。

ユーザー向けの更新：「続ける前に、次の1点について判断が必要です。[判断してほしい内容を、短い一文で記載してください]。」

内部メモをそのままユーザー向けの更新に転記しないでください。対応や確認に必要な場合は、正確なコマンド、パス、ID、証拠フィールドを独立した Technical details セクションに記載してください。

入力の契約

• 推奨入力：空でない行が10行以上ある詳細な計画
• 代替入力：詳細な計画ドキュメントのファイルパス
• ランタイムバージョンの基準：現在の CI/CD 管理下にあるスキルパッケージのバージョンブロック。必要に応じて、そのバージョンから released と beta を判定します
• ガイド入力：Windows では ao.exe --guide、Unix では ao --guide を直接実行します。英語のみで、version、docs_root、guide_path を含む JSON が返されます。
• 任意の入力：ランタイムのソースモード（デフォルトは package-channel。このスキルを現在のリポジトリ内でデバッグし、意図的に現在のソース出力を使用する場合は repo-src-debug を明示します）
• 任意の入力：監査出力ルートを明示

依頼が短すぎる場合は、ユーザーを計画モードに誘導するか、処理を進める前に詳細な計画ファイルを要求してください。

デフォルトの前提

Loom Agent Plan-Execution Orchestrator ベースの計画実行では、以下のデフォルトを適用します。

• Loom Agent Plan-Execution Orchestrator は、このスキルの唯一の公式実行権限です。公式実行では、Windows では ao.exe run／ao.exe resume、Unix では ao run／ao resume を直接使用します。
• 計画の内容が明確にビジネス成果物を対象としている場合は、ビジネス成果を最優先にすることが必須です。ランタイム／メタデータのみのモードを使用するには、ユーザーの明示的な意図が必要です。
• 公式 AO ランタイムでは、このスキルが指定する正確なバージョンと、ホストが選択した単一の製品＋RID パッケージを使用します。ホストのプローブ、DLL の依存関係解決、2つ目のランタイムモード、モード間のフォールバックはサポートされていません。
• Windows PowerShell 5.1 のパッケージチャネルモードでは、.nupkg は ZIP コンテンツとして扱い、.nupkg に対して Expand-Archive を直接使用しないでください。ZIP API または同等の ZIP ベースの展開方法を使用してください。
• Windows PowerShell 5.1 では、パッケージチャネルの HTTP プローブで Invoke-WebRequest または Invoke-RestMethod を使用する場合、-UseBasicParsing を追加してください。これにより、旧式のブラウザーエンジンに関するプロンプトによるランタイム取得の停止を防ぎます。
• パッケージの検証、展開、apphost の起動、またはガイドの実行に失敗した場合は、失敗の証拠を残して停止してください。stderr を根拠に成功を記録しないでください。直接実行した apphost が返す、成功した JSON 結果と読み取り可能な guide_path のみを保持してください。
• repo-src-debug モードでは、現在のリポジトリからビルドした Loom Agent Plan-Execution Orchestrator の出力を、明示的なデバッグ用オーバーライドとしてのみ使用してください。
• チェックイン済みのソース計画／スナップショットは不変のままにし、変更可能なランタイム状態は、同じ外部ワークフローファイルまたは明示的な実行出力ルートに保持してください。
• 有効なワークフロー、テンプレート、スキーマ、デモ、ランタイムコピー、監査バックアップ、コンパイルフィードバックの JSON 出力は、インデント付きの複数行 JSON として書き込んでください。コンパクトな JSON は、JSONL、MCP／CLI のワイヤーペイロード、明示的な正規ハッシュ投影に限って使用してください。
• 出力先は Git 作業ツリーの外部、または Git の無視対象でもかまいません。正規化された実パスを返し、各出力が存在し、読み取り可能であることを確認してください。--workspace-root が利用できる場合は、エディターで直接開くために、検証済みのワークスペース相対ミラーを使用してください。Git に追跡されていることは、成果物を届ける条件ではありません。
• ao.exe と ao の呼び出しを含め、AO apphost の呼び出しまたは監査を生成する各ステップの後には、必ず Mermaid artifact delivery に従ってください。実際に返された監査パスと読み取り可能性を検証してから、思考過程の更新を、検証済みの Mermaid、HTML、Analysis、Dataflow の Markdown リンクと text フェンスのペアをこの順に並べて開始してください。各タイトルは、検証済みランタイムファイルの完全な絶対アドレス（Windows のドライブパスまたは Unix の絶対パス）へのリンクにしてください。アドレスは / を使用して正規化します。各タイトルの直後に、本文が同一の完全なアドレスのみで構成される text フェンスを置いてください。ワークスペース相対アドレスを使用したり、短縮、省略、三点リーダーでの省略をしたり、フェンス内にラベルや説明を追加したりしないでください。このペアの正確な形式と成果物の順序を維持してください。ファイルが出力されていない、または検証されていない場合は、配信失敗／継続ルールに従い、アドレスを捏造しないでください。このブロックの後に、実行の確信度と推定全体進捗率を、この順でローカライズされた ## 見出しとして記載し、それぞれに短い理由を1つ付けてください。確信度は、依頼された作業が正常に完了する可能性を推定します。推定全体進捗率は、依頼全体のおおよその完了度を示します。どちらも検証済みの証拠に基づいてください。決まった計算式やしきい値はなく、どちらの割合も必須の完了確認に代わるものではありません。最新または直近に検証済みのパスのみを使用してください。not_emitted の場合はレンダリングに変更がないと記載し、delivery_failed の場合はリンクや再利用をせずに失敗と次の対応を報告してください。ユーザー向けのテキストは平易にし、現在のやり取りで使用されている言語に合わせてください。
• runtime_path_only の場合は、固定の成果物レポートに検証済みの完全な絶対アドレスを含めてください。link_resolvable=true の場合に限り、ホスト／エディターで別途開く操作に検証済みのワークスペースミラーを使用してください。レポート内のアドレスを置き換えたり、省略したりしないでください。

AO は CLI 専用です。展開した AO apphost を直接実行してください。ガイド、コンパイル、実行、再開に、動的な MCP 登録、ランタイム記述子、MCP の事前確認は不要です。

• このスキル自体を完全に実行するたびに、アプリホストを直接コンパイルするのは検証に限られ、最終状態ではありません。
• ガイドの引き渡しとコンパイル検証の後、新しい外部ランタイムのワークフローコピーを1つ使用します。同じアプリホストをそのコピーに対して実行し、その後は終端状態に達するまで、そのアプリホストと永続化された状態を使って毎回再開します。
• ランタイムがブロック状態を返した場合は、その証拠を保持し、同じワークフローコピーを再開します。終端状態に達するか、回復不能な障害が文書化されるまで続行します。ブロックされたペイロードだけでは完了とみなされません。
• ローカルのオーケストレーション、直接実行したスクリプト、リポジトリのデバッグ出力、ガイドの成功、プロンプトの計画、コンパイルの成功、または再開されていないブロック状態を根拠に、統制下での完了を主張してはいけません。
• 公開済みのアプリホストを起動できない場合は、失敗したパッケージや起動の証拠を保持して停止します。ローカルまたはヘルパーによる実行経路で代用してはいけません。

詳細な前提、起動時の契約、出力マトリックス、ドリフト防止ルールは、以下のリファレンスドキュメントに記載されています。

• ローカルスキルのリファレンス：reference/ao-skill-reference.md

このスキルのワークフローを生成または改訂する際は、自由形式の汎用エージェント呼び出しではなく、コンテキストを豊富に含む相対リンクを使用して、ローカルのワークフローデザイナーサブエージェントを使う必要があります。

• assets/agents/loom-plan-execution-workflow-designer.agent.md

このワークフローデザイナー経路を使う際は、説明だけの文章ではなく、決定論的なワークフロー作成契約を適用します。

• 各遷移では、構造化された実行可能な guardExpression と標準の passExpression 述語、明示的な証拠出力、明示的なシームの所有者を宣言する必要があります。succeedExpression は移行対象のレガシー入力であり、作成するフィールドではありません。
• すべてのコンテキストパスは、所有する契約の context_fields カタログに宣言する必要があります。各 context.Get<T>(path) の型と、各プロデューサー／出力の射影は、宣言されたJSON型と一致している必要があります。存在確認のみには context.Has(path) を使用します。
• 各ゲートでは、機械検証可能な合格述語、必須の証拠参照、ルートカバレッジのマッピングを宣言する必要があります。
• weave-outヒントでは、再開時の連続性に関する契約フィールドと、想定されるペイロード／証拠の形状を保持する必要があります。
• 最終的なワークフロー提案には、JSON出力を受け入れる前に、遷移、ゲート、所有権に関するプリフライトチェックリストを含める必要があります。
• フェイルクローズ方式とします。具体的な述語や証拠パスを欠く曖昧な遷移／ゲートの記述は拒否します。

この .agent.md ファイルが、ワークフローデザイナーサブエージェントの動作を定める正式な情報源です。使用前に、これを .github/agents/、ユーザープロファイルのエージェントフォルダー、その他の検出可能なエージェントルートに複製するよう求めてはいけません。ディスパッチには Named Agent Resolution のみを使用します。ホストのエージェント一覧をプリフライトし、登録されている場合はフロントマターの正確な名前を呼び出します。登録されていない場合は、インラインまたはパスのみの受け渡しでドライバー経路を使用します。ドライバーへのフォールバックにユーザーの承認は不要です。この経路を、自由形式で近似したエージェントの役割に置き換えてはいけません。

ワークフローデザイナーのリファレンスパック

assets/agents/loom-plan-execution-workflow-designer.agent.md を呼び出す前に、呼び出し元は範囲を限定した referencePackManifest と、正確な AO ランタイムから取得した最新の schemaDemoInput を提供する必要があります。パックには、成功したガイド JSON と返されたガイドファイル、同一ランタイムでのスキーマ／デモ／デモコンパイルの監査結果、現在のターゲットコントラクトと要件、現在のワークフローソース、該当する AGENTS.md、および改訂時には最新のコンパイルフィードバックを含める必要があります。各項目には、正規化されたパス、SHA-256、正確なランタイムバージョン、権限ロール、読み取りステータス、検証結果を記載します。古いワークフローは previous_runnable_reference としてのみ扱い、バージョン／ハッシュ／差分／却下項目の処置が必要です。

以下のクリック可能なドキュメント参照をすべてディスパッチコンテキストに含め、実行および再開の動作に関する適用可能な権威ある情報として扱ってください：実行モデル（英語）、执行模型（简体中文）、JSON コントラクト（英語）、JSON 合同（简体中文）、AO の動作（英語）、AO 行为（简体中文）、SO の動作（英語）、SO 行为（简体中文）。

デザイナーは、ランタイムが所有する <execution-output-root>/workflow-design/reference-manifest.json、static-contract-review.json、semantic-probe-report.json を、それぞれスキーマバージョン workflow-designer.reference-manifest.v1、workflow-designer.static-contract-review.v1、workflow-designer.semantic-probe-report.v1 で返す必要があります。パス、SHA-256、schemaVersion、判定、正確なランタイムバージョンを含む記述子を保持してください。必須のセマンティックプローブが失敗または不明の場合、準備完了にはできません。コンパイル成功だけでは、セマンティックな根拠にはなりません。

自己完結型ランタイムコントラクト

パッケージチャネルのランタイムパスは1つだけです。現在のホストに対応する、正確な公開済み AO 製品＋RID パッケージを使用します。

• OS、アーキテクチャ、Linux の libc から、サポート対象の RID を1つだけ正確に検出します。スキルで指定された正確な AO バージョンを使用します。
• 標準の NuGet グローバルパッケージキャッシュにある、有効な完全一致パッケージのみを再利用します。キャッシュにない場合は、catalogEntry.packageHash に対して正確な NuGet バイト列を検証します。同一バージョンの GitHub Release をフォールバックとして使用する場合は、有効な .sha512 サイドカーが必要です。
• 展開前に、パッケージ ID、正確なバージョン、RID、SHA-512、nuspec、runtime.json、アーカイブ内のパスとサイズ、apphost、英語ガイドファイルを検証します。すべてのチェックに合格した場合のみ展開します。
• 展開直後に、Windows では ao.exe --guide、Unix では ao --guide を実行します。そのバージョンと、読み取り可能なパスが指定範囲内にあることを検証します。その後の処理はこの検証後に行います。
• スキーマ／デモ、コンパイル、実行、再開には、同じ展開済み apphost を使用します。パッケージ、展開、起動、ガイドのいずれかのチェックに失敗した場合は、フェイルクローズします。
• インストール済みの .NET ホスト、DLL モード、ランタイムリゾルバー、起動記述子、固定ブートストラップスクリプト、Loom 固有のキャッシュは必須にしないでください。

ランタイムフロー

0. まず意図を分類します。ビジネス上の実行か、明示的なランタイム検証かを判定します。目的がビジネス成果物を明確に求めている場合は、ビジネス優先モードに固定します。
1. 現在のスキルにバインドされたパッケージのバージョンを確認し、必要に応じてバージョン形式からチャネルを特定します。また、ランタイムのソース（package-channel または明示的な repo-src-debug）を確認します。
2. ランタイムを準備します。
   • repo-src-debug：src/dotnet/Techne.Loom.AgentOrchestrator から Loom Agent Plan-Execution Orchestrator をビルドします。
   • package-channel：正確な AO 製品および RID のパッケージを取得して検証し、安全にスキルフォルダーの外へ展開してから、直接の apphost で --guide を実行します。DLL、Roslyn バンドル、生成された .deps.json、フレームワークの起動コントラクトは使用しません。
3. 選択したランタイムがベアな --guide コマンドを実行できることを証明し、その JSON の結果を解析して、先に進む前に返された guide_path と docs_root を読み取ります。
4. ガイドの結果が得られた後にのみ、計画用のエントリーポイント（prompt-plan）を実行し、必要なプロンプトブロックを取得します。
5. ワークフローを作成または改訂する場合は、ローカルのワークフロー設計サブエージェントを呼び出し、関連するスキルファイル、ガイドファイル、計画ファイル、監査成果物を相対リンクで渡します。
6. スキルのパス外に WorkflowInstance のコピーを 1 つ作成し、その変更不可能なインスタンス ID と永続化されたランタイム状態／セッションのパスを記録してから、まったく同じコピーに対して compile を実行します。
7. 同じ WorkflowInstance のコピーを使って Loom Agent Plan-Execution Orchestrator を実行します。それ以降のすべての resume では、永続化されたランタイム状態を再利用する必要があります。
8. ブロック状態になった場合は、ペイロードのシグナルと prompt-replan を使ってシームノードを更新し、構造化されたエンベロープペイロードを指定して resume します。
9. 現在のルートがブロックされていることが確認された場合は、AO プランナーに再計画を依頼する前に、現在のワークフロー状態、ブロッカーレポート、試したすべての解決策とその結果、関連するイベント／監査参照を保存します。
10. 保持した履歴に基づき、明示的な戦略を選択して再計画します。現在の状態から続行する、未確認の設計ノードまでロールバックする、現在の状態から再設計する、計画全体を置き換える、または最小限の可逆的な回避策を適用します。
11. 実行を再開する前に、選択した場合はロールバックまたは回避策の経路も含め、ターミナルのビジネス成果に至る実行可能な経路をプランナーが返すよう求めます。
12. Loom Agent Plan-Execution Orchestrator が完了状態に達するまで、再計画と再開を繰り返します。
13. Loom Agent Plan-Execution Orchestrator が完了状態であり、要求されたビジネス成果物を検証できる場合にのみ、完了を報告します。

AO ワークフロー設計および AO weave-out 計画では、既存の有能なサブエージェントで weave-out の目標を達成できる場合は、汎用的なエージェントのプレースホルダーを出力するのではなく、既存のサブエージェントを優先してください。

プロンプトブロック、ペイロードの規約、ブロック状態の処理に関する運用上の詳細は、リファレンスドキュメントに定義されています。

必須の出力

• バインドされたランタイムバージョンの確認。導出したリリース版／ベータ版の根拠と、一致する正規リンクを含めます
• ランタイムソースの選択と、バージョンから解決したチャネルのメタデータ
• パッケージチャネルのランタイム証拠：正確なパッケージ ID／バージョン／RID、ソース、検証済み SHA-512、nuspec／マニフェスト／アーカイブの検査結果、展開結果、apphost のパス、新規のガイド生成結果
• Windows PowerShell 5.1 を使用する場合の、パッケージチャネルのランタイム取得に関する事実：ZIP ベースの .nupkg 展開パス、HTTP プローブモード、展開またはガイド生成に失敗した場合のフェイルファスト証拠
• ワークフロー／セッション／イベントのパスと監査成果物へのリンク
• サブエージェントの呼び出しごとの名前付きエージェントへのディスパッチ記録：正確な frontmatter 名、.agent.md へのリンク、ルート（direct または driver-fallback）、引き渡しモード（inline または path-only）、フォールバックのトリガー証拠、ドライバーによる名前のエコー
• workflow.compile-feedback.json と共有の workflow.compile-feedback.v1 の結果。解析／検証ステータス、件数、フェーズのブロッカー、候補のパス／ハッシュ、AO ランタイムの識別情報／バージョンを含めます
• Git ワークツリー外、または無視されるワークスペースミラー内にある、ワークフロー、フィードバック、監査、Mermaid、HTML ファイルを含む、すべての出力成果物の検証済み実パス
• ガイドハブ、フロー、リファレンスの各パス。固定の guide_path ハブは 200 行以下にします
• ランタイムと監査の更新に必要な、指定された「考えながら進める」フィールド
• ao.exe や ao の呼び出しを含め、AO の apphost 呼び出しまたは監査を生成するステップの後は毎回、Mermaid 成果物の配信に従ってください。実際に返された監査パスと読み取り可能性を検証してから、「考えながら進める」更新を開始し、検証済みの Mermaid、HTML、Analysis、Dataflow の順に、Markdown リンクと text フェンスの組み合わせを記載します。各タイトルは、完全な絶対検証済みランタイムファイルアドレス（Windows ドライブパスまたは Unix の絶対パス）へのリンクにし、/ に正規化します。その直後に、本文に同一の完全なアドレスのみを含む text フェンスを置きます。このペアの形式と成果物の順序を厳守してください。ワークスペース相対アドレスの使用、短縮、省略、切り詰め、ラベルやコメントのフェンス内への追加は禁止です。ファイルが出力されていない、または検証されていない場合は、配信失敗／継続ルールを適用し、そのアドレスを捏造しないでください。このブロックの後に、実行の確信度と推定全体進捗の見出しを ## でこの順に記載し、それぞれに短い理由を 1 つ添えます。確信度は、依頼された作業を正常に完了できる可能性を推定します。推定全体進捗は、依頼全体のおおよその完了度を測ります。どちらも検証済みの証拠に基づけてください。固定の計算式やしきい値はありません。また、いずれの割合も必須の完了確認に代わるものではありません。現在または最新の検証済みパスのみを使用してください。not_emitted の場合は、レンダリングに変更がないことを伝えます。delivery_failed の場合は、リンクや再利用をせず、失敗と次の対応を報告します。ユーザー向けのテキストは平易にし、現在のやり取りの言語を使用してください。
• ビジネス優先モードが適用される場合の、ビジネス成果物の検証サマリー
• runtime_path_only の場合は、固定の成果物レポートに検証済みの完全な絶対アドレスを記載します。link_resolvable=true の場合に限り、別途ホスト／エディターで開く操作に検証済みワークスペースミラーを使用できます。レポートのアドレスを置き換えたり、省略したりしないでください

出力マトリックス全体とフィールド単位の仕様については、リファレンスドキュメントを参照してください。

禁止される結果

以下のいずれかを示す、または暗示する実行結果は却下するか、無効として扱ってください。

• 公式なスキル実行ではAOは任意である
• このスキルには、AOと別の経路が公式な実行モードとして並列で存在する
• 呼び出し側が業務成果物を明示的に要求した場合に、AOのランタイム成果物だけで最終完了として認められる
• 業務成果物の要求が、明示的なユーザーの承認なしに、ランタイム／メタデータのみの実行へひそかに格下げされる
• compile、--guide、または補助的なシェル手順が通常のスキル実行モードである
• compile、--guide、prompt-plan、prompt-replan、または補助的なシェル手順が通常のスキル実行モードである
• AO以外の出力が公式なスキル実行履歴として認められる
• AO以外のテストが公式なスキル実行の証拠として認められる
• 説明文のフローや例だけで公式な実行権限が生じる

完了条件

以下のすべての条件が満たされるまでは、実行が適切に管理されていると見なさないでください。

• Windowsではao.exe run／ao.exe resume、Unixではao run／ao resumeを直接実行する場合に限り、公式なスキル実行として扱う
• アプリホストから直接実行するcompile、--guide、prompt-plan、prompt-replanは、準備または検証のための手段に限る
• スキルレベルの履歴は、AOのワークフロー状態、セッション状態、イベントログ、または監査成果物からのみ取得する
• ブロッカーの履歴には、ブロックされたノード、ブロッカーの理由、試みた操作、その結果、証拠への参照、選択した再計画の起点／戦略を保持する
• プランナーには保持された履歴を入力として渡し、失敗した試みや過去の経路判断をひそかに破棄してはならない
• 再計画では、選択した起点から最終的な業務上の成果までの経路を宣言し、回避策ごとに1ステップで戻せる計画を維持しない限り、無効とする
• スキルレベルのチェックリストは、AOのワークフローノード、フロンティア、遷移、ブロック状態、再開ポイントからのみ取得する
• スキルレベルの実行マップは、AOランタイムのworkflow_file、next_frontier、ブロック状態、監査成果物からのみ取得する
• スキルレベルの証拠は、AOが所有するランタイム状態と監査成果物からのみ取得する
• AO以外のテストは、公式なスキル実行の証拠として扱わない
• 説明文のフローや補助コマンドの例は説明のみを目的とし、実行権限を持たない
• 呼び出し側の目的で業務成果物が明示的に要求されている場合、対応する業務成果物がなければ、AOの完了状態だけでは不十分とする

禁止例／承認例の詳細は、リファレンスドキュメントで管理されています。