| 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 |
