> ## Documentation Index
> Fetch the complete documentation index at: https://supastack.dev/llms.txt
> Use this file to discover all available pages before exploring further.
> For the full documentation corpus in one file, fetch: https://supastack.dev/llms-full.txt

# AIコーディングエージェント向けSaaSスターターキット：Claude Code、Cursor、AGENTS.mdでの開発手法

明確なガードレール、テストゲート、MCPツールを活用し、Claude Code、Cursor、DevinなどのAIコーディングエージェントと安全にSaaSを構築・リリースする方法。

_公開日 2026-11-07._
_2026-11-08 更新._

> **Claude CodeなどのAIコーディングエージェントを使用してSaaSを構築するにはどうすればよいですか？**
> スターターキットに組み込まれた保護ガードレールによります。Claude Code、Cursor、Devinは迅速にコードを書きますが、厳格な境界がないと認証セッションを壊したり決済Webhookを破損させたりします。本番対応のAIスターターキットには機械可読なAGENTS.md規則、APIキー不要で即時実行できるテストスイート、MCPツールが必要です。supastackは144個のテストファイルと明確なモジュール境界で安全な開発を実現します。

## AIペアプログラミングの大きな利点と潜在的リスク

Claude Code、Cursor、GitHub Copilot、Devinなどの自律型AIコーディングツールは、ソフトウェア開発のスピードを根底から変えました。数日かかっていた定型作業が数分で完了します。

しかし日常的に利用している開発者が知る通り、エージェントには「コンテキストのドリフト」という弱点があります。明確な制約がないと「割引クーポンを追加して」という指示に対して、ワークスペースの権限判定を勝手に省略したり、データベース接続の仕組みを書き換えたりする危険があります。


## AI支援コードベースに必要な3大ガードレール

AIエージェントに自律作業を任せつつ本番システムを安全に保つには、次の3つの基盤が不可欠です：

- 機械可読な明確なルール策定: リポジトリルートの `AGENTS.md` と `CLAUDE.md` にパッケージの境界、テスト規約、禁止事項を明記する。
- 高速で決定論的なローカルテストゲート: 偽のローカルプロバイダーにより数秒で実行でき、エージェントが既存機能を壊していないかを即座に自己検証できる仕組み。
- ネイティブなModel Context Protocol (MCP) 対応: エージェントがDBスキーマを安全に点検し、API整合性を確かめ、マイグレーションを実行できるツール群。


## 一般的なテンプレートとエージェント向け強化モノレポの比較

一般的なボイラープレートとAIエージェント向けに最適化された基盤の比較：

| 機能・項目 | 一般的なボイラープレート | supastack AI対応モノレポ |
|---|---|---|
| エージェント向け指示書 | なし、または簡易READMEのみ | AGENTS.md、CLAUDE.md、.ai/ アーキテクチャ文書完備 |
| テストによる検証 | 0〜15件（動作しないこと多し） | 144テストファイル（pnpm verify:local ローカルゲート対応） |
| Webhookの安全性 | 手動テストが必須 | 模擬イベントで検証済みの冪等Webhook台帳 |
| パッケージ境界 | 単一フォルダに全コードが混在 | auth、db、billing、ai が独立分離されたパッケージ構成 |
| MCPサーバー連携 | 含まれない | ネイティブな @supastack/mcp サーバーを標準搭載 |
| 全プラットフォームの一貫性 | Webのみ | 同一リポジトリでWeb、Expoモバイル、Tauriデスクトップを一元管理 |


## アイデアから30分で機能を本番投入する開発サイクル

supastackでClaude CodeやCursorと開発する流れは極めてシンプルです：

求める機能をプロンプトで指示します。エージェントは `AGENTS.md` を読み込み、影響するパッケージを特定してコードを記述し、ローカルテストを実行します。もし失敗しても、エージェントが自身で修正して全テストをパスさせてから提示します。

土台となる認証、チーム管理、請求処理、エラー追跡が既に堅牢に実装されているため、エージェントはあなたのサービス独自のコア機能に専念できます。


## AI エージェンシーとエージェントワークフロー向けに構築（BMAD, Claude Code, Cursor）

supastack の購入者の中で AI ソフトウェアエージェンシーを運営する割合が増えています。BMAD 式のプランニングエージェント（Analyst, PM, Architect, QA）がクライアントのブリーフをスコープされたストーリーに分解し、Claude Code と Cursor が、認証・課金・テナンシー・テストをすでに備えたリポジトリ上でそれらを実装します。`AGENTS.md`、`.ai/` ドキュメント、Agent Skills がすべてのエージェントを既存パターンに沿わせます。

単一プラットフォームリポジトリから 5 分で Web MVP をクライアントに引き渡す場合も、統一 Monorepo から iOS・Android・Desktop のビルドを納品する場合も、1 つのライセンスで無制限のクライアント商用プロジェクトを構築できます。プロジェクトごとの費用はなく、リポジトリアクセスが必要な開発者ごとに 1 シートです。

- Web のみの迅速な納品には単一プラットフォームリポジトリ、iOS + Android + Desktop 案件には統一 Monorepo
- BMAD・Claude Code・Cursor のエージェントをアーキテクチャ内に保つ AGENTS.md、.ai/ ファイルドキュメント、Agent Skills
- クライアントが目にする前にエージェントのリグレッションを検出する、クレデンシャル不要のローカルテストゲート
- 1 ライセンスで無制限のクライアントプロジェクト — クライアントの代理で購入し、すべての案件でマージンを確保


## AI開発キットに関するよくある質問

AIエージェントを用いたSaaS開発に関する実用的な回答：

- どのAIコーディングエージェントがsupastackと最も相性が良いですか？: supastackはClaude Code、Cursor、Windsurf、GitHub Copilot、Devin、および標準ターミナルとMarkdown指示を解釈できる全ツールとスムーズに連携します。
- 利用するために高価なAIサブスクリプションが必要ですか？: いいえ。お好みのモデルやプランで開発でき、ローカル統合テストは外部API課金なしで完全にオフラインで無料実行できます。