FastAPIのOpenAPI仕様書を「絶対にドリフトさせない」自動生成パイプラインを構築した
2026.07.12 10:33
Classmethod.jp
FastAPIの自動生成OpenAPIスキーマをそのまま仕様書として使おうとしたら、スキーマドリフト・SSE未対応・バージョン互換性など多くの課題にぶつかりました。Pydanticモデルを唯一のソースとし、Claude CodeのPostToolUseフックで「Pythonファイル保存時にopenapi.ymlを自動再生成」する仕組みを構築した過程を紹介します。