AIBit - オープンソースプロジェクトの発見 AIBit - オープンソースプロジェクトの発見

ループエンジニアリング：AIコーディングエージェントをプロンプトする設計システム

AIエージェントに手動でプロンプトを入力するのはもう終わりにしましょう。パターン、CLIツール、メモリを使ってエージェントをオーケストレーションするループを設計し、本番環境対応の自動化を実現する方法を学びます。

ループエンジニアリング：AIコーディングエージェントをプロンプトする設計システム

もしあなたがまだClaude Code、Grok、Codexに手動でプロンプトを入力しているなら、活用できる力をテーブルに残していることになります。AI支援開発の次の進化は、より良いプロンプトではなく、エージェントにプロンプトを送るループを設計することです。

ピーター・スタインバーガーが言うように：「もうコーディングエージェントにプロンプトを送るべきではない。エージェントにプロンプトを送るループを設計すべきだ」。AnthropicのClaude Code責任者であるボリス・チェルニーもこれに同調しています：「私はもうClaudeにプロンプトを送っていない。Claudeにプロンプトを送り、何をすべきか判断させるループを動かしている。私の仕事はループを書くことだ」。

これが、Cobus Greylingによる実践的なリファレンスリポジトリであるループエンジニアリングの核となるアイデアです。このリポジトリは、エージェントオーケストレーションシステムを構築するためのパターン、スターター、CLIツールを提供します。Addy Osmaniのこのテーマに関する研究に触発され、Grok、Claude Code、Codex、Cursor、その他のAIコーディングエージェントを使用する開発者向けに設計されています。

なぜこれが重要なのか

活用のポイントが変わりました。個々のプロンプトを作成する代わりに、時間をかけてエージェントをオーケストレーションする制御システムを設計するようになりました。これは以下を意味します：

  • 定期的な自動化：エージェントはあなたが不在でもスケジュール（毎時、毎日、PR時）に従って実行されます。
  • 安全な並列実行：ワークツリーが変更を分離するため、エージェントが互いに干渉しません。
  • 永続的なプロジェクト知識：スキルファイルがプロジェクトの規約、アーキテクチャ、制約をエンコードします。
  • 実際のツール統合：MCP（モデルコンテキストプロトコル）コネクタにより、エージェントがGit、チケット、CIなどの実際のツールにアクセスできるようになります。
  • メモリと状態：会話の外にある耐久性のある基盤により、エージェントが実行間でコンテキストを忘れません。

5つの構成要素＋メモリ

リポジトリは、あらゆるループの基盤を形成する5つのプリミティブを定義しています：

プリミティブ ループ内での役割
自動化/スケジューリング 定期的な発見とトリアージ
ワークツリー 安全な並列実行
スキル 永続的なプロジェクト知識
プラグインとコネクタ 実際のツールへのアクセス（MCP）
サブエージェント 作成者/検証者の分割
+ メモリ/状態 会話の外にある耐久性のある基盤

詳細はdocs/primitives.mdに、クロスツールマトリックスはdocs/primitives-matrix.mdにあります。

ループの構造

典型的なループフローは次のようになります：

flowchart LR
A[スケジュール/自動化] --> B[トリアージスキル]
B --> C[状態/メモリの読み書き]
C --> D[分離されたワークツリー]
D --> E[実装サブエージェント]
E --> F[検証サブエージェント<br/>テストとゲート]
F --> G[MCP / Git / チケット]
G --> H{人間によるゲート?}
H -->|安全/許可リスト| I[コミット/PR/アクション]
H -->|リスクあり/曖昧| J[人間にエスカレーション<br/>完全なコンテキスト付き]
I --> A
J --> A

このサイクルはスケジュールに従って実行され、状態を読み書きし、隔離環境で実行し、結果を検証し、コミットまたはエスカレーションします。人間によるゲートは重要な安全機構です—無人ループは無人ミスを犯す可能性があります。

本番パターン

リポジトリには、定義されたケイデンス、スターターテンプレート、推定トークンコストを持つ7つの本番対応ループパターンが含まれています：

パターン ケイデンス スターター 第1週 トークンコスト
デイリートリアージ 1日〜2時間 minimal-loop L1レポート 低
PRベビーシッター 5〜15分 pr-babysitter L1監視 高
CIスイーパー 5〜15分 ci-sweeper L2慎重 非常に高
依存関係スイーパー 6時間〜1日 dependency-sweeper L2パッチのみ 中
チェンジログドラフター 1日またはタグ changelog-drafter L1ドラフト 低
マージ後クリーンアップ 1日〜6時間 post-merge-cleanup L1オフピーク 低
イシュートリアージ 2時間〜1日 issue-triage L1提案のみ 低

どれを選べばいいかわからない？インタラクティブなパターンピッカーを使用するか、機械可読なインデックスについてはpatterns/registry.yamlを確認してください。

5分で始める

# 1. スキャフォールド + Loop Readyスコアを取得（自動印刷）
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

# オプション：Loop Readyバッジを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.

3つのCLIはすべて、タグ付きリリースからnpmに公開されています—クローンは不要です。ソースから貢献する場合は、モノレポから開発できます：

cd tools/loop-init && npm ci && npm test && node dist/cli.js /path/to/project --pattern daily-triage --tool grok
cd tools/loop-audit && npm ci && npm test && node dist/cli.js /path/to/project --suggest
cd tools/loop-cost && npm ci && npm test && node dist/cli.js --pattern ci-sweeper --cadence 15m

段階的なロールアウトが推奨されます：L1（レポートのみ）→ L2（支援修正）→ L3（無人）。詳細はloop-design-checklistを参照してください。

CLIツール

リポジトリにはいくつかのnpmパッケージが含まれています：

  • loop-audit：Loop Readiness Score CLI（v1.5 + 制約スコアリング）— npx @cobusgreyling/loop-audit . --suggest
  • loop-init：スターター + 予算/実行ログ + 制約のスキャフォールド — npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
  • loop-cost：トークン消費見積もりツール — npx @cobusgreyling/loop-cost
  • loop-sync：STATE.mdとLOOP.md間のドリフト検出 — npx @cobusgreyling/loop-sync .
  • loop-context：ステートフルメモリマネージャー + 長時間実行用のサーキットブレーカー — npx @cobusgreyling/loop-context --check --ledger run.json
  • loop-mcp-server：パターン、スキル、状態のMCPランタイムルックアップ（リポジトリv1、npmは保留中）

運用と安全性

ループエンジニアリングは判断力を増幅します—良いものも悪いものも。主な注意点：

  • トークンコストが爆発する可能性があります、特にサブエージェントや長時間実行ループの場合。
  • 検証は依然としてあなたの責任です。 無人ループは無人ミスを犯します。
  • 理解負債はより速く増加します、ループが送り出すものを読まない限り。
  • 同じループを実行しても、2人が逆の結果を得ることがあります。 ループは知りません。あなたが知っています。

リポジトリには包括的な安全ドキュメントが含まれています：

貢献

プロジェクトへの貢献を歓迎します。特に障害事例や新しいパターンマッピングを歓迎します。コントリビュータークイックスタートを確認してください。ストーリーやアダプターについては、約10分〜1時間のタスクで、同日レビューが行われます。

結論

ループエンジニアリングはパラダイムシフトです。エージェントにプロンプトを送る人ではなく、エージェントにプロンプトを送るシステムを設計する人になるのです。このリポジトリは、そのシフトを実践的にするためのパターン、ツール、安全慣行を提供します。

Addy Osmaniが言うように：「ループを構築せよ。しかし、単に実行ボタンを押す人ではなく、エンジニアであり続けるつもりの人のように構築せよ」。

この投稿は、Cobus Greylingによるループエンジニアリングリポジトリに基づいており、MITライセンスの下で提供されています。

ソース

cobusgreyling/loop-engineering: AIコーディングエージェントによるループエンジニアリングのための実践的なパターン、スターター、CLIツール。エージェントにプロンプトを送り、オーケストレーションする設計システム（Addy OsmaniとBoris Chernyに触発）。loop-audit、loop-init、loop-costを含む。