Claude Codeで20K行以上の本番SaaSプラットフォームを構築：大規模エージェント工学からの教訓

プロジェクト概要

LastSaaSは、Claude Codeとの対話を通じて書かれたすべてのコード行からなるプロダクションSaaSボイラープレートです。これはデモやおもちゃではなく、Flipbookというライブプラットフォームを動かしています。スタックにはGo 1.25、React 19、TypeScript、MongoDB、Tailwindが含まれ、MITライセンスでリリースされています。

プロジェクトに含まれるもの

• マルチテナント認証（OAuth、MFA、マジックリンク、JWTローテーション）を備えた完全なSaaS基盤
• Stripe請求（サブスクリプション、シート単位、クレジット）
• ホワイトラベリング機能
• 19種類のWebhookイベントタイプ
• 管理者ダッシュボードとヘルスモニタリング
• 組み込みMCPサーバー（26の読み取り専用ツール付き） - AIアシスタントがダッシュボード、ユーザー、請求、ヘルスデータをクエリできる

うまくいったこと

Goの明示性はエージェントにとって強み: フレームワークのマジックがないため、Claude Codeはミドルウェアが裏で何をしているかを推測する必要がありません。明示的なエラー処理、明確なルーティング、予測可能なパターンが、エージェントが軌道を維持するのに役立ちます。

一貫したパターンが効果を増幅: ハンドラー、サービス、データアクセスの構造に関するパターンを早期に確立することで、Claudeは数十のエンドポイントにわたって高い一貫性でそれらを複製でき、新機能ごとの負担を劇的に減らしました。

MCPサーバーはClaudeによってClaudeのために構築: 26の読み取り専用ツールは、AIがシステムをクエリする独自の方法を構築したメタインターフェースを作成します。

MongoDBのドキュメントモデルがマルチテナンシーを簡素化: データモデルが境界を明示するため、Claudeはテナント分離を維持するのに苦労せず、結合テーブルの混乱や漏れやすい抽象化を回避しました。

規律が必要だったこと

依然としてアーキテクチャのビジョンが必要: Claude Codeは優れた実行者ですが、システムを設計しません。人間はアーキテクチャを提供する必要があります—マルチテナントRBACがどのように見えるべきか、Webhook配信の再試行がどのように機能すべきか、Stripe統合フローが何を必要とするかを知っている必要があります。

すべてをレビューする: 特にJWTローテーション、HMAC署名、レート制限、インジェクション保護などのセキュリティに敏感なコード。Claudeはほとんどの場合正しく理解しますが、「ほとんどの場合」は認証フローには十分ではありません—セキュリティに関連するすべての行は人間によるレビューが必要です。

パターンの逸脱と戦う: 長時間のセッションでは、Claudeは確立されたパターンから微妙に逸脱することがあります。定期的に対話を再固定することが役立ちます：「ユーザーハンドラーの実装方法を見てください。Webhooksにも同じパターンに従ってください。」

「エージェント向けに構築」というコンセプト

このコードベースは、誰かがフォークして独自のAIエージェントを向けたときに、エージェントが流暢に拡張できるように意図的に構造化されています。これには、予測可能なファイル構造、一貫した命名、明示的なパターンが含まれます—対話を通じて拡張されるように設計された基盤です。

リポジトリはhttps://github.com/jonradoff/lastsaasで利用可能です。