既存開発基盤をAIエージェント対応に再設計

この設計記録は、既存のフロントエンド開発・デリバリープラットフォームを出発点とした実務者によるものだ。出発点は、AIエージェントが新しい入口点をもたらすという点にある——ユーザーがリポジトリ内から質問する、あるエージェントがコードを生成し別のエージェントがビルドを要求する、Gitイベントがフローを起動する、といった入口点には、人がプラットフォームの画面に入力したであろう情報が伴わない。

筆者の対応は、一つのテンプレートに折り込まれていた2つの役割——どの手順を実行するかの選択と、その手順を依存関係に従って実行し結果を記録すること——を分離することだった。コマンドだけでは不十分であることが判明した。呼び出し元は画面の色や隣のフィールドを読めないため、プラットフォームは照会・開始・確認という3つの機能を中心に再構築された。実際には、より困難な作業はAPIの追加ではなく、Gitイベントが出発点の場合にはまだ存在しないかもしれない変更管理単位など、既存プロセスが暗黙に依存していた情報を明らかにすることだった。

単一エージェントの操作を超えて、この記録は会話とジョブの寿命が異なると主張する。そのため、議論・タスク・実行・依存関係を別々の単位として追跡し、診断・復旧・通知を異なる状態として扱う必要がある。筆者はこれが完成した結果ではなく設計上の選択の積み重ねであり、価値はエージェントが呼べるコマンドの数ではなく、ユーザーが成果に到達し、待機を説明し、失敗を追跡し、途中から再開できるかどうかにあると注意を促している。