harness-loop

name	harness-loop
description	Long-running task loop using /loop (Claude Code dynamic mode) and ScheduleWakeup to re-enter with fresh context on each wake-up. Internally invokes harness-work through Agent. Trigger: long-running, loop, wake-up, autonomous. Do NOT load for: one-shot task execution, review, release, planning.
description-en	Long-running task loop using /loop (Claude Code dynamic mode) and ScheduleWakeup to re-enter with fresh context on each wake-up. Internally invokes harness-work through Agent. Trigger: long-running, loop, wake-up, autonomous. Do NOT load for: one-shot task execution, review, release, planning.
description-ja	長時間タスクを /loop と ScheduleWakeup で wake-up 毎に fresh context で再入実行。harness-work を内部で Agent 呼び出し。長時間、ループ、loop、wake-up、autonomous に対応。
kind	workflow
purpose	Re-enter long-running Plans.md execution with fresh context
trigger	long-running, loop, wake-up, autonomous
shape	delegate
role	orchestrator
base	harness-work
pair	harness-sync
owner	harness-core
since	2026-05-05
allowed-tools	["Read","Edit","Bash","Task","ScheduleWakeup","mcp__harness__harness_mem_resume_pack","mcp__harness__harness_mem_record_checkpoint"]
argument-hint	[all|N-M] [--max-cycles N] [--pacing worker|ci|plateau|night]
user-invocable	true

harness-loop

/loop（CC dynamic mode）と ScheduleWakeup を組み合わせ、 長時間タスクを wake-up 毎に fresh context で再入実行 するメタスキル。

各 wake-up で harness-work --breezing を Agent 経由で呼び出し、 1 サイクル = 1 タスク完結の再入可能ループを構成する。

Long-session helpers (CC 2.1.108+): 人が戻ってきたら /recap で要約を取り直してから /harness-loop status を見る。 長めの離席や再入が多い運用では ENABLE_PROMPT_CACHING_1H=1 を優先する。

長時間セッション推奨 (CC 2.1.108+): セッション長が 30 分を超える見込みの場合、plugin bundle root 解決後に bash "${HARNESS_PLUGIN_ROOT}/scripts/enable-1h-cache.sh" を実行して 1 時間 prompt cache を opt-in すること。

Codex 0.123.0 automatic bug fix inheritance: manual shell follow-up queue と /copy after rollback は Codex 本体の TUI 修正として自動継承する。 loop runner は追加入力 queue、copy wrapper、rollback workaround を追加しない。 長時間作業中に manual shell へ follow-up を投げた時の queueing は Codex runtime に任せる。

Quick Reference

入力	動作
/harness-loop all	全未完了タスクをループ実行（default: max 8 サイクル）
/harness-loop all --max-cycles 3	3 サイクルで停止
/harness-loop 41.1-41.3 --pacing ci	タスク範囲を CI pacing で実行
/harness-loop all --plan roadmap	named Plans の roadmap を対象にループ実行
/harness-loop all --pacing night	深夜バッチ（3600s 間隔）
/harness-loop status	進行中ランナーの状態確認
/harness-loop stop	進行中ランナーの停止要求

オプション

オプション	説明	デフォルト
all	全未完了タスクを対象	-
N-M	タスク番号範囲指定	-
--plan NAME	plans/manifest.json の named plan を使う	active/default