echo-ae/agentic-loop

agentic-loop は何をしますか？

承認済み実装計画を、プロジェクトローカルなブートストラップとトレーサビリティを備えた、実装・レビュー・修正・検証のバウンドループで実行するためのCodexスキルです。

概要

このスキルは、AIエージェント（特にCodex）が承認された実装計画を自律的かつ安全に実行するための枠組みを提供します。agentic-loopは、計画を小さな反復可能なユニットに分割し、各ユニットを実装・レビュー・修正・検証のループで処理することで、品質とトレーサビリティを確保します。

動作の仕組み

1. 実装フェーズ: 承認された計画に基づき、エージェントがコードの変更を実装します。
2. レビューフェーズ: 実装された変更を自動的にレビューし、問題を特定します。
3. 修正フェーズ: レビューで見つかった問題を修正します。
4. 検証フェーズ: 変更が期待通りに動作し、既存のテストを壊していないかを検証します。

このループは、事前に定義された最大反復回数（バウンド）に達するか、すべての検証が成功するまで繰り返されます。

前提条件

• Codex（または互換性のあるAIエージェントプラットフォーム）
• プロジェクトのローカル環境にアクセス可能なこと
• 実装計画が事前に承認されていること

プロジェクトローカルブートストラップ

プロジェクトローカルブートストラップは、実行環境を自動的に設定します。これには以下が含まれます：

• 依存関係のインストール
• 環境変数の設定
• テスト設定の準備
• 必要なツールのバージョン確認

トレーサビリティ

各ループのすべてのアクションは記録され、以下の情報が追跡されます：

• 変更されたファイルとその差分
• レビュー結果
• 修正の内容
• 検証テストの結果とカバレッジ
• ループの反復回数と消費した時間

使用例

agentic-loop --plan ./plans/feature-auth.md --max-iterations 5

設定オプション

• --plan: 実装計画ファイルへのパス（必須）
• --max-iterations: 最大ループ反復回数（デフォルト: 3）
• --bootstrap: ブートストラップを強制的に実行するかどうか（デフォルト: false）
• --trace-dir: トレースログの出力ディレクトリ（デフォルト: .agentic-loop/traces）

制限事項

• このスキルは、承認された実装計画が存在することを前提としています。計画がない状態での実行はサポートされていません。
• ループの各フェーズでエージェントのコンテキストウィンドウ制限に達する可能性があります。その場合は、計画をさらに小さな単位に分割することを推奨します。
• プロジェクトローカルブートストラップは、既存のビルドシステムやテストフレームワークと互換性がある必要があります。

関連リソース

• Codexドキュメント
• 実装計画テンプレート