| name | harness-loop |
| description | HAR: Codex-native long-running loop runner. Uses a real background runner that executes one ready batch per cycle through Breezing by default, with status/stop controls. Trigger: long-running, loop, autonomous, background, Codex. Do NOT load for: one-shot implementation, normal review, release. |
| description-en | HAR: Codex-native long-running loop runner. Uses a real background runner that executes one ready batch per cycle through Breezing by default, with status/stop controls. Trigger: long-running, loop, autonomous, background, Codex. Do NOT load for: one-shot implementation, normal review, release. |
| description-ja | HAR: Codex 専用の長時間ループ実行。実際のバックグラウンドランナーが ready batch を Breezing で進め、status / stop で監視できる。長時間、loop、ループ、autonomous、background、Codex で起動。 |
| kind | workflow |
| purpose | Run long-lived Codex ready-batch execution loops |
| trigger | long-running, loop, autonomous, background, Codex |
| shape | delegate |
| role | orchestrator |
| base | harness-work |
| pair | harness-sync |
| owner | harness-core |
| since | 2026-05-05 |
| allowed-tools | ["Read","Bash"] |
| argument-hint | [all|TASK|START-END|START..END] [--max-cycles N] [--max-workers N|max] [--executor breezing|task] [--pacing worker|ci|plateau|night] |
| disable-model-invocation | true |
Harness Loop
Codex 版の harness-loop は、説明だけの擬似ループではなく、
実際にバックグラウンドで回るランナーを起動する。
ひとことで
$harness-loop は、1 回だけの実装依頼ではなく、
「今すぐ実行できる未完了タスクのまとまりを、Breezing で自動実行し続ける当番」を起動する入口。
ここでいう ready batch は、Depends が満たされていて、今すぐ並列実行できる cc:TODO / cc:WIP のまとまり。
1 cycle は 1 task ではなく、原則として 1 ready batch を処理する。
たとえると
人が横でずっと見張る代わりに、
「同時に進められる作業をまとめて見つける → Breezing に任せる → 結果を確認する → 次のまとまりへ進む」
を繰り返す監督係を、裏で常駐させるイメージ。
Quick Reference
| 入力 | 動作 |
|---|
$harness-loop all | 未完了タスク全体を長時間ループで開始 |
$harness-loop 41.1-41.4 | 範囲を絞って開始 |
$harness-loop JLB3R-02..JLB3R-08 | Plans.md の task ID 順で範囲を絞って開始 |
$harness-loop all --max-cycles 3 | 最大 3 サイクルで停止 |
$harness-loop all --max-workers 4 | 1 cycle の ready batch を最大 4 worker までに制限 |
$harness-loop all --max-workers max | ready batch 内で実行可能なタスク数を上限として並列化 |
$harness-loop all --plan roadmap | named Plans の roadmap を対象にループ実行 |
$harness-loop all --executor task | 旧来の 1 task per cycle local worker 実行へ逃がす |
$harness-loop all --pacing night | サイクル間の待機を長めにする |
$harness-loop status | 現在の実行状況を確認 |
$harness-loop stop | 進行中ジョブを止めてループ停止要求を出す |
実行コマンド
開始
harness codex-loop start all
範囲指定:
harness codex-loop start 41.1-41.4 --max-cycles 5 --pacing worker
harness codex-loop start JLB3R-02..JLB3R-08 --max-cycles 5 --pacing worker
harness codex-loop start all --max-workers max --pacing worker
harness codex-loop start all --plan roadmap --max-cycles 5
harness codex-loop start all --executor task --max-cycles 5
START..END は、Plans.md に並んでいる task ID をそのまま使う範囲指定。
英字やハイフンを含む task ID は を優先する。
のような従来の数値レンジも引き続き使える。
