大規模なNext.js / FlutterアプリをClaude Codeでフルスクラッチ、どんな方針で取り組んだのか

大規模なサービスの開発にAIを使いたいものの、どこまで任せてよいか迷っている開発の責任者の方に向けた記事です。結論から言うと、全国1,000店舗強で使われるモバイルオーダーをAI前提で作り直したこの案件では、コードの実装とテストはAIが担い、人は「何を作るか」と「品質がよいか」を決めました。この記事では、人が決めたことを順に紹介します。
案件の概要は、実績ページの「モバイルオーダーの再構築」にまとめています。
どんなシステムを作り直したのか
大手外資系ファーストフードチェーンの、全国1,000店舗強で使われているモバイルオーダーです。登録ユーザーは1,000万人以上、月間のアクティブユーザーは数百万人にのぼります。
もとのシステムは10年ほど前にリリースされたもので、次の課題を抱えていました。
- 画面の読み込みが遅く、細かな不具合が山積していた
- 注文までの操作に迷いやすく、アプリのレビューでも使い勝手の低さを強く指摘されていた
- クーポン施策を広げたくても、システム側の対応が追いつかなかった
当社はPL/Tech Leadとして要件定義から参画し、Webフロント(Next.js)とモバイルアプリ(Flutter)をゼロから作り直しました。
人とAIは、どう分担したのか
人は要件と品質に責任を持ち、実装の速さはAIで出す、という分担です。
| 工程 | 人が担ったこと | AI(Claude Code)が担ったこと |
|---|---|---|
| 要件定義 | 注文の流れと、クーポンの適用ルールを整理する | — |
| 設計 | 画面遷移とコンポーネントの設計、Webとアプリの役割分担、API連携の設計 | — |
| 規約の準備 | コーディング規約・設計上の制約・テスト方針を文書にする | — |
| 実装とテスト | Storybookで画面の振る舞いを確かめる。サーバーとのやり取りの型を決める | 規約と型に沿ってコードとテストを書く |
| 公開前の確認 | セキュリティの審査を受け、公開してよいかを判断する | コードの審査 |
人が決めたことは何か
注文の流れと、クーポンの適用ルール
最初に決めたのは、利用者が注文を終えるまでの流れと、クーポンの適用ルールです。クーポンは条件の組み合わせで増えていくため、どの条件で何が適用されるのかを、実装の前に整理しました。UI/UXの議論を重ね、Figmaで起こされた画面イメージをもとに、画面設計とアーキテクチャ設計に入っています。
Webとアプリの役割分担
Webフロントとモバイルアプリの両方を作り直すので、どの機能をどちらでどう実現するかを決める必要がありました。決済も、クレジットカード決済とQR決済の両方を、Web・アプリのどちらでも行えるようにしています。
施策を足しても、画面を直さずに済む作り
元の課題の一つは、クーポン施策を広げたくてもシステムが追いつかないことでした。そこで、施策を追加しても画面側の改修が最小限で済む作りにしました。条件の組み合わせが多い分、テストケースも相当な数になっています。
外部システムとの取り決めを守ること
このサービスは、外部システムとの連携が非常に多い構成です。連携の取り決めを守り、慎重に組み込むことを、設計の段階で優先しました。
AIに守らせる規約・制約・テスト方針
実装に入る前に、コーディング規約・設計上の制約・テスト方針を文書にしました。AIが毎回同じ基準でコードを書けるようにするためです。この準備があるので、AIが書く量が増えても、出てくるコードの形はぶれません。
コードレビューは、どうしたか
コードレビューは、ほとんど行いませんでした。人が1行ずつコードを読む代わりに、何で確かめるかを先に決めておきました。
- 画面はStorybookで確かめる:実装されるUIの部品はStorybookで確認できるので、人が見るのは振る舞いだけです。見た目と動きを部品ごとに確かめれば、コードを読まなくても判断できます
- サーバーとのやり取りは、1つの型に沿って書かせる:Next.jsのサーバーとのやり取りは、Aurora Scharffさんの「Component Architecture for React Server Components」の考え方を主に採用しました
この記事の考え方は、次のようにまとめられます。
- ページは部品を組み合わせるだけで、自分ではデータを取りに行かない
- データは、それを使う部品が自分で取得する。読み込みと表示のコードを同じ場所に置く
- 読み込み中の表示(Suspense)の区切り方は、ページの側で設計する
- ブラウザで動く部品(Client Components)は、部品の木の末端に置く
やり取りの形を1つに決めておくと、AIが書くコードの形もそろいます。どこでデータを取り、どこで画面を描いているかが予想どおりなので、読まずに確かめられる範囲が広がりました。条件の組み合わせが多いクーポンのような部分は、テストで確かめています。
セキュリティの担保はどうしたか
2026年9月後半から個人情報漏洩のニュースが相次いだこともあり、脆弱性への対応は厳密に行いました。AIによる審査に加えて外部の審査も受け、Webアプリケーションだけでなく、スマートフォンのアプリのセキュリティ対策も実装しています。
計測の設計(GA4、GTM、Firebase Analytics、Braze、AppsFlyer)と、ディープリンクの設計も、当社が担当しました。
体制と期間は
当社からは最大4名(パートナーを含む)が参加し、プロジェクト全体は約20名です。お客様側のチームと役割を分けて進めました。
2026年11月初旬に、フルリニューアルを完了しました。フェーズ1を終え、次年度の施策を順次議論しながら、フェーズ2以降も継続して担当しています。
まとめ
- 全国1,000店舗強のモバイルオーダーのWebとアプリを、Claude Codeでゼロから作り直した
- 実装とテストはAIが担い、人は要件、役割分担、施策を足しやすい作り、AIに守らせる規約、セキュリティの担保を決めた
- 規約と、サーバーとのやり取りの型を先に決め、画面はStorybookで確かめたので、コードレビューはほとんど要らなかった
開発チームにAI前提の進め方を入れる手順は、「開発チームにAIを入れる手順」にまとめています。
よくある質問
大規模なサービスでも、AI前提の開発はできますか?
できます。規模が大きいほど、規約・設計上の制約・テスト方針を先に文書にし、AIが毎回同じ形でコードを書ける状態にしておくことが重要になります。この案件も、その準備をしてから実装に入りました。
AIが書いたコードの安全性は、どう確かめましたか?
AIによる審査に加えて、外部の審査も受けました。Webアプリケーションだけでなく、スマートフォンのアプリについてもセキュリティ対策を実装しています。
コードレビューをしなくて、品質は保てるのですか?
人が1行ずつコードを読む代わりに、確かめ方を決めておきました。画面の部品はStorybookで振る舞いを確かめ、サーバーとのやり取りは1つの設計の型に沿って書かせています。形がそろっていれば、読まずに確かめられる範囲が広がります。
開発会社がチームの一部を担う形でも、AI前提で進められますか?
進められます。この案件はプロジェクト全体が約20名で、当社からは最大4名が参加し、お客様側のチームと役割を分けて進めました。当社が担う範囲の規約とテスト方針をそろえれば、AI前提の進め方を取り入れられます。