WHAT IT REPLACES何を代替するか

1往復を磨くのをやめて、回し方と止め方を設計する

プロンプトを打つ

人が毎ターン指示を出す

  • 磨く対象は1往復の入力
  • 人が運転席にいる
  • 止まるのは人が止めたとき

ループを設計する

ループがエージェントに指示を出す

  • 磨く対象は停止条件と採点基準
  • 人は設計と見回りに回る
  • 上限・差分・予算で自動停止
出典: Peter Steinberger(X, 2026-06-07)、Boris Cherny(Acquired Unplugged, 2026-06-02)、Firecrawl(2026-06-11)

ループエンジニアリングという言葉は、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つの制御が連鎖して止まる

ループ

繰り返し

  1. 停止条件
  2. 再計画
  3. 予算ゲート
  4. 自己修正
  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. 1.反復上限

    最大何周まで。max_iterations / recursion_limit など、物理的な天井

  2. 2.差分ゼロチェック

    直近の差分が動かなければ止める。同じ場所の堂々巡りを検出

  3. 3.スペンドキャップ

    トークン・ドルの上限。超えたら強制停止か昇格

出典: Firecrawl「Loop Engineering」(2026-06-11)。Uber は1人・1ツール月1,500ドルの上限を導入(TechCrunch, 2026-06-02)

実例がある。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)