入門編の振り返り：3要素だけでは「動かない」理由
入門編（[ガントレットループ入門](/learning/prompt-gauntlet-loop/)）では、AIに自律改善を行わせるための基本構造として「目標」「評価基準」「境界条件」の3要素を解説しました。AIチャット上でこれらの条件を与えるだけで、一発プロンプトとは比較にならない品質が得られます。
しかし、実際のソフトウェア開発や複雑な文書作成の現場では、プロンプトだけで完結させるには大きな壁が存在します。それは「AIによる自己評価の限界」です。
AIに自分自身の出力を採点させると、どれほど厳しい指示を与えていても「自分のロジックの盲点」に気づけないケースが発生します。人間がどれだけ注意深く推敲しても見落としが発生するのと同じ構造です。
この限界を突破するために必要なのが、本記事で解説する「外部フィードバックを組み込んだ自律修正パイプライン」です。プロンプト上の批評だけでなく、実際のテスト実行結果、TypeScriptの型エラー、コンパイラやリンターの警告といった客観的な判定器（テスト環境）をループに組み込みます。
PROMPT / ADVICE : まだ入門編を読んでいない方へ本記事はコード実行やCLIエージェント環境を前提とした実践編です。まずは入門編で「目標・評価基準・境界条件」の基本概念を押さえておくと、本記事の理解が深まります。
自律修正パイプラインの全体像
外部フィードバックを備えたガントレットループ・パイプラインは、主に5つの要素で構成されます。
ARCHITECTURE : AUTONOMOUS SELF-HEALING PIPELINE1. SPEC / RULES📜 AGENTS.mdゴール・検証コマンド・停止条件の定義ファイル2. EXECUTOR🤖 AI Builderタスク分解・コード修正を行うエージェント3. VERIFIER🧪 検証ゲートtsc / lint / test / build を順次実行4. SAFETY NET🛡️ Git Commit各ラウンドごとのセーフティポイント作成🔄 Feedback Loop: エラー発生時はログを解析し、最小限の修正で「エラー0件」まで自動ループ再試行自律修正パイプラインの全体アーキテクチャ
1つ目は、AIへの指示書となる「AGENTS.md」です。ここにゴール、合格判定用コマンド、停止ルールを定義します。
2つ目は「コード変更エージェント（Builder）」です。タスクを自律的に分解し、実際のファイルを修正する役割を担います。
3つ目は「検証ゲート（Critic）」です。コンパイラ、型チェッカー、テストランナーなどの外部ツールの結果を直接取得し、成否を客観的に判定します。
4つ目は「ループコントローラー」です。検証結果をもとに、修正を継続するか、方針を変更するか、処理を終了するかを判断します。
5つ目は「Gitセーフティネット」です。各修正ラウンドの前にセーフティポイント（コミット）を作成し、AIの誤った修正をいつでも安全にロールバックできる状態を保ちます。
AGENTS.mdで「指令書」を書く
自律エージェント（Claude CodeやAntigravityなど）を動かす際、プロジェクト直下の AGENTS.md や CLAUDE.md にガントレットループのルールを記述しておくことが最も効果的です。
1. ゴールと検証コマンドの定義
あいまいな指示ではなく、AIが実行可能な検証コマンドを明示します。
AGENTS.mdへの記述例：
AI PROMPT / CONFIG
markdown
# 品質検証パイプライン（ガントレットループ）
コード変更やリファクタリングを行う際は、必ず以下の検証コマンドを順番に実行し、すべてエラー0件でパスすることを合格条件とします。
検証手順：
1. npx tsc -b （型チェック）
2. npm run lint （コード規約チェック）
3. npm run test （ユニットテスト実行）
4. npm run build （プロダクションビルド検証）2. 境界条件と安全ルールの明記
エージェントが無限ループに陥ったり、予期せぬ破壊的変更を行ったりしないよう、明確な制約を設定します。
境界条件の記述例：
AI PROMPT / CONFIG
markdown
# エージェント動作の境界条件
- 最大修正ラウンド数：5回
- 禁止事項：外部パッケージの追加（npm i）、設定ファイルの削除、本番環境への自動デプロイ
- ループ停止条件：検証手順の全パス、または同一エラーによる2回連続失敗
- コミット義務：大規模な修正を行う前には、必ず git commit でセーフティポイントを作成すること PROMPT / ADVICE : 設定ファイルはプロジェクトリポに保存しようAGENTS.md をリポジトリにコミットしておけば、チームメンバー全員が同じ自律品質基準でエージェントを稼働させることができます。
実践ハンズオン①：TypeScriptの自律リファクタリング
ここからは実際の開発現場で使える実践ハンズオンを紹介します。第1のユースケースは、TypeScriptプロジェクトでの型エラーやビルド違反の自律解消です。
ステップ1：現状のエラー一覧を取得させる
まず型チェッカーを実行し、全体のエラー件数と対象ファイルを特定させます。
AIへの指示例：
AI PROMPT / CONFIG
現在のプロジェクト全体のTypeScript型エラーを確認してください。
`npx tsc -b` を実行し、発生しているエラーの一覧と対象ファイルをリストアップした上で、依存関係の少ない末端のファイルから順に修正する計画を立ててください。ステップ2：自律修正ループの起動
計画が確認できたら、ガントレットループを始動させます。
自律修正起動プロンプト：
AI PROMPT / CONFIG
作成した計画に基づき、型エラーの解消を行ってください。
ループルール：
1. 1つのファイルまたは関連する1つの型定義を修正する
2. 直ちに `npx tsc -b` を実行し、エラー件数の変化を確認する
3. エラーが減少した場合は git commit で「fix: TS型エラー解消 [ファイル名]」と記録する
4. 新たなエラーが発生した場合は直前の修正をロールバックし、別のアプローチを試す
5. 全型エラーが0件になるか、最大5ラウンドに達するまで繰り返すステップ3：AIの動作確認とループ停止
エージェントは各ラウンドごとに `npx tsc -b` の出力をログとして解析し、修正が正しかったかを自ら判定します。
すべての型エラーが解消された時点で `npm run build` を実行し、正常にビルドできることを確認してループが終了します。
PROMPT / ADVICE : Antigravityでの長時間自律実行Antigravityをお使いの場合、/goal コマンドを使用することで、エージェントをバックグラウンドでバックグラウンド実行させ、完了まで放置することができます。
実践ハンズオン②：テスト駆動開発（TDD）での機能実装
新機能を安全に追加する際、テストを先に作成し、そのテストが全件通過するまでAIに自律実装させる手法です。
ステップ1：失敗するテストコードを先に生成させる
仕様をもとに、テストファイルを作成させます。
TDD準備プロンプト：
AI PROMPT / CONFIG
新機能「ユーザー権限チェックモジュール」の実装を行います。
まず実装コードは書かず、以下の仕様を満たすユニットテスト（src/utils/auth.test.ts）を作成してください。
仕様：
- 管理者ユーザー（admin）は全操作が許可されること
- 一般ユーザー（member）は閲覧と編集のみ許可され、削除は拒否されること
- ゲストユーザー（guest）は閲覧のみ許可されること
- 未定義の権限が渡された場合はエラーをスローすること
作成後、`npm run test` を実行してテストが失敗（RED状態）することを確認してください。ステップ2：テスト通過を目指す自律実装ループ
テストが用意できたら、テスト全件合格（GREEN状態）を目指すガントレットループを起動します。
TDD実装ループプロンプト：
AI PROMPT / CONFIG
作成したテスト（src/utils/auth.test.ts）を全件通過させる実装を作成してください。
ガントレット条件：
- ゴール：`npm run test` が全件合格すること
- 検証手順：コード修正後、必ず `npx vitest run src/utils/auth.test.ts` を実行する
- ループルール：不合格のテストケースのログを解析し、最小限の実装修正を行う
- 停止条件：全テスト合格、または最大5ラウンド到達 PROMPT / ADVICE : リファクタリングループの追加テストが合格した後は、「機能を変えずにコードの可読性と型安全性を高める」ための追加ループを1ラウンド回すと、コード品質が一段と向上します。
実践ハンズオン③：ドキュメント・記事の品質自律改善
エンジニアリングだけでなく、技術文書やブログ記事の推敲にも自律パイプラインは応用可能です。
編集者AIとライターAIの分離
同一の会話コンテキストであっても、ロールを交互に切り替えさせることで客観性を担保します。
ドキュメント改善ループプロンプト：
```
以下の技術ドキュメントの品質を改善してください。
対象文書：[ドキュメント本文またはファイルパス]
改善プロセス：
1.
編集者ロール
文書を読み、以下の4観点で評価を行ってください
- 専門用語の親切な解説があるか
- 手順に抜け漏れや矛盾がないか
- 誤解を招く表現がないか
- スマホで読んだ際に読みやすい段落長か
2.
編集者ロール
最も評価の低い箇所を1点だけ選び、具体的な修正指示を出してください
3.
ライターロール
修正指示に従い、該当セクションのみを書き直してください
4. 再度編集者ロールで評価し、全項目が基準を満たすまで最大3ラウンド繰り返してください
```
PROMPT / ADVICE : 改行と段落ルールの事前指定文章作成のガントレットでは「2〜3文ごとに空行を入れる」「太字記号を使わない」といったフォーマットルールを評価基準に含めておくと、表記揺れを防げます。
自律パイプラインを壊さないための5つの運用ルール
自律パイプラインを安全かつ効果的に運用するために、必ず守るべき5つの原則があります。
CHECKLIST : 5 SAFETY RULES FOR AUTONOMOUS PIPELINESRule 1作業前に小まめに git commit を作成するいつでも正常な過去バージョンへ1秒でロールバック可能なセーフティポイントを維持。Rule 21ラウンドにつき1修正の原則を守る型エラーとテスト失敗を同時に直させず、1回につき最も深刻なエラー1件に集中させる。Rule 3検証はAIの申告ではなく客観コマンドの結果で行う`tsc` や `vitest` の実際の終了コードとログをもとに客観判定する。Rule 4最大試行回数（タイムアウト）を必ず設定する無限ループによるAPIトークン消費やリソース暴走を未然に防ぐ。Rule 5最終コード変更（git diff）は必ず人間が承認する自動検証全通過後も、セキュリティとビジネス仕様の齟齬がないか人間が最終確認。パイプライン運用5大ルール
Rule 1：作業前の小まめな git commit
自律エージェントに大きな変更を行わせる前には、必ず正常に動作している状態をコミットしてください。万が一AIが誤った修正を重ねて収拾がつかなくなった場合でも、1秒で元の安全な状態に戻すことができます。
Rule 2：1ラウンド1修正の原則
1回の修正で複数の問題（型エラーとテスト失敗とデザイン調整など）を同時に直させないでください。修正の焦点がボケて、別のバグを生み出す原因になります。最も優先度の高いエラー1件に集中させます。
Rule 3：検証は客観的ツールに委ねる
AIの「修正しました」「問題ありません」という自己申告テキストを信じてはいけません。必ず `tsc` の終了コードや `vitest` のテスト結果など、コマンドの実行結果ログをもとに判断させます。
Rule 4：明確な停止条件（タイムアウト）の設置
最大試行回数（ラウンド数）を設定せずにループを開始するのは厳禁です。無限ループによってトークンコストが高騰したり、CPUリソースを消費し続けたりするリスクを防ぎます。
Rule 5：最終承認は人間が行う
自律パイプラインが全検証をパスした場合でも、最終的な変更内容（`git diff`）は必ず人間の目で確認してください。セキュリティリスクや業務仕様の齟齬がないかを人間が最終ガードします。
まとめ：指示者から「仕組みの設計者」へ
ガントレットループ入門で学んだ概念を、実際の開発・執筆環境に組み込むことで、AIは単なる「下請け作業者」から「品質を自律担保する頼もしいパートナー」へと進化します。
ポイントは、AIに答えを出させるだけでなく、その答えが正しいかを自動検証する「環境とルール」を人間側が用意することです。
まずは小規模なリファクタリングや型チェックから自律パイプラインを試してみてください。AIが自律的にコマンドを叩き、エラーを解析し、修正を完了させる心地よいリズムを一度体験すれば、今後のAI活用レベルが大きく飛躍するはずです。