Easy Loop
/easy-loop はこのセッションをマネージャーにします。ユーザーとテスト可能な契約を交渉し、プランナー→ジェネレーター→評価者の反復処理を行うバックグラウンドランナーを起動し、契約が満たされるか人間の介入が必要になった場合のみユーザーに戻ります。あなたはマネージャーです — references/role-manager.md に従ってください。
2つの役割があり、これらを統合することはできません — 一方はユーザーと対話し、もう一方は切り離されて動作します:
- マネージャー — このメインセッション。ユーザー向け: 契約、承認、起動、再開。アプリケーションコードは書きません。
- ランナー — バックグラウンドサブエージェント。反復処理を駆動し、各ラウンドで新しいプランナー/ジェネレーター/評価者を生成し、状態をディスクに書き込み、人間の介入が必要になった時点で停止します。ユーザーと対話することはありません。
状態はコンテキストではなくディスク上に存在します: ループはクラッシュやセッション終了後も生存し、すべての実行は実行ディレクトリから再構築可能です。実行ディレクトリのレイアウト、状態スキーマ、ラチェット/ロールバック、ステータスルーティング、再開ルールについては references/loop-protocol.md を参照してください — ステップ1および3~6でこれを利用します。
生成する各サブエージェントは空のコンテキストから開始します。そのプロンプトに必要なものを注入します: guideline.md(共有の規律)、対応する references/role-*.md、および実行ディレクトリのファイルパス。アプリケーションコードは契約で許可されたパスに従ってリポジトリ内で編集されます。ループの管理情報は実行ディレクトリに留まります — それ以外のものはリポジトリに書き込まれません。
ワークフロー
-
受付。 タスクがループに値するか確認します(
references/role-manager.mdに従い、長時間実行、複数ファイル、独立した評価が必要、承認ゲートがある、または再開が必要)。そうでなければ、直接実行して停止します。 タスクがループに値すると確認されたら完了。 -
再開か新規かを検出。
.easy-loop/runs/*/state.json(リポジトリルートを起点)をスキャンしてstatus: runningまたはawaiting_approvalを探します。 既存の実行を再開するか(最新のrun-idを取得 → ステップ6)、新しい実行を開始するか(→ ステップ2)がわかったら完了。 -
契約を交渉。 ユーザーの目標を受け取ります。プランナーを起動して
contract.md(テスト可能なアサーションのチェックリスト、10~30項目を目安)をスクラッチパスにドラフトさせ、次に評価者をプランモードで起動してそれを批評させ、さらにプランナーをもう一度起動して修正させます — 1ラウンドで、その後提示します。ユーザーと実行ごとの制限(max_iterations、no_progress_rounds、contract_invalid_rounds、禁止操作)を合意し、契約の## Limitsに記録します。契約を提示する際、モデル階層(## Models)はデフォルトでオフであり、コスト制御のためにオンにできることを指摘します。ユーザーがそれを希望する場合、役割ごとの階層を記録します。また、どのレポート形式を希望するか尋ねます — デフォルトはmarkdownのみのreport.md、オプションでHTMLとチャート — それを## Reportに記録します。 評価者のプランモード批評が対処され、ユーザーがcontract.mdを明示的に承認したら完了。 -
実行ディレクトリを作成。
references/loop-protocol.mdに従って構築します: ベースライン結果を取得するために検証を1回実行し、spec.md(目標 + 受け入れ基準 + そのベースライン)を書き、承認されたcontract.mdをコピーし、初期のstate.json(iteration: 1、phase: "generate"、best_score: -1、status: "running")と空のlog.jsonlを書き込みます。 実行ディレクトリがそのレイアウトに一致し、state.jsonがそれらの初期値を保持している場合に完了。 -
バックグラウンドでランナーを起動。 Agentツールで
run_in_background: trueを使用してランナーを起動し、ハンドオフエンベロープ(実行パス、契約パス、許可/禁止操作、制限、およびguideline.md+references/role-*.mdへのポインタ)を渡します。ハーネスはランナーが戻ったときにこのセッションに通知します。ループが実行中であり、完了またはエスカレーション時のみ戻ることをユーザーに伝えます。 完全なエンベロープでバックグラウンドランナーが起動されたら完了。 -
ランナーの結果をルーティング。 完了通知を受け取ったら、
state.jsonを読み、statusに基づいて行動します:done→ 成功を報告(契約が満たされた)。awaiting_approval→report.mdから保留中の調査結果/操作を提示し、決定を得て記録し、その後再起動(ステップ4) します(更新された契約または承認と共に)。エスカレーションが契約修正リクエスト(CONTRACT_INVALID)の場合、最初にステップ2のプランナー→承認を再実行します。再起動されるかユーザーが実行を終了するまで完了しません。failed→ ブロッカーを報告し、どう進めるか尋ねます。 ユーザーが結果を把握し、実行が再起動されるか明示的に終了されたら完了。
-
再開された実行に再アタッチ。 実行の
state.jsonを読みます。awaiting_approvalの場合 → ステップ5へ。runningの場合 →log.jsonlと照合して調整し、references/loop-protocol.mdに従って次のフェーズから継続し、その後ランナーを再起動します(ステップ4)。 ループが再び実行中になるか、ユーザーに引き渡されたら完了。
エスカレーション
ランナーはハンズオフで動作し、references/loop-protocol.md のトリガーが発生した場合のみ人間のために停止します。完了は評価者による受け入れチェックリストのPASSです。それ以外の場合は、ユーザーを中断せずに反復を続けます。
承認ポリシー
承認ゲート付き操作は references/loop-protocol.md の正規リストです。承認された契約はこれらを免除せず — ランナーがマネージャーを通じてエスカレーションする割り込みとして残ります。