エージェントへのプロンプトをやめよう：AIコーディングエージェントを調整するループを設計する
手動でのプロンプトから、AIコーディングエージェントを調整するループシステムの設計へ移行しましょう。パターン、CLIツール、5分で始めるクイックスタートを紹介します。
なぜループエンジニアリングが重要なのか
Peter Steinberger 氏はその変化を完璧に捉えています：「もうコーディングエージェントにプロンプトを送るべきではありません。エージェントにプロンプトを送るループを設計すべきです。」 Anthropic の Claude Code 責任者である Boris Cherny 氏もこれに同調しています：「私はもう Claude にプロンプトを送っていません。Claude にプロンプトを送り、何をすべきか考えさせるループを動かしています。私の仕事はループを書くことです。」
てこのポイントは、個々のプロンプトを作成することから、時間をかけてエージェントを調整する制御システムを設計することに移りました。これが ループエンジニアリング の核となるアイデアです。これは、自動化されたエージェント駆動のワークフローを構築するための実践的な方法論です。
ループエンジニアリングとは？
ループエンジニアリングは、手動でエージェントにプロンプトを送るあなたの役割を置き換えます。代わりに、あなたはシステム、つまりループを設計し、それがあなたの代わりにプロンプトを送ります。このシステムはタスクをスケジュールし、状態を管理し、隔離された環境で実行し、リスクのあるアクションを人間の承認の後ろにゲートします。
参照リポジトリ cobusgreyling/loop-engineering は、Grok、Claude Code、Codex、Cursor、OpenClaw などの AI コーディングエージェントとこのアプローチを実装するための実践的なパターン、CLI ツール、スターターを提供します。
5つの構成要素 + メモリ
すべてのループは、5つのプリミティブとメモリ/状態レイヤーで構成されています：
| プリミティブ | ループ内での役割 |
|---|---|
| 自動化 / スケジューリング | 発見 + トリアージを定期的に実行 |
| ワークツリー | 安全な並列実行 |
| スキル | 永続的なプロジェクト知識 |
| プラグイン & コネクタ | 実際のツールへのアクセス (MCP) |
| サブエージェント | 作成者 / 検証者の分割 |
| + メモリ / 状態 | 会話の外にある永続的な基盤 |
これらのプリミティブはループの構造を形成します：
flowchart LR
A[Schedule / Automation] --> B[Triage Skill]
B --> C[Read + Write STATE / Memory]
C --> D[Isolated Worktree]
D --> E[Implementer Sub-agent]
E --> F[Verifier Sub-agent<br/>tests + gates]
F --> G[MCP / Git / Tickets]
G --> H{Human Gate?}
H -->|safe / allowlisted| I[Commit / PR / Action]
H -->|risky / ambiguous| J[Escalate to human<br/>with full context]
I --> A
J --> A
プロダクションパターン
リポジトリには、7つのプロダクション対応のループパターンが含まれており、それぞれに定義された周期、スターターテンプレート、推定トークンコストがあります：
| パターン | 周期 | トークンコスト |
|---|---|---|
| デイリートリアージ | 1日～2時間 | 低 |
| PRベビーシッター | 5～15分 | 高 |
| CIスイーパー | 5～15分 | 非常に高い |
| 依存関係スイーパー | 6時間～1日 | 中 |
| チェンジログドラフター | 1日またはタグ | 低 |
| マージ後クリーンアップ | 1日～6時間 | 低 |
| イシュートリアージ | 2時間～1日 | 低 |
どれを選べばいいかわからない？ インタラクティブパターンピッカー を使用するか、patterns/registry.yaml を参照してください。
CLIツール：5分で始める
リポジトリには、npm で公開されているいくつかの CLI ツールが含まれています：
- loop-init: スターター + 予算/実行ログ + 制約をスキャフォールド
- loop-audit: ループ準備スコア CLI (v1.5 + 制約スコアリング)
- loop-cost: トークン消費見積もりツール
- loop-sync: STATE.md と LOOP.md の間のドリフト検出
- loop-context: 長時間実行のためのステートフルメモリマネージャー + サーキットブレーカー
- loop-mcp-server: パターン、スキル、状態の MCP ランタイムルックアップ
クイックスタート
# 1. スキャフォールド + ループ準備スコアを取得（自動的に表示）
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
# 2. 周期に基づいてトークン消費を見積もる
npx @cobusgreyling/loop-cost --pattern daily-triage --level L1
# 3. 改善後に再監査
npx @cobusgreyling/loop-audit . --suggest
# オプション：ループ準備バッジを README に貼り付け
npx @cobusgreyling/loop-audit . --badge
# 4. スコアが上がるのを見る：空 → L1 → L2
bash scripts/before-after-demo.sh
# 5. レポートのみで開始（Grok の例）
/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.
すべての CLI はタグ付きリリースから npm に公開されています。クローンは不要です。
運用と安全性
ループエンジニアリングは判断力を増幅します——良い判断も悪い判断も。主な注意点：
- トークンコスト はサブエージェントや長時間実行ループで爆発的に増加する可能性があります。
- 検証は依然としてあなたの責任です。 無人ループは無人ミスを犯します。
- 理解の負債 は、ループが送り出すものを読まない限り、より速く増大します。
- 同じループを実行しても、2人が逆の結果を得ることがあります。 ループはそれを知りません。あなたが知っています。
Addy Osmani 氏が言うように：「ループを構築しなさい。しかし、単に実行ボタンを押す人ではなく、エンジニアであり続けるつもりの人のように構築しなさい。」
リポジトリには、障害モード、アンチパターン、マルチループ調整、安全性（拒否リスト、自動マージ、MCP スコープ）に関する詳細なドキュメントが含まれています。
貢献
このプロジェクトは貢献、特に障害事例やプロダクションパターンを歓迎します。貢献のはしごや初心者向けイシューバックログについては、CONTRIBUTING.md を参照してください。
結論
ループエンジニアリングは、AI コーディングエージェントを扱う開発者にとってパラダイムシフトです。手動でプロンプトを送る代わりに、スケジューリング、状態管理、安全ゲート、コスト認識を備えた、時間をかけてエージェントを調整するシステムを設計します。このリポジトリのツールとパターンは、今日このアプローチを実装するための実践的な出発点を提供します。