harness-loop

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 は を優先する。 のような従来の数値レンジも引き続き使える。