🔄 ループエンジニアリング教科書

はじめての方は、まず 「やさしい入口」(start.html) から読むのがおすすめです(3-5分で概要を掴めます)。

プロンプトを書くのが仕事 — ではなく、ループを書くのが仕事

2026年6月、AI活用の主戦場は「上手なプロンプト」から「自律的に回るループの設計」へ移った。本書は、Addy Osmaniが体系化した「ループエンジニアリングAIに都度指示を出す自分を置き換え、自律的に回る仕組みを設計する考え方。プロンプトの上手さではなく構造で差がつく」を、概念 → 設計 → 自分の実践 → 運用と移行の4部で読み解く、自分自身のための学習・実践整理の教科書。

生成元: 解説動画 + Web調査 + 自分のClaude Code環境の棚卸し

第1部 概念(なぜループか)

Googleのエンジニア Addy Osmani が2026年6月に体系化した概念。一言で言えば:

ループエンジニアリングとは、エージェントにプロンプトを出す自分自身を置き換えること。代わりにそれを行うシステムを設計することだ。
— Addy Osmani「Loop Engineering」

従来は人間がAIに1回ずつ指示を出し、結果を見て、また次の指示を出す — これを繰り返していた。ループエンジニアリングは、この「指示を出す役割」そのものを AIが自律的に次のタスクを考えて実行し続ける仕組み(=ループ) で置き換える。

「ループ」とは何か

ここでのループは、単なる繰り返し処理ではない。while 文のように、AIが 目標達成まで自律的に回り続けるサイクル を指す。人間は各反復で指示を出すのではなく、ループ全体を設計する。

📎 Addy Osmani原典「Loop Engineering」

ループエンジニアリングは突然現れたのではなく、AI活用の進化の到達点。各段階で「人間が工夫する対象」が移り変わってきた。

① Prompt ② Context ③ Harness ④ Loop
段階人間が工夫する対象前提
① Prompt Engineering指示文の工夫1回のやり取りで大当たりを狙う
② Context Engineering文脈の管理(何をAIに見せるか)コンテキスト窓の設計
③ Harness Engineering環境整備(ガードレール・ツール・監視)AIを包み込む実行基盤
④ Loop Engineering自律ループ全体の設計指示役から降りる

重要なのは、プロンプトの質だけで差がつかなくなったこと。上手な指示を1回出すより、失敗して自己修正しながら一歩ずつ進むループ を組む方が、不確実な現実では安定する。

Cat Wu(Claude Code Head of Product)の3段階フレーム

BorisとともにClaude Codeを率いるCat Wuは、上記4段階モデルをより実務的に圧縮した3段階で語っている: source code → agent → loop。「最初はコードを直接編集していた。次はエージェントにコード編集を頼むようになった。今は /loop/goal・routineがClaudeにプロンプトを出してくれる」(Boris Cherny)。4段階モデルに対応させると、②Context・③Harnessが「agent」フェーズに、④Loopがそのまま「loop」フェーズにあたる。

📎 The Neuron「Claude Code Creators Boris Cherny & Cat Wu Explain Agent Loops」

この概念を最も体現しているのが、Anthropicの Boris Cherny — Claude Codeの作者(責任者)。彼は自身の仕事をこう表現した:

私の仕事はプロンプトを書くことではない。ループを書くことだ(My job is to write loops, not individual prompts)。
— Boris Cherny, Anthropic

Claude Codeという製品自体が、この思想の結晶。ユーザーが都度指示を出すチャットツールではなく、hooks・cron・subagent・スキル・MCPを組み合わせて 自律的にタスクを回す基盤 を提供する。

何が変わるか

「良いプロンプトを書く人」から「良いループを設計する人」へ。プロンプトエンジニアリングが「過去の正解」になり、ループ設計がこれからの差別化要因になる。

実数値で見るBorisの「ループ生活」

これは比喩ではない。2025年11月、Borisは「使っていなかったから」自分のIDEをアンインストールしたと明かした。続く12月には、Claude Code + Opus 4.5だけで30日間に259件のPRをマージ(497コミット、+4万行/−3.8万行・全行Claude Code生成)— その間IDEを一度も開いていない。Stop Hookでループを組み、数分〜数日間(最長で1日18時間)連続稼働させるのが日常運用になっている。

📎 Cobus Greyling「Loop Engineering」(Boris発言を直引用) 📎 「Claude Code creator Boris Cherny landed 259 PRs in 30 days, all by Opus 4.5」(Hacker News)
人物所属役割
Addy OsmaniGoogle概念の体系化。2026/6/7のブログ投稿が起点。著書『Image Optimization』等で知られる Web パフォーマンスの専門家
Boris ChernyAnthropicClaude Code作者。「write loops, not prompts」の体現者
Peter SteinbergerOpenAI(2026年2月〜)OpenClaw創業者。シリコンバレーのAI界隈で概念を普及。2026年2月にOpenAI入社を発表、OpenClaw自体は特定企業に支配されない「OpenClaw Foundation」へ移管され、OSSとしての独立運営を継続
Cobus Greyling(分析者)実装パターンを整理。GitHub に CLI ツールとスターターを公開
📎 cobusgreyling/loop-engineering(実装パターン集) 📎 TechCrunch「OpenClaw creator Peter Steinberger joins OpenAI」
第1部のポイント ループエンジニアリングは「プロンプトを1回書く」ではなく「AIが自走する仕組みを組む」考え方。プロンプトの上手さではなく、ループ全体を設計できるかが従来のAI活用との分岐点になる。

第2部 設計(ループの中身)

自律ループは5つの構成要素で成り立つ。いずれかが欠けるとループは止まるか暴走する。

要素意味欠けると
① Clear goal明確で検証可能な目標いつ終わるか分からない
② Context management反復間で状態・文脈を維持毎回ゼロからやり直し
③ Verification自己評価・出力の検証間違いに気づけない
④ Tool useツール・テストの実行能力実際の環境に触れない
⑤ Termination conditions停止条件の定義無限ループ・コスト爆発

DataScienceDojo はこれを「trigger + verifiable goal」— エージェントが目標達成まで人間の追加指示なしに回り続ける構造 — と要約している。進化の系譜としては ReAct パターンの延長。

📎 DataScienceDojo「Agentic Loops: From ReAct to Loop Engineering」

Claude Codeには /goal(条件達成まで自動継続)と Routines(クラウドでスケジュール実行)というネイティブ機能がある。これらは「ループを動かす便利なツール」だが、「ループエンジニアリング」の本体ではない。

ツールが担える範囲

6要素/goalRoutines
自動継続(Automations)✅ 担当✅ 担当
作業の分離(Worktrees)❌ 設計が必要❌ 設計が必要
知識の永続化(Skills)❌ 設計が必要❌ 設計が必要
外部連携(Connectors)❌ 設計が必要❌ 設計が必要
作者と検証者の分離(Sub-agents)❌ 設計が必要❌ 設計が必要
状態の外部化(Memory)❌ 設計が必要❌ 設計が必要

/goal と Routines は「Automations(自動継続・スケジュール)」の1ピースを担うだけで、残り5要素は依然として自分で設計する必要がある。ツールを使えばループが完成するわけではない。

Boris が言う「ループを書く」の実体

「ループを書く」とは、ツールの設定を記述することではない。小さな制御系(control system)を設計することだ。Borisの言う「ループ」は、作業を自ら見つけ・割り当て・検証し・状態を記録し・次の作業を決める自律的な制御の仕組みを指す。

制御系の設計には、3つの問いに答える必要がある。

  • 何の作業を、どの順序で、どのエージェントに渡すか(ディスパッチの設計)
  • 「完了」とは何かを機械的に証明できる形で定義できるか(停止条件の設計)
  • 失敗・暴走をどこで、どう止めるか(安全ガードの設計)

この3つを設計しない限り、/goal を使っても「とりあえず動くが止まり方が分からないループ」になる。

条件文を書くことが核心スキル

/goal も Stop Hook も、条件文の質でループの信頼性が全部決まる。 評価モデルは「会話のトランスクリプト」しか見ないため、条件文は「Claude 自身の出力で証明できるもの」に限られる。ファイルシステムの直接参照やコマンドの独立実行はできない。

種類理由
❌ 悪い「コードが良くなったら」証明不能。評価モデルが判断できない
❌ 悪い「品質が向上したら」定量的な出力がない
✅ 良い「test/auth配下の全テストがパスしlintが0エラー」テスト結果がトランスクリプトに出力される
✅ 良い「state.jsonのpendingが空配列になる」ファイル内容をClaude自身が出力できる
✅ 良い「git statusがクリーンで変更ファイルが10件以下」コマンド出力がトランスクリプトに残る
「完了」を書けなければ、ループではなく願望だ。
— Addy Osmani(意訳)

補足: /goal は Claude Code v2.1.139 以降で利用可能。Stop Hook の session-scoped ラッパーとして実装されており、disableAllHooks が設定されている環境では使用不可。また ANTHROPIC_BASE_URL を外部プロバイダに差し替えた構成(GLM/MiniMax等)での動作は未確認。

5要素を支える 土台。AIはセッションごとに記憶を失うため、この土台が無いと文脈維持(②)も自己修正(③)も成り立たない。

記憶の外在化

「今どこまで進んだか」「次に何をやるか」「何に失敗したか」を 外部ファイル(状態ファイル) に書き残し、次の反復・次のセッションがそれを読み込んで引き継ぐ。AIの記憶を、AIの外側に置く設計。

ループを回すのはAIだが、ループを繋ぐのはファイルだ。

これが無いと、毎セッション「前提を説明し直す」無駄が発生し、ループの自律性が崩れる。

具体例: Ralph Wiggumテクニック

「記憶の外在化」を最も極端な形で実践したのが Ralph Wiggumテクニック。Geoffrey Huntleyが考案した、while :; do cat PROMPT.md | claude-code; done という単純な無限ループで、AI自身のコンテキストウィンドウには何も保持させず、進捗・仕様・修正計画はすべてファイルとgitコミット履歴に外在化する。2026年初頭、Ryan Carsonがこの手法をスレッドで紹介し(86万ビュー超)、界隈に爆発的に広まった。

このテクニックは不確実な世界において、決定論的に「下手」であることを選ぶ。予測不能に成功するより、予測可能に失敗する方がいい。
— Geoffrey Huntley(意訳)
📎 Geoffrey Huntley「Ralph Wiggum as a "software engineer"」

ループ設計における最重要ベストプラクティス。

なぜ分けるか

同じAIに「コードを書かせて、それをそのままチェックさせる」と、どうしても 判断が甘くなる。自分の書いたものに甘くなるのは人間と同じ。だから役割を物理的に分ける:

  • 作るAI — 修正案・コードを生成する
  • 検証AI — プロジェクトの規約・既存テストに照らして、厳しく採点する

検証AIは「作るAIとは別のコンテキスト・別の指示」で動く。これで初めて、本物のコードレビューと同じ緊張感が生まれる。Claude Code では subagent(code-reviewer・silent-failure-hunter 等)がこの役割を担う。

/goal 自体もこの原則の適用例。作業したClaude が「完了か否か」を自己判定せず、別モデル(Haiku等)が判定する。

自律ループが1日をどう回すか、概念図(元動画の実演)。

🌅 朝 — 自動実行とタスク抽出

人間の指示なしにタイマーで起動。「状況整理AI」が前日の失敗ビルド・残課題・最近のコード変更を読み込み、「今日やることリスト」を自動生成してファイルに書き出す。

☀️ 昼 — 作業部屋の分離と相互検証

各タスクに独立した作業部屋(干渉しないコンテキスト)を用意。作るAIが実装 → 完了後 検証AI が規約とテストで厳格に自動検証。

🌇 夕 — 外部連携とエスカレーション

検証通過したものを MCP 経由でチケット更新・PR作成・チャット通知。AIだけでは解けない難題は「人間の判断を仰ぐボックス」に仕分け(無理に進めない)。

🌙 夜 — 状態の保存

1日の成果・うまくいったこと・残課題を状態ファイルに保存。翌朝、AIがそれを読み込んで記憶が引き継がれる。

第2部のポイント ループは5要素と土台で成り立つ制御系。/goal や Routines などのツール単体では回らず、目標・検証・停止条件・状態記録を自分で設計して初めて自律ループが成立する。

第3部 実践(自分の環境マップ)

「ループエンジニアリング」という概念は遠い存在ではない。自分のClaude Code環境は 既にこのループを実践している。5要素と土台を、実際の実装に対応させた。

5要素・土台自分の実装
① Clear goalGitHub Issue・handoffの「次にやること」・バックログ
② Context managementgit worktree(作業部屋の分離)・CLAUDE.md(プロジェクト固有ルール)
③ Verificationsubagent(code-reviewer / silent-failure-hunter / type-design-analyzer)・テストスイート
④ Tool useMCP(brave-search / github / playwright / context7)・hooks(PreToolUse安全チェック等)
⑤ Terminationnext-issue.py(pending空で停止)・state.active=false
🟪 土台: 状態の記録handoff.md・SSOT日記・state.json・memory

つまり Boris の「write loops, not prompts」は、自分の環境の ~/.claude/ の中に既に書かれている。この教科書は、その実践を言語化し直す作業でもある。

第6章の観点から補足すると、ツール(/goal・Routines)の有無にかかわらず、上記の制御系を設計できていることがループエンジニアリングの本質。ネイティブ機能はあくまで「Automationsの自動継続」を楽にする道具であり、state.json・next-issue.py・Stop Hook連鎖による自前実装は、それと同等かそれ以上の制御系を構成している。

Tier A(端末ハーネス)/ Tier B(プラットフォームランタイム)— 自分の環境はどちらか

Cobus Greylingは続編「Loop Engineering Playbook」で、ループの実行環境を2段階に分類している。

Tier定義代表例向いている規模
Tier A: 端末ハーネス開発者の端末で /loop 等を直接実行。sub-agent・skill・MCPコネクタがローカルで完結Claude Code、Grok Build個人・小規模チーム
Tier B: プラットフォームランタイム隔離されたサンドボックス(microVM)上で永続実行。クラッシュ後も状態を復元できるcheckpoint型の実行基盤LangChain / LangSmith Sandboxes本番・マルチテナント

自分の環境(Claude Code をターミナルで運用)は Tier A。第13章のStep 4〜5は依然Tier Aの範囲内であり、複数テナント・本番SaaS化が必要になった時点でTier Bへの移行を検討する、というのが現実的な判断基準になる。

📎 Cobus Greyling「Loop Engineering Playbook」

2026年時点で、ループエンジニアリング・パターンを組み込んだ主な実装の比較。

観点OpenClawClaude CodeCodex
提供元Peter Steinberger(OSS、2026/2〜OpenAI入社・OpenClaw Foundationへ移管)Anthropic(Boris Cherny)OpenAI
位置づけループの象徴的実装・界隈普及の起点hooks+cron+subagent+skill+MCPで自律基盤OpenAI系コーディングエージェント
ループの担い手OSレベルの自動化層SessionStart/Stop hooks・自律タスクループエージェント実行ループ(内部)
状態の記録進捗や次の作業を外部ファイルに書き残す土台。AIはセッションごとに記憶を失うので、これがないと文脈が切れる外部ファイルhandoff.md・memory・日記セッション状態

The AI Corner の分析では、Claude Code と Codex は どちらも2026年にループエンジニアリング・パターンを出荷済み。違いは、Claude Code が hooks/cron/skill/MCP を ユーザー側で組み立てられる基盤 として公開している点(自分の環境がまさにそれ)。

📎 The AI Corner「Loop Engineering: Build Self-Running Coding Agents 2026」
第3部のポイント 概念は遠いものではなく、自分のClaude Code環境(hooks・worktree・handoff・subagent・MCP)に既に実装済み。既有の資産を5要素で言語化し直すこと自体が、ループエンジニアリングの実践になる。

第4部 運用と移行

ループは強力だが、放っておくと3つの罠に落ちる。

① 検証 — 人間の目が必須

AIの自己検証は甘くなる(第8章)。最終的な「これで出してよいか」の判断は人間が持つ。自動化が進むほど、この最終チェックをサボりたくなるが、そこが一番危ない。

Peter Steinbergerはこれを the agentic trap人間が早すぎるタイミングでループから手を引くと、tasteのない大量のslop(低品質量産物)が生まれる罠(エージェント的な罠)」 と呼ぶ — 人間が早すぎるタイミングでループから手を引くと、AIは一晩中動き続けても「テイスト(taste)」を持たないため、結局は大量の「slop(質の低い量産物)」しか生まれない。仕様を最初に全部書き切って後は丸投げ、という発想そのものが罠になる。

AIはスパイキーに賢く優秀だが、うまく導かなければ結局slopになる。正しい問いを投げかけなければ、それもslopになる。
— Peter Steinberger(意訳)
📎 Peter Steinberger「the agentic trap」関連インタビュー

② コスト — 並行処理で計算コスト増大

ループは(特にマルチエージェントで)並行して回る。サブエージェントを多数起動すると、トークン消費が爆発する。停止条件(第5章⑤)と予算上限の設計が必須。

理解の借金AIが高速生成したコードを人間が説明できない状態。放置すると利息がつき、最終的に破産する — AIが超高速生成し、人間がシステムを説明できなくなる

これが最も恐ろしい。AIが人間を置き去りにしてコードを生成し続けると、人間側が「システムが中で何をやっているか説明できない状態」に陥る。この 理解のギャップ(借金) は利息がつく。返済(コードを読む力)をサボると、いずめ破産する。

ループが自動化を担うほど、コードを読む力(Python基礎学習等)が重要になる。自動化と理解はトレードオフではない — 自動化を安全に回すために理解が要る。

いきなり完全自律ループは組めない。段階的に5ステップで移行する。

段階やること人間の関与
Step 1プロンプトの再利用化(スキル化・Markdown化)毎回指示(ただし定型化)
Step 2状態の記録を始める(handoff・ログ・日記)記録の設計のみ
Step 3自己検証の導入(subagent・テスト自動実行)検証結果の確認
Step 4ツール連携(MCP・hooks・通知)例外時のみ
Step 5完全自律ループ(cron・Stop Hook で次タスク起動)監督・最終判断のみ

自分の環境は Step 4〜5 に到達している。残る課題は「理解の借金」の返済(Step 3 の検証を人間が追える程度に、コードを読む力を保つこと)。

本番パターン7選(頻度・コスト目安)— どのStepから始めるか

Cobus Greylingの続編「Loop Engineering Playbook」では、実際に本番投入されているループを7パターンに整理し、頻度とリスク(≒コスト)目安を示している。

パターン頻度リスク/コスト目安
PR Babysitter5〜15分
CI Sweeper5〜15分
Issue Triage2時間〜1日
Daily Triage1〜2日
Post-Merge Cleanup6時間〜1日
Dependency Sweeper6時間〜1日
Changelog Drafter1日

頻度が高い(5〜15分間隔)パターンほど暴走時のトークン消費リスクが大きく、「3回失敗したら人間にエスカレーション」という上限設計(第12章②)が必須になる。Step 2〜3(状態記録・自己検証)が固まっていないうちは、まず低頻度・低リスクのDaily Triage / Changelog Drafterから始め、Tier A環境(第10章)で実績を積んでからPR Babysitter等の高頻度パターンに広げるのが安全。

📎 Cobus Greyling「Loop Engineering Playbook」

ループが実行を担うからこそ、人間は 「ただ実行ボタンを押すだけの人」に退化してはならない

人間の新しい役割

  • 全体の俯瞰 — ループの健全性・方向を監視する
  • 最終判断 — 「これで出してよいか」の最後の砦
  • ループの設計改善 — 止まったループの原因究明・再設計
  • 審美眼 — 何を実行し、何を差し止めるかの倫理的・品質的判断
AIが高速に仕事をこなすようになればなるほど、何をさせるかを決める人間の判断が、最大の武器になる。

これは「コードを読めない素人だから関係ない」ではない。むしろ、非IT出身でループを組んでいるからこそ、コードを読む力を意図的に鍛え続ける ことが、理解の借金を防ぐ唯一の道。

資料内容
Addy Osmani「Loop Engineering」概念の原典(2026/6/7)。すべての起点
Cobus Greyling「Loop Engineering」Boris Cherny 発言の直引用あり。Claude Code哲学との対応
The AI CornerClaude Code / Codex のループ実装を比較
Lushbinary5要素の実践ガイド
DataScienceDojoReAct → Loop Engineering の系譜
cobusgreyling/loop-engineering実装パターン・CLIツール・スターター(GitHub)
Claude Code /goal 公式ドキュメント条件文の書き方・評価モデルの仕組み
Claude Code Routines 公式ドキュメントスケジュール・API・GitHub Webhookトリガー
解説動画「ループエンジニアリングを知ってみよう」本書の素材元。【アイ】のAIでできるチャンネル・2分7秒
Cobus Greyling「Loop Engineering Playbook」(続編)7本番パターン・Tier A/Tier B分類
The Neuron(Boris Cherny & Cat Wu)「source code → agent → loop」3段階フレーム
Geoffrey Huntley「Ralph Wiggum as a "software engineer"」状態の外在化を極端な形で実践する手法の原典
TechCrunch(Steinberger × OpenAI)OpenClaw Foundationへの移管の経緯
Peter Steinberger インタビュー「the agentic trap」「slop」「taste」の概念
Hacker News(Boris Cherny 259 PRs)30日259PR・IDEアンインストールの実数値

関連ガイド(自分の環境)

第4部のポイント ループが回るほど人間の役割は「実行」から「監督・最終判断・審美眼」へ移る。自動化を安全に回すためにコードを読む力を持ち続けること――それが「理解の借金」を返済する唯一の道。