Jig Orchestrate
契約
Jigの現在の設計契約に基づき、実行指向の作業を調整します。このスキルはローカル構成の実行ブックであり、Jigランタイムの実装、CLI、プロバイダアダプタ、レコードストアではありません。承認された入力、現在のツールサーフェス、ポリシー姿勢、記録可能性の範囲内でのみ、人間/Codexアシスト実行を整理します。
実行計画がスコープを所有します。実行計画には、docs/design/contracts/execution-plan-contract-v0.mdに記述されたストーリーセット、依存関係、作業境界、完了および証拠要件、権限要件、ポリシー/ワークプロファイル/リポジトリフロア参照、制約、互換性姿勢がすでに含まれている必要があります。このスキルは、拒否、バインド、スケジュール、停止、報告を行う場合があります。ストーリーを発明したり、依存関係を修正したり、ポリシーを弱めたり、受理基準を追加したり、完了の証拠を選択したり、範囲外のサーフェスを再解釈したり、欠落している計画の事実をランタイム決定に変換したりしてはいけません。
レコードが証拠です。すべての管理された決定、承認、停止、証拠の観察、レビュー結果、ランナー所有アクションは、真として扱われる前にdocs/design/contracts/observability-records-contract-v0.mdに従って記録可能でなければなりません。別のナラティブ、チャットサマリー、チェックリスト、ワーカーレポートが記録可能な証拠パケットを上書きすることは決してありません。
リファレンス境界
退役したworkflow-kitオーケストレーション配信スキルは先行技術のみです。Jig自身の契約を維持する場合にこれらの教訓を活用します。
- ディスパッチ前に実行入力をプレフライトする;
- 計画中ではなく、プレフライト後にランタイム事実をバインドする;
- ワーカーが生成した変更とランナー所有の特権アクションを分離する;
- 完了または確定状態の前に独立した証拠を要求する;
- 不足する機能を推測せずに、回復可能な名前付き停止を残す。
workflow-kitの実行パッケージパス、トラッカースキーマ、ストーリーごとのプロンプトフォルダ、モデルルーティングテーブル、プロバイダパッケージレイアウト、v-nextブランチポリシー、古いPR公開ルール、古いランタイムクレームをインポートしないでください。先行技術のルールがJigのv0計画または記録プロパティにマッピングされない場合は、それを無視し、代わりに停止または設計ギャップを指定します。
入力
ワーカーディスパッチまたは特権アクションの前にこれらすべてが必要です。
execution-plan-contract-v0と互換性のある承認済み実行計画;- 計画がバインドするポリシー参照、ワークプロファイル参照、リポジトリフロア参照;
- 要求された境界で開始またはプレビューするための所有者の承認;
- 実行場所の現在のリポジトリ/ワークツリーの事実;
- 開始、実行、または確定境界の場合: Agent、Execution Host、Forge、Work Sourceの現在のドライバ/シームの事実、または必要なシームを検査できない場合は明示的な停止;
- プレビューのみの境界の場合: 実行ID、ワークスペース割り当て、プロバイダ配線、特権サイドエフェクトを必要とせずに
run.previewedを記録するのに十分なバインディング事実; - 計画とポリシーからの現在の検証コマンドと証拠要件;
- このローカル実行のために
observability-records-contract-v0プロパティを保存できるレコードパス、レコードストア、または耐久性のあるレコードパケット形式。
不明なランタイム事実は、検査されるまで不明のままです。欠落している計画の事実はランタイム事実ではありません。それらは計画プレフライトの失敗です。
プレフライト
ディスパッチ、編集、プッシュ、PR、マージ、ステータス投稿、またはJigが開始したという主張の前にこのゲートを実行します。
- 触れたサーフェスについて、リポジトリの指示と信頼できるソースのドキュメントが読み込まれたことを確認する:
AGENTS.md、docs/product/jig.md、docs/product/guarantees.md、docs/product/concepts.md、docs/design/README.md、docs/design/contracts/execution-plan-contract-v0.md、docs/design/contracts/observability-records-contract-v0.md、docs/design/core/orchestration.md、docs/design/core/records.md。 - 計画が所有者または所有する計画ステップによって承認されていることを確認する。承認がない場合は、
plan-not-approvedとして停止する。 - 計画がv0必須プロパティを保持していることを確認する:
- 計画IDと来歴;
- トラックバインディング;
- ストーリーセット;
- 依存関係と適格性モデル;
- 完了と証拠要件;
- 権限と承認の必要性;
- ポリシーとワークプロファイル参照;
- スタックシーム要件;
- 制約と制限。
- 計画のバージョンまたは互換性マーカーが理解されていることを確認する。そうでない場合は、
plan-format-unsupportedとして停止する。 - 選択された各ストーリーに安定したID、意図された境界、依存関係リスト、証拠要件、権限期待があることを確認する。選択されたストーリーがランナーまたはワーカーにスコープの推測を求める場合は、
plan-scope-incompleteとして停止する。 - 依存関係の順序が計画を書き換えずに導出できることを確認する。グラフが循環、矛盾、または発明された順序を必要とする場合は、
plan-dependency-invalidとして停止する。 - ポリシー、ワークプロファイル、リポジトリフロアの参照が存在し、要求された実行と互換性があることを確認する。それらが欠落している、互換性がない、または起動時ポリシーを弱める場合は、
binding-input-missingとして停止する。 - 要求された境界がサポートされていることを確認する: プレビュー、ローカル実行調整、証拠収集、ランナー所有公開、または停止。プレビューは非コミット: ロード、検証、バインド、記録可能な
run.previewedイベントが必要だが、実行ID、ワークスペース、プロバイダ、特権サイドエフェクトは不要。ユーザーが現在のリポジトリに存在しない実際のJig動作を要求する場合は、jig-runtime-unavailableとして停止する。
プレフライトは、提案された実行シーケンス、拒否、または名前付き停止を生成できます。計画を修復してはいけません。
ランタイムバインディング
プレフライト合格後、現在の事実のみをバインドします。
- ワークツリーパス、リポジトリルート、ブランチ、ベース、クリーン状態;
- 有効なポリシー、ワークプロファイル、リポジトリフロア参照;
- 計画グラフからの選択されたストーリーと現在適格なストーリー;
- 現在の検証コマンド、レビュー要件、能力証明要件;
- 現在の所有者承認状態と要求された停止境界;
- 開始、実行、または確定境界の場合: Agent、Execution Host、Forge、Work Sourceドライバの可用性とアテステーション姿勢;
- プレビューのみの境界の場合: プロバイダ配線を強制せずに、プレビューバインディング姿勢と記録可能な
run.previewedベース; - レコード保存先またはレコードパケットの場所とその編集/エクスポート姿勢;
- 現在のサーフェスで利用可能なランナー所有アクション(プッシュ、PR作成、ステータス/コメント投稿、マージなど)。
起動前にこれらのバインディングを記録します。起動バインディングは再開全体で不変です。再開は停止した実行から続行できますが、ポリシー、ワークプロファイル、リポジトリフロア、計画、ドライバの事実を静かに交換することはできません。変更された安全関連の前提は、続行する前に新しい所有者の承認と新しい証拠が必要です。
ランナーとワーカーの境界
docs/product/concepts.mdおよびdocs/design/core/orchestration.mdからの製品権限境界を維持します。
- ワーカーは、承認されたストーリー境界内でのみ、読み取り、編集、非特権チェックの実行、差分の生成、証拠の生成、ブロッカーの報告を行うことができます。
- ワーカーはプッシュ、PRのオープン/更新、ステータス/コメントの投稿、マージ、権限の拡大、ポリシーフロアの編集、ストーリーの確定マーク、または発生したことの権限としてレコードを作成してはいけません。
- ランナーは、適格性、承認、証拠評価、レコード、所有者エスカレーション、プッシュ、PR作成、ステータス/コメント投稿、マージ、停止、再開、エクスポートを調整します。
- 特権アクションには、ランナー権限に加えてポリシー/証拠ベースが必要です。ワーカーの自己報告では、特権アクションの完了を示すには不十分です。
- 宣言された権限外のリクエストは、クローズドフェイルするか、所有者にルーティングされます。暗黙のより広い許可になることは決してありません。
現在のサーフェスがこの分割を維持できない場合は、authority-boundary-unsupportedとして停止します。
調整ループ
新しい状態を追加せずに、計画グラフとJigライフサイクル用語を使用します。
- 計画と現在のレコードに従って、前提条件が確定されたストーリーのみを開始します。
- 不適格なストーリーは待機させます。ワーカーに独自の依存関係決定を求めないでください。
- 適格なストーリーについては、ストーリー境界、計画参照、権限期待、証拠要件、検証コマンド、非目標、変更制限を添えてワーカーをディスパッチします。
- ワーカー出力は、提案された作業と証拠として扱い、状態権限としては扱いません。
- ランナーまたは委任されたレビュー担当者によって観察されたポリシー準拠の証拠からのみ、完了を評価します。
完了と確定を別々のマイルストーンとして保持します: 証拠が満たされた場合、ストーリーは完了できますが、マージはレビュー、ブランチ保護、競合、キュー、所有者境界によって保留されます。- 必要な証拠、所有者/レビュー担当者の承認(必要な場合)、レコード追加/パケット準備がすべて成功した後でのみ、ランナー所有アクションを通じて確定します。
- ストーリーがブロックされた場合は、理由と影響を受ける下流ストーリーを記録します。ポリシーと能力が許す場合、独立した兄弟は続行できます。
将来のJig設計契約が導入しない限り、トラッカー、ストーリーパッケージ、プロンプトパッケージ、マージバックモデルを追加しないでください。
証拠とレコードゲート
状態遷移または管理された決定を受け入れる前に、要求された境界に適用されるv0プロパティを持つ記録可能なパケットを準備します。
- コミットされた開始/再開/実行パスの場合: 実行ID、試行ID、計画参照、トラック参照、ポリシー/ワークプロファイル/リポジトリフロア参照、ドライバコンテキスト;
- プレビューのみのパスの場合: 実行IDまたはドライバコンテキストを発明せずに、計画参照、トラック参照、ポリシー/ワークプロファイル/リポジトリフロア参照、非コミットの
run.previewedベース; - Jigの現在のイベントファミリー高度を使用したイベントファミリーと結果;
- 責任のあるアクターまたはコンポーネント: ワーカー、ランナー、所有者、委任されたレビュー担当者、またはドライバ;
- ベース: ポリシールール、証拠観察、承認、能力証明、以前のイベント、または計画参照;
- 該当する場合はストーリーID;
- 編集/エクスポート姿勢;
- リプレイまたは再開に十分な順序情報;
- ブロック、停止、通知、再開チェックポイント、または二重効果なしのベース。
自動チェック、レビュー、能力アテステーションは、観察されるか、独立して検証される必要があります。証拠が欠落している、古い、自己報告のみ、検証不可能、または記録不可能な場合、ストーリーは完了しておらず、evidence-insufficientとして停止する必要があります。
停止
即席の実行よりも名前付き停止を優先します。停止レポートには、停止名、影響を受ける実行またはストーリー、失敗したゲート、記録可能なベース、利用可能な安全な再開チェックポイント、および次の所有者アクションを含める必要があります。
より具体的な計画所有の名前が存在しない限り、これらの停止名を使用します。
plan-not-approved— 承認された実行計画または開始承認がありません。plan-format-unsupported— 計画の互換性マーカーまたは形状が不明です。plan-scope-incomplete— 選択されたストーリーのスコープ、境界、証拠、権限の必要性が欠落しています。plan-dependency-invalid— 依存関係グラフを記述されたとおりに実行できません。binding-input-missing— ポリシー、ワークプロファイル、リポジトリフロア、互換性参照が存在しないか、互換性がありません。jig-runtime-unavailable— 要求された動作には、現在のローカルドライランCLI(jig preview/jig run/jig inspect)を超えるJigランタイム機能が必要です。driver-capability-unavailable— 必要なAgent、Execution Host、Forge、Work Source機能を証明できません。authority-boundary-unsupported— 現在のサーフェスがランナー所有の特権アクションと制限されたワーカー権限を維持できません。records-store-unavailable— 耐久性のあるレコードストアまたは記録可能なパケットがv0レコードプロパティを保存できません。evidence-insufficient— 必要な証拠が欠落、検証不可能、古い、または自己報告のみです。owner-decision-required— ポリシーが狭い決定を所有者にルーティングします。safety-reapproval-required— ルール統治または安全関連の入力が再開または確定前に変更されました。
停止は有効な結果です。欠落している条件がJigの制御、証拠、回復、または監視可能性の保証の一部である場合、停止を警告に軟化しないでください。
出力
トランスクリプトダンプではなく、コンパクトな実行台帳を返します。
- 計画参照と選択されたストーリーID;
- バインドされたポリシー、ワークプロファイル、リポジトリフロア参照;
- 検査されたランタイム事実と未解決のままの不明な事実;
- 記録可能な適格、開始、停止、ブロック、完了、確定、拒否、停止、再開、または完了状態;
- 観察された証拠と実行された検証コマンド;
- 実行された、または明示的に行われなかったランナー所有アクション;
- 停止名、理由、安全な再開チェックポイント、次の所有者アクション;
- レコードパケット/ストア参照と編集姿勢;
- 所有するJig設計/計画サーフェスにルーティングバックされた未サポートの機能または設計ギャップ。
主張された状態に対して記録可能な証拠が存在しない場合は、その状態を未検証として報告し停止します。