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

Transcript

1. Speculative Implementation × AI で切り拓く Stripe API 移行実践記 JP_Stripes 福岡 Vol.12 - サービスを支える決済の裏側 株式会社ROUTE06 CTO 重岡 正 1
2. 自己紹介 重岡 正 (SHIGEOKA Tadashi) 株式会社ROUTE06 取締役 CTO / 共同創業者 普段はフルリモートワーク 🧑‍💻🏠 本日は熊本からやって参りました 🚄 2
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