WHAT IT REPLACES何を代替するか
1往復を磨くのをやめて、回し方と止め方を設計する
プロンプトを打つ
人が毎ターン指示を出す
- 磨く対象は1往復の入力
- 人が運転席にいる
- 止まるのは人が止めたとき
ループを設計する
ループがエージェントに指示を出す
- 磨く対象は停止条件と採点基準
- 人は設計と見回りに回る
- 上限・差分・予算で自動停止
ループエンジニアリングという言葉は、6語のツイートから広まった。2026年6月7日、PSPDFKit創業者のPeter Steinberger氏が6語のツイートを投げた。「You shouldn’t be prompting coding agents anymore. You should be designing loops that prompt your agents.」(もうコーディングエージェントにプロンプトを打つな。エージェントにプロンプトを打つループを設計しろ)。Firecrawlは表示回数が数日で200万を超えたと報告している。
ループエンジニアリングとは、AIエージェントの「観測→思考→行動→反省」の繰り返し(agent loop)を、どこで止め、いつ計画を立て直し、いくらまで使うかまで含めて設計する考え方だ。ここでは、その骨格をClaude Codeで動く最小構成まで落とし、harness engineeringとの違いも整理する。
30秒でわかるループエンジニアリング
- ・磨く対象は1往復のプロンプトではなく、何周回し、どこで止めるか
- ・制御は5軸:停止条件・再計画・予算ゲート・自己修正・エスカレーション
- ・最大のリスクは止まらないループ。反復上限・差分チェック・スペンドキャップの3ガードが要る
- ・Harness(足回り全体)の一部品で、反復制御に絞った下位概念
- ・まだ新しい用語で、定義は書き手ごとに揺れている
関連記事:Claude Codeそのものの導入は Claude Code|2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き にまとめている。
ループエンジニアリングとは——agent loopを設計対象にする
きっかけは、コーディングエージェントの使われ方が「対話」から「委任」へ移ったことだ。Claude CodeやCodexが /loop・スケジュール実行・worktreeを備え、人が席を外しても作業が進む。関心は「どう指示するか」から「回り続ける仕組みをどう設計するか」へ移った。
Claude Code作者のBoris Cherny氏は、WorkOSの「Acquired Unplugged」(2026-06-02)でこう語っている。「I don’t prompt Claude anymore. I have loops that are running. They’re the ones that are prompting Claude and figuring out what to do. My job is to write loops.」
回し続ける以上、止め方を決めないと請求額が先に破綻する。エージェントは通常のチャットの約4倍、マルチエージェントでは最大15倍のトークンを消費すると報告されている。
ループには2つの形がある。Shann Holmberg氏が整理した軸だ。
| 形 | 止まり方 | 向くタスク | 落とし穴 |
|---|---|---|---|
| クローズドループ | 回数を固定(最大20ステップ、3回まで自己修正) | 形が決まったパイプライン | 難所で早すぎる打ち切り |
| オープンループ | 停止条件が満たされるまで(テストが全部通るまで) | 経路が読めない探索 | 条件を誤ると永遠に回る |
回す前に、タスクを3問で仕分ける。繰り返し発生するか。成否を機械的に判定できるか(テスト・型・差分)。自動化で浮く時間がトークン代を上回るか。1つでもNOなら、ワークフローか手作業のほうがよい。
プロンプト・ワークフロー・ループの違い(cron jobとの差)
Redditのr/myclawでは「結局、帽子をかぶったcron jobだろ」という冷笑も出た。仕組みがwhileループに近いのは事実だ。違いは最適化の対象にある。Firecrawlの3列比較を日本語にした。
| 観点 | プロンプト | ワークフロー | ループ |
|---|---|---|---|
| やること | 1ターンの入力を書く | 分岐ロジックで多段呼び出しを連鎖 | エージェントに指示を出す仕組みを設計 |
| 自律性 | なし | 中(事前定義の段) | 高(停止条件まで自走) |
| 最適化の対象 | プロンプト | チェーン | ループと採点基準(ルーブリック) |
cron jobが最適化するのはスケジュール、ループエンジニアリングが最適化するのは「何をもって良しとし、いつ止めるか」という判断基準だ。そこにモデルの非決定性と検証が絡む。
AIエージェントのループ設計5軸と、主要OSSの実装
停止条件・再計画・予算・自己修正・エスカレーションの5軸は、複数の一次ソース(Steinberger、Cherny、Osmani、Firecrawl、MindStudio、TrueFoundry)の共通点を編集部が整理した枠組みで、公式の分類ではない。
FIVE AXESループ制御の5軸
ループは5つの制御が連鎖して止まる
ループ
繰り返し
- 停止条件
- 再計画
- 予算ゲート
- 自己修正
- エスカレーション
5軸は連鎖する。停止条件が発火しなければ再計画し、予算を超えれば昇格し、それでもだめなら人へ渡す。源流は論文にある。ReAct(arXiv:2210.03629)が推論と行動を折り返す原子的なループを定義し、Reflexion(arXiv:2303.11366)がその外側に自己反省のループを巻いた。Reasoning in Token Economies(arXiv:2406.06461)は、multi-agent debateやReflexionが計算予算を増やすとかえって悪化しうると示した。「もっと回せば良くなる」とは限らない。
各軸は、すでにOSSがプリミティブとして持っている。
| OSS | 停止条件 | 予算・昇格 | 自己修正 | 人の割り込み |
|---|---|---|---|---|
| Vercel AI SDK | stopWhen / stepCountIs(既定20) | prepareStepでモデル切替 | — | tool approval |
| LangGraph | recursion_limit / 条件付きエッジ→END | — | 条件分岐で再試行 | interrupt() / Command(resume) |
| OpenHands | max_iterations / StuckDetector | — | エラー反復の検出 | 要承認操作 |
| Aider | max_reflections(既定3) | — | reflected_messageで自動修正 | /run・/test手動 |
| cascadeflow | quality_threshold | budget / switch_model | 品質検証で再実行 | enforceモード |
OpenHandsのStuckDetectorは、同じ行動が同じ観測を4回以上生む、同じ行動が3回以上エラーになるといったパターンを意味内容ベースで検出して止める。cascadeflowは小型モデルで試し、品質検証に失敗したら大型モデルへ昇格する(cascadeflow解説)。
ループエンジニアリングで止まらないループを防ぐ3つのガード
Firecrawlは「Without all three, what you are running isn’t a loop. It’s an open invoice.」(3つすべてがなければ、それはループではなく開いた請求書だ)と書く。
THREE GUARDS止まらない対策
3つのガードが揃わなければ、それは開いた請求書
-
1.反復上限
最大何周まで。max_iterations / recursion_limit など、物理的な天井
-
2.差分ゼロチェック
直近の差分が動かなければ止める。同じ場所の堂々巡りを検出
-
3.スペンドキャップ
トークン・ドルの上限。超えたら強制停止か昇格
実例がある。TechCrunch(2026-06-02)によれば、Uberは年間のAI予算を4か月で使い切った後、1人・1ツールあたり月1,500ドルの上限を導入した。対象はClaude CodeやCursorなどだ。
金額に出ない負債もある。Addy Osmani氏は理解負債(Comprehension Debt)を、システムにあるコード量と人が理解しているコード量のギャップと定義した。ループが自走でコードを積むほど、このギャップは開く。
Claude Codeで組む——builder・checker・停止ルール
darkzodchi氏のX記事(2026-06-16)は、5軸の最小実装を4ファイルで示している。作る役(.claude/agents/builder.md、実装と修正だけ)、検査する役(.claude/agents/checker.md、test→types→lintを走らせ、失敗は実エラーをそのまま報告)、回す役(.claude/commands/loop.md、build→check→失敗ならbuildへ戻る。最大5周)、止める役(CLAUDE.md)だ。オーケストレーターにopus、実働役にsonnetを割り当て、判断は強いモデル、反復は安いモデルという予算の切り方もしている。
止める役の中身が肝になる。エージェントの停止条件は、同氏の場合は次の4行になる。
## Loop stop rules
- ALL GREEN: every check passes. Stop and report success with proof.
- 5 cycles used: stop. Report what still fails and what was tried.
- Same failure twice in a row: stop. The builder is guessing, not
fixing. Escalate to me.
- A fix makes a previously passing check fail: stop.
Never weaken or delete a check to reach ALL GREEN.
| ルール | 埋める軸 |
|---|---|
| ALL GREEN/5周で停止 | 停止条件・予算 |
| 同じ失敗が2連続で人へ | エスカレーション |
| checkerの失敗をbuilderへ戻す | 自己修正・再計画 |
| 回帰したら停止 | 差分・安全側の停止 |
builderとcheckerを分けるのは、自分の仕事を自分で甘く採点するバイアスを断つためだ。ここに載せた設定は同氏の公開内容の引用で、当サイトで実走はしていない(未検証)。
Harness Engineeringとの違いと、第6の軸メモリ
Harness Engineeringはモデル以外のランタイム全体を設計し、ループエンジニアリングはそのうち反復の制御だけを扱う。全体像は ハーネスエンジニアリングとは何か——5つの流派と設計思想を整理する を参照。Firecrawlは本番のループを、トリガー(開始と停止)・worktreeによる隔離・SKILL.mdなどのコード化された文脈・writer/reviewerの分業・MCPコネクタ・プラグイン・永続メモリの7要素に分けた。見落とされやすいのは分業と永続メモリだ。
mem0の公式X Article(2026-06-17)は、長時間のループの律速は知能でもツールでもプロンプトでもなくメモリだと主張する。自動圧縮は後で要る情報を落とし、フラットな MEMORY.md は肥大化するという論旨で、ベンダー自身の主張である点は割り引いて読む。
本家 cobusgreyling/loop-engineering の中身
用語をパターン集・CLI・スターターまで体系化しているのが cobusgreyling/loop-engineering(MIT)だ。★9,634・フォーク1,317は2026-07-30時点の記録値。リポジトリを2026-11-05に浅いcloneで確認すると、次の構成だった。
| 場所 | 中身 |
|---|---|
patterns/ |
daily-triage、thin-loop、pr-babysitter、ci-sweeper、dependency-sweeper、changelog-drafter、post-merge-cleanup、issue-triageの8型。registry.yamlで機械可読 |
tools/ |
17ディレクトリ。loop-init、loop-audit、loop-cost(コスト可視化)、loop-gate、loop-worktree、loop-swarm、mcp-serverなど |
starters/ |
パターン別のひな形。minimal-loopはclaude・codex・opencodeの3系統 |
| ルート | gate.yaml、loop-budget.md(停止と予算の実体) |
READMEは npx @cobusgreyling/loop init . --pattern daily-triage --tool claude で始め、初週は報告のみ(report-only)で回すよう勧める。このコマンドは実行しておらず未検証。以前の版より tools/ は2つ増え、thin-loop パターンも加わっている。
当サイトの記事品質ループ(Loop Engineering実践ツールキット解説 も参照)も、ここのEvaluator-Optimizerを翻案したものだ。
まとめ——宣言から設計へ
AIループは判断を増幅する装置で、採点基準に雑な判断を込めれば雑な成果が増える。着手は、3問で仕分け、5軸を決め、3ガードを必ず入れる順で足りる。用語はまだ過渡期で、Harness EngineeringやContext Engineeringとの境界も流動的だ。当サイトは提唱者ではなく、一次ソースを出典付きで整理する立場をとる。
参照ソース
・Firecrawl — Loop Engineering: Should You Stop Prompting Agents and Start Designing Loops
・Peter Steinberger — X投稿
・Shann Holmberg — X投稿(open loop / closed loop)
・Boris Cherny — Acquired Unplugged presented by WorkOS(YouTube)
・darkzodchi — How to Build a Claude Code Agent Team That Runs in Loops
・Addy Osmani — Comprehension Debt / Loop Engineering
・TechCrunch — Uber caps employee AI spending
・Reddit r/myclaw — So is “loop engineering” the next AI dev buzzword?
・mem0 — Loop Engineering Works On Memory
・cobusgreyling/loop-engineering(GitHub)
・Vercel AI SDK — Loop Control / OpenHands — Agent Stuck Detector / Aider — Linting and testing / cascadeflow
・ReAct(arXiv:2210.03629) / Reflexion(arXiv:2303.11366) / Reasoning in Token Economies(arXiv:2406.06461)





