Upgrade to Pro — share decks privately, control downloads, hide ads and more …

Speculative Implementation × AI で切り拓く Stripe AP...

Speculative Implementation × AI で切り拓く Stripe API 移行実践記

⬢イベント
JP_Stripes 福岡Vol.12 - サービスを支える決済の裏側
https://jpstripes.connpass.com/event/369312/

⬢ Giselle (ジゼル) について
Blog: https://giselles.ai/blog/upgrading-stripe-api-to-basil
Home: https://giselles.ai/
GitHub: https://github.com/giselles-ai/giselle

⬢株式会社ROUTE06 (ルートシックス) について
会社情報: https://route06.com/jp

Avatar for Tadashi Shigeoka

Tadashi Shigeoka

October 22, 2025
Tweet

More Decks by Tadashi Shigeoka

Other Decks in Programming

Transcript

  1. Speculative Implementation × AI で切り拓く Stripe API 移行実践記 JP_Stripes 福岡

    Vol.12 - サービスを支える決済の裏側 株式会社ROUTE06 CTO 重岡 正 1
  2. 自己紹介 重岡 正 (SHIGEOKA Tadashi) 株式会社ROUTE06 取締役 CTO / 共同創業者

    普段はフルリモートワーク 🧑‍💻🏠 本日は熊本からやって参りました 🚄 2
  3. 3

  4. 発表概要 Stripe API を Acacia → Basil へ移行するにあたり、 AI を活用した

    Speculative Implementation (先行的な複数実装) を試みました。 AI による並列実装で以下を実現 ドキュメントに書かれていない制約を早期発見 最適な移行方式の選定を高速化 Breaking Changes への安全な対応 4
  5. 並行検証した3 つのアプローチ Feature Flag 方式 段階的にBasil へ移行 SDK が複数API version

    を同時サポートしていないことを発見! 環境変数切替方式 STRIPE_API_VERSION で動的に制御 設定の明示性は高いが、管理コストも上がる 全面移行方式 Basil へ一括切替 確実かつメンテナンスが容易 7
  6. 実装から得た学び 発見 内容 学び SDK 制約 同一SDK で複数API version 不可

    段階移行を断念し全 面移行へ Subscription 構 造 subscription.current_period_* → subscription.items[0].* DB スキーマ変更不 要と判明 Metering Logic 複雑な集計ロジックをAI が整理 コードベースで理解 加速 8
  7. AI × ドキュメントの理想的な分業 役割 担当 内容 AI コード生成 ドキュメントをコードに変換し複数案を提示 人間

    意思決定 ビジネス要件・環境依存・切替戦略を判断 成功の鍵:AI が理解できる構造化されたドキュメント設計 10
  8. Stripe ドキュメントの優秀さ Breaking Changes が一覧化 Before / After のコード例 API

    ごとの詳細な影響範囲 移行パスが明示的 → AI が正確に理解し、正しいコードを生成できた要因 11
  9. まとめ Speculative Implementation × AI により、Stripe API 移行のリスクを コードで検証し可視化 Stripe

    の高品質なドキュメントが成功を後押し AI 時代の開発は「ドキュメントとコードの対話」 AI と人間の協働で安全かつ高速な移行を実現 13
  10. References Upgrading Stripe API version with AI-powered Speculative Implementation -

    Giselle Basil | Stripe Changelog Acacia | Stripe Changelog Adds subscription item-level billing periods and removes subscription-level periods | Stripe Documentation 株式会社ROUTE06 | AI 駆動開発プラットフォーム | ROUTE06 Giselle: AI App Builder GitHub: giselles-ai/giselle: Giselle: AI App Builder. Open Source. About me 14