REST APIにTypeSpecを導入してスキーマ駆動開発 - LayerX エンジニアブログ

Ai Workforce （以下AiW）を開発しているフロントエンドエンジニアのid:ninjinkunです。AiWではサーバーとフロントエンドの通信にREST APIを使っています。これまではサーバーサイドのFastAPI（Python）からOpenAPI Specを出力してクライアントコードの自動生成を行うフローはあったものの、サーバーサイドの実装が完了しないとフロントエンドの実装が始められない課題がありました。 私はGraphQLを利用した経験が長かったため、APIスキーマを実装前に定義し、フロントエンドとバックエンドがスキーマを使って並行で開発を行うスキーマ駆動開発をAiWにも持ち込みたいと考えました。また、APIスキーマなどの定義フォーマットはコーディングエージェントとも相性が良いため、全員がコーディングエージェントを活用するチーム全体の生産性にも寄与する狙いがありました。 そこ