> ## 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 등은 코드를 빠르게 작성하지만 엄격한 아키텍처 경계가 없으면 인증 세션을 깨뜨리거나 결제 웹훅을 망가뜨리기 쉽습니다. 실전용 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 에이전트 최적화 모노레포 비교

일반 보일러플레이트와 AI 에이전트 협업에 최적화된 기반의 차이점:

| 기능 및 항목 | 일반적인 보일러플레이트 | supastack AI 최적화 모노레포 |
|---|---|---|
| 에이전트용 지침서 | 없음 또는 단순 README 수준 | 완벽한 AGENTS.md, CLAUDE.md 및 .ai/ 문서 미러링 |
| 자동화 테스트 검증 | 0~15개 (자주 오류 발생) | 144개 테스트 파일 (pnpm verify:local 로컬 게이트 지원) |
| 웹훅 안전성 보장 | 수동 테스트에 의존 | 모의 이벤트로 검증된 멱등성 웹훅 원장 탑재 |
| 코드 패키지 경계 | 단일 폴더에 모든 파일 혼재 | auth, db, billing, ai 등 독립 분리 패키지 구조 |
| MCP 서버 연동 | 미포함 | 도구 및 가이드와 직결되는 네이티브 @supastack/mcp 서버 제공 |
| 플랫폼 간 일관성 | 웹 전용 | 동일 모노레포에서 웹, Expo 모바일, Tauri 데스크톱 통합 관리 |


## 아이디어에서 기능 배포까지 30분 만에 완성하는 워크플로

supastack에서 Claude Code나 Cursor와 협업하는 과정은 매우 직관적이고 안정적입니다:

원하는 기능을 프롬프트로 전달하면 에이전트가 `AGENTS.md`를 읽고 관련 패키지를 찾아 코드를 작성한 뒤 로컬 테스트를 실행합니다. 만약 테스트가 실패하면 에이전트가 스스로 코드를 수정하여 성공할 때까지 반복합니다.

인증, 팀 분리, 결제, 오류 로깅이 이미 견고하게 구축되어 있으므로 에이전트는 오직 여러분의 비즈니스 핵심 로직에만 100% 집중할 수 있습니다.


## 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 빌드를 납품하든, 하나의 라이선스로 무제한 클라이언트 상용 프로젝트를 만들 수 있습니다. 프로젝트당 비용 없이, 리포지토리 접근이 필요한 개발자당 시트 하나입니다.

- 빠른 웹 전용 납품에는 단일 플랫폼 리포지토리, iOS + Android + Desktop 프로젝트에는 통합 Monorepo
- BMAD·Claude Code·Cursor 에이전트를 아키텍처 안에 유지하는 AGENTS.md, .ai/ 파일 문서, Agent Skills
- 클라이언트가 보기 전에 에이전트 회귀를 잡아내는 크리덴셜 불필요 로컬 테스트 게이트
- 하나의 라이선스로 무제한 클라이언트 프로젝트 — 클라이언트 대신 구매하고 모든 프로젝트에서 마진을 확보


## AI 개발 키트 관련 자주 묻는 질문

AI 에이전트를 활용한 SaaS 개발에 대한 유용한 답변:

- 어떤 AI 코딩 도구가 supastack과 가장 잘 맞나요?: supastack은 Claude Code, Cursor, Windsurf, GitHub Copilot, Devin 및 표준 터미널과 마크다운 지침을 지원하는 모든 도구와 완벽히 호환됩니다.
- 사용하려면 비싼 AI 유료 구독이 필수인가요?: 아닙니다. 원하는 어떤 모델이나 구독 플랜으로도 개발할 수 있으며, 로컬 통합 테스트는 외부 API 비용 없이 완전 무료로 오프라인 실행됩니다.