Node.jsプロジェクト ―実践的なWebアプリケーションとバックエンドAPIの構築

付録FAIコーディングエージェントはどのように動くのか

沖田 祐樹

本付録は日本語版オリジナルの記事である。本稿では、AIコーディングエージェントを支える基盤技術について解説する。

F.1　イントロダクション

Claude CodeやCodex CLIに代表されるAIコーディングエージェントの登場により、ソフトウェア開発の実務は大きく変わりつつある。従来のAI活用は、主としてコード補完や定型的な生成支援にとどまっていた。しかし近年では、コードベースの読解、実装、修正、テスト実行、結果の検証、失敗時の再試行までを含む一連の開発作業を、一定の自律性のもとで継続的に遂行するシステムが実用段階に入った。その結果、開発者に求められる役割も、単にコードを書くことから、どの工程を自動化し、どの判断を人間が保持し、どの境界でエージェントを制御するかを設計することへと移り始めている。

本稿の中心的主張は、AIコーディングエージェントの実用性はモデル単体の性能ではなく、ハーネス、コンテキスト管理、評価基盤、セキュリティ境界を含むシステム設計によって大きく規定される、という点にある。

本稿では、まずエージェントループとハーネスの役割を整理したうえで、長時間実行を支えるプロンプトキャッシングとコンテキストエンジニアリングを取り上げる。続いて、評価基盤・トレース・可観測性の観点から、エージェントの振る舞いをどのように検査し改善するかを論じ、最後に、セキュリティモデルと委譲境界、ならびにリポジトリ側で講じるべき対策について検討する。これにより、AIコーディングエージェントを安定的かつ信頼性高く運用するために必要な設計原則を、実装と運用の両面から明らかにすることを目指す。

F.2　コーディングエージェントを支えるハーネス ...