エージェント開発とドキュメント駆動開発：AIがコードではなく契約を書くとき

著者のMatvey Likhota氏は、シニアGo開発者ですが、LLMがまずシステムを設計し、OpenAPI、Proto、JSON Schema、CloudEvents、AsyncAPIなどの契約を生成し、その後コードを反復可能なジェネレータと開発者やエージェントがプロジェクト依存部分を生成するという開発アプローチを提案しています。彼はこれを Documentation Driven Agent Development または Specification Driven Agent Development と呼んでいます。この記事では、簡単なPBXサービスの例でそのプロセスを示しています。最初のプロンプトは、コードを書かずにLLMにアーキテクチャ上重要な質問をリストアップするよう求めます。2番目のプロンプトは、RFC 9457エラー、Idempotency-Key、If-Match/ETag、カーソルページネーションなどの厳しい要件を含むOpenAPI 3.1契約を生成します。その後、敵対的レビュープロンプトが契約の欠陥を批判します。イベント契約にはCloudEvents 1.0が使用され、CallStarted、CallAnswered、CallMissedなどのイベントカタログがあります。WebSocket契約はAsyncAPI 3.0で記述され、内部APIはproto3でgRPCとして設計されています。この記事は、契約設計をコード生成から分離し、レビュープロンプトを使用して不整合を検出することを強調しています。