Looptimal — 成果オーケストレーター は何をしますか?
目標を納品され、検証された成果に変えます。承認基準を封印し、適切なループを選択または却下し、ウォーゲーム計画を立て、ドメインエキスパートが実行し、完了は独立した検証者が封印されたスイートをライブ状態に対して再実行することで判定します。自己申告のGREENには依拠しません。
ループ設計ウィザード(旧スタンドアロンのLoopPrint)は、ステージ2「ループ設計」として組み込まれています。成果のオーケストレーションを必要とせず、ループの設計図のみが必要な場合は、design という高速パスとしても実行できます。
使用するタイミング
- 「looptimal」「/looptimal」「アウトカムループを実行」「この目標を完了まで導く」「この目標を計画して出荷する」
- 「完了」をライブ状態に対して証明する必要があり、作業を行ったエージェントの自己申告では不十分な、非自明な目標。
- 複数ドメインにまたがる作業で、能力マニフェスト、合意された計画、そして成果レベルでのメーカー ≠ チェッカーが必要な場合。
- 定期的、監視付き、ラチェット型、またはオーケストレーションパターン(ループ設計で実際にループであることが確認された後)。
- 自律実行の前に、シミュレート機能で計画をウォーゲームしたい場合。
- 一度納品され、ライブ状態に対して証明される必要がある、単一の非自明な目標。もし制限付きの反復が必要なら、ミッション/ゴールランとしてルーティングします。1回の注意深いパスで十分なら、シングルパスモードを使用します(以下のモード分岐を参照)。
設計高速パスを使用するタイミング
- 「ループを設計」「ループを構築」「新しいループ」「ループウィザード」、または自動化したい曖昧な繰り返しタスク。
- ループの設計図(仕様+アーティファクト)のみが必要で、成果のオーケストレーションは不要な場合。
- 直接ステージ2(意思決定ゲート → ウィザード → アーティファクト生成)にジャンプし、そこで停止します。
使用すべきでないタイミング
- 自明な 単発の回答、簡単な編集、会話的な質問 → ツールは不要で、適切に一度実行するだけで十分です。(実質的な 単発目標で証明が必要な場合 — 自明ではないが定期的ではない — は、Looptimal全体をスキップする理由にはならず、以下のミッション/ゴールランまたはシングルパスにルーティングします。)
- 納品義務のない分析 → 直接回答するか、esat を使用します。
- 元に戻せない、判断重視のアクションで、GOゲートを担当する人間がいない場合 → 人間によるゲートプロセスを推奨します。
- メタループ(「LooptimalがGREENと言ったら自動マージする」など) → ループ設計で却下する必要があります。
- 行動指向の成果オラクルがない、症状のみの成功指標 → 再フレーミングするか、却下します。
運用ルール(最初に読むこと)
- これはスキルであり、ペルソナやモードではありません。1行の起動行で開始し、その後作業を行います。
- チェックポイントでゲート制御:フレーム → 分析 → ループ設計/ルーティング → 計画 → シミュレート — 各段階で簡単なステータス報告。シミュレート後の明示的な人間のGOがない限り、実行は開始されません。または、シングルパスモードの場合は、分析/ループ設計/計画/シミュレートのチェックポイントの代わりとなる簡単なプレモーテムの後です(以下のモード分岐を参照)。
- 元に戻せない操作は決して自動実行しない:本番デプロイ、送信、支払い、認証情報のローテーション、データ削除 — これらの前には人間によるゲートのみ。
- ハーネスから切り離し:バインドは
./.looptimal/profile.yaml→~/.looptimal/profile.yaml→scripts/looptimal-detect.py→ 汎用デフォルトの順で解決します。契約:references/agent-foundry.md。
起動行の例:
- フルパイプライン:「Looptimal — この目標を封印されたアウトカムループにフレーミングします。」
- 設計高速パス:「Looptimal — このループの設計図を作成します。」
- シングルパス:「Looptimal — ループなしで、この目標を1回検証して完了します。」
- 裸で呼び出された場合(目標なし):正確に1つの質問をします — 「完了したときに真であるべき成果は何ですか?」 — その後、以下のモード分岐に進みます。
- 目標がすでに与えられている場合:1行で認識し、その後以下のモード分岐に進みます。
モード分岐(フレームの前に — 低コストで一度だけ質問)
Looptimal のループ価値判断は意思決定ゲート(以下のウィザードのステップ1)ですが、現在はステージ2の奥深く、フレームと分析がすでに実行された後にのみ発動します。それらの作業が始まる前に、形状を決定します。
- 表現がすでに明確 — 質問をスキップ:
- 設計高速パスのトリガーワード(「ループを設計」「ループを構築」「設計図」「ループウィザード」) → 直接ステージ2へ。
- 明示的な単発表現で、有用な再試行を排除するもの(「シングルパス」「1回の注意深いパス」「再試行ループは不要」) → 直接シングルパスへ。
- 明示的な1回限りの納品表現で、検証者/再試行作業の可能性があるもの(「ワンショット」「Xを1回やる」「これを1回構築/修正/出荷する」) → フルパイプラインへ。意思決定ゲートがミッション/ゴールランとシングルパスのどちらを選択できるようにするため。
- 明示的な繰り返し/周期表現(「毎晩」「すべてのPRで」「これを新鮮に保つ」「継続的」) → 直接フルパイプラインへ。
- それ以外 — ステージ0に触れる前に、構造化された3択の質問を1つします:
- 一度実行し、証明する — 有用な再試行ループのない、単一の検証済み成果 → シングルパス。
- ミッションを実行するか、ループを構築する — 制限付き(ゲートに達するまで反復するミッション/ゴールラン — バグ修正、仕様適合、1回限りのビルド)または定期的(スケジュール/トリガーで無期限に実行) → フルパイプライン(ステージ0 → 1 → 2;意思決定ゲートがルート/アーキタイプ — タスク/定期/監視付き/永続ラチェット/オーケストレーション、ミッション/ゴールラン、またはハード却下 — を選択します)。
- ループの設計図だけ生成する → 設計高速パス(ステージ2のみ)。
これにより、意思決定ゲートがすでに行うループ価値判断を、ユーザー自身の判断として、事前かつ低コストで表面化させます。分析、ループ設計、計画が誤った形状ですでに消費された後にのみ到達可能になるのを防ぎます(フレームは選択されたモードに関係なく実行されるため、無駄にはなりません)。ステージ0/1の証拠が後で選択されたモードと矛盾する場合 — 「シングルパス」の目標が明らかに繰り返し発生するか、ゲートまでの反復を必要とすることが判明した場合、または「定期的システム」が意思決定ゲートを通過しない場合 — そのことを明確に述べ、ユーザーにリダイレクトを促します。ユーザーの選択を黙って上書きしたり、証拠が支持しないモードに黙って従ったりしないでください。
バインディングを解決(ステージ0の前奏)
python3 scripts/looptimal-detect.py # マーカーをプローブ、プロファイルを提案
# または ./.looptimal/profile.yaml → ~/.looptimal/profile.yaml を読み取り
state_dir、dispatch.maker、dispatch.checker、verifier.default、オプションのbannerを提供します。汎用デフォルト:loops/<slug>/、シェル検証者。
8段階パイプライン
| 段階 | 名前 | 役割 | 参照 |
|---|---|---|---|
| 0 | フレーム | 目標をハッシュで固定された封印承認スイートに変換します。すべての基準は成果(症状ではない)を表明し、ドメイン成果オラクルにバインドします。入力はメーカーが書き込み不可です。acceptance-suite.yaml + acceptance-suite.sha256 を出力します。 | references/pipeline.md |
| 1 | 分析 | 能力マニフェストとローカル能力準備状況インベントリを生成します:ドメイン、統合マップ、リスク、依存関係、利用可能なスキル/プラグイン/コネクタ/MCP/エージェント/データ。利害が大きい場合は、詳細な定義作業をesatに委任し、トリモデルストレステストを実施します。 | references/pipeline.md |
| 2 | ループ設計/ルーティング | ループ設計ウィザードを実行するか、目標をルーティングします。アーキタイプ — タスク(制限付き納品)、定期(スケジュールされた新鮮さ)、監視付き(ガードレール内での自律)、永続ラチェット(各パスが成果指標を厳密に改善)、オーケストレーション(マルチアクター/マルチリポジトリ)、ミッション/ゴールラン、シングルパス — を選択するか、検証不可能/メタループ/症状のみのケースに対してのみ却下します。 | references/pipeline.md |
| 3 | 計画 | 合意されたタスクグラフを構築します:ノード、依存関係、封印されたスイートに紐付いたタスクごとの承認フック、爆発半径タグ、ロールバックノート。 | references/pipeline.md |
| 4 | シミュレート | ループをNステップ進めます;障害モード(報酬ハッキング、サイレント障害、部分完了、環境ドリフト)のプレモーテム;計画を強化します。発見事項と封印されたスイートへの変更(再ハッシュ+ユーザー承認)を提示します。 | references/pipeline.md |
| — | 人間のGO | 実行に対する明示的な承認。上位リスク、元に戻せない操作、未解決の依存関係を表面化します。GOなし → 実行なし。 | references/pipeline.md |
| 5 | 実行 | バインディングプロファイルに従って動的ドメインエキスパートサブエージェントを起動します。反復ゲートではメーカー ≠ チェッカー。再開可能で冪等なステップ、部分的な障害に対するロールバックパス。元に戻せない操作に対する事前アクションゲート。 | references/pipeline.md |
| 6 | 検証-成果 | 独立したチェッカーが封印されたスイートをライブ状態に対して再実行します。ループの自己申告GREENは無視します。証拠バンドルでゲートされます。 | references/pipeline.md |
| 7 | 永続化 | 永続状態を書き込みます:目標ハッシュ、スイートハッシュ、成功/失敗した内容、オラクル結果、修復クラス、再開ポインタ、次回実行のための教訓。 | references/pipeline.md |
ステージ遷移(デフォルト)
- 0 → 1: 封印されたスイートが存在し、すべての基準にオラクルがあり、ハッシュが記録されている。
- 1 → 2: 能力マニフェストがすべての重要なドメイン、統合エッジ、およびローカル能力準備状況をカバーしている。
- 2 → 3: アーキタイプまたはミッションルートが選択された(または、正直な代替案とともにハード却下が発行された)。
- 3 → 4: タスクグラフが非循環であり、すべてのノードがスイート基準にフックされ、安全制限が設定されている。
- 4 → GO: シミュレーションレポートが配信され、計画が強化され、元に戻せない操作にタグが付けられた。
- GO → 5: 明示的な人間の承認が状態にキャプチャされた。
- 5 → 6: メーカーが反復完了を宣言 — 情報提供のみ、チェッカーが真実を所有する。
- 6 → 7: 証拠バンドルがGREEN;それ以外はFAIL、修復クラスと再開ポインタ付き。
再開
state_dir に以前の実行が存在し、目標ハッシュが一致する場合、最後の未完了ステージから再開します。目標が実質的に変更された場合は、再フレーム(新しいスイートハッシュ)。新しいループ設計/ルーティングなしでは、ハード却下をまたいで再開しないでください。
ステージ2 — ループ設計/ルーティングウィザード
ウィザードは4つの原子を強制し、ルート決定ゲートを実行し、その後分岐します。再利用可能ループルートは完全なLoopPrintアーティファクトパッケージを生成します。ミッション/ゴールランルートは route.md + ミッションパッケージ(ステージ3後の mission.yaml)を出力し、再利用可能ループの足場なしでステージ3の計画に進みます。シングルパスルートは route.md と軽いプレモーテムを出力し、シングルパス劣化パスに従います。これはフルパイプラインのステージ2に存在し、design 高速パスとして単独でも実行されます。
ウィザードエントリ
- フルパイプライン(ステージ2から呼び出される):目標はステージ0からの成果です。ステップ0.5にスキップします。
- 設計高速パス(直接呼び出し):1行の起動行で開始;目標が指定されていない場合は、最初に1つの質問をします。
ステップ0.5 — バインディングを解決
scripts/loopprint-detect.py を実行するか(または ./.loopprint/profile.yaml → ~/.loopprint/profile.yaml を読み取り)、state_dir、verifier.default、dispatch、marker_path、runner、banner を取得します。汎用デフォルト:loops/<slug>/、verify.sh。契約:references/profiles.md。ハーネス規則をハードコードしないでください。
ステップ1 — 意思決定ゲート(+ルート)
references/decision-gate.md のTier-0テストを実行します:4つの条件+30秒のチェックリスト。条件ごとに1行の理由を添えてルートを報告します。再帰性は再利用可能ループの償却テストであり、オーケストレーション全体のゲートではありません。非再帰的だが検証者バックアップのある作業は、ミッション/ゴールランまたはシングルパスにルーティングできます。外部検証者/人間のチェックポイントがない場合、目標が自己参照的/メタループである場合、または成功が症状のみで行動アンカーがない場合、ハード却下は必須です。
選択されたルートに基づいて直ちに分岐します:
- 再利用可能ループルート: ステップ2〜6を続行し、ループアーキタイプ/プロファイルを固定し、
loops/<slug>/を生成し、loopprint-lintを実行します。 - ミッション/ゴールランルート: ループプロファイルまたはアーティファクト生成を続行しないでください。ドライバー、状態アーティファクト、検証者、停止/予算、自律レベル、準備ギャップ、および再利用可能ループ設計図が生成されない理由を記載した
route.mdを出力します。その後、ステージ3の計画に進み、mission.yaml、task-graph.yaml、execute-scope.yaml、looptimal-lint.txtを出力します。 - シングル検証済みパスルート: ループプロファイルまたはアーティファクト生成を続行しないでください。検証者、状態アーティファクト、停止、準備ギャップ、および3シナリオの軽いプレモーテムを記載した
route.mdを出力します。その後、ステージ3/4の代わりにシングルパス劣化パスに従います。 - 人間ゲート付きワークフロールート: 人間のチェックポイントと外部チェッカーを記載した
route.mdを出力し、それらのゲートに一致する監視付きパスを通ってのみ続行します。 - ハード却下: 検証不可能/安全でない理由と正直な代替案を記載した
reject.mdを出力します。ユーザーが目標を再フレームしない限り停止します。
ステップ2 — 再利用可能ループ目標の洗練
対象を絞った3〜5の質問をします(それ以上は不要):
- 研ぎ澄まされた目標 — 1文、テスト可能。
- 再帰性/頻度 — 再利用可能ループが償却されることを確認します。
- 検証方法 — どの外部信号が反復の成功を示すか?
- 元に戻せないリスク — 元に戻せないものは何か?(→ 人間のチェックポイント)
- 自律レベル — 完全自律、チェックポイントゲート、またはドライラン?
ステップ3 — 再利用可能ループプリミティブの強制
各原子に具体的な値を強制します。曖昧なままにしておかないでください。
- 目標 — ステップ2からの1文の目標。
- 状態 — バインディングの
state_dirからの永続アーティファクトパス;記録する内容:試行ログ、失敗した内容、現在の仮説、コンテキスト。 - 検証者 — 正確な外部コマンドまたは指名されたレビュー担当者。唯一の提案されたチェックが同じエージェントによる自己評価である場合は、それを拒否し、実際のゲートを見つけてください。メーカー ≠ チェッカー。
- 停止 — 成功基準および安全制限(最大反復回数、トークン/時間予算、明示的な停止)。安全制限なしでループは出荷されません。
ステップ4 — 再利用可能ループプロファイルの選択
アーキタイプの完全なプロファイルを固定します — 作業パターン(references/patterns.md から)と検証者/停止形状:
- MORTY — 特定のバグ;検証者=再現テスト;最終...