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

Tadashi Shigeoka

October 22, 2025

Tweet Share

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. 背景：Stripe API 移行の課題 API バージョンごとの互換性が複雑 ドキュメントを読むだけではリスクが見えにくい 「feature flag 」 「env

   変数」 「全面切替」など、選択肢が多い 5

6. Speculative Implementation とは？ 複数の実装パターンをAI に生成させ、実際に動かしながら制約を発見する手法 コード生成コストが低いAI 時代ならではの開発アプローチ 「設計 → 実装」ではなく「実装

   → 発見 →設計」の順で進める 6

7. 並行検証した3 つのアプローチ Feature Flag 方式 段階的にBasil へ移行 SDK が複数API version

   を同時サポートしていないことを発見！ 環境変数切替方式 STRIPE_API_VERSION で動的に制御 設定の明示性は高いが、管理コストも上がる 全面移行方式 Basil へ一括切替 確実かつメンテナンスが容易 7

8. 実装から得た学び 発見 内容 学び SDK 制約 同一SDK で複数API version 不可

   段階移行を断念し全 面移行へ Subscription 構 造 subscription.current_period_* → subscription.items[0].* DB スキーマ変更不 要と判明 Metering Logic 複雑な集計ロジックをAI が整理 コードベースで理解 加速 8

9. Basil でシンプルになった課金実装 新API でUsage-based Billing が大幅に簡素化 メータリングと課金ロジックの責務が明確に分離 9

10. AI × ドキュメントの理想的な分業 役割 担当 内容 AI コード生成 ドキュメントをコードに変換し複数案を提示 人間

    意思決定 ビジネス要件・環境依存・切替戦略を判断 成功の鍵：AI が理解できる構造化されたドキュメント設計 10

11. Stripe ドキュメントの優秀さ Breaking Changes が一覧化 Before / After のコード例 API

    ごとの詳細な影響範囲 移行パスが明示的 → AI が正確に理解し、正しいコードを生成できた要因 11

12. 学びと今後への示唆 自社ドキュメントもAI フレンドリーに 外部サービス選定基準に「AI 理解性」を追加 開発プロセスの進化 「読解 → Speculative 実装

    → フィードバック → 意思決定」 12

13. まとめ Speculative Implementation × AI により、Stripe API 移行のリスクを コードで検証し可視化 Stripe

    の高品質なドキュメントが成功を後押し AI 時代の開発は「ドキュメントとコードの対話」 AI と人間の協働で安全かつ高速な移行を実現 13

14. 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