ONEDEV

open-saas

wasp-lang파일 674개

★ 15,833주당 +88조회 3

무엇인가

open-saas는 Wasp 풀스택 프레임워크 위에 세워진 SaaS 보일러플레이트 저장소로, 애플리케이션 코드와 함께 AI 코딩 에이전트용 규칙·스킬·플러그인을 배포한다. 규율 대상은 인증(이메일·Google·GitHub·Slack·MS), 결제(Stripe·Polar.sh·Lemon Squeezy), 백그라운드 잡, 이메일 발송, S3 파일 업로드, 배포 절차처럼 템플릿이 이미 정해 둔 구현 경로다. 에이전트가 이 경로를 벗어난 임의 구현을 만들지 않도록, 템플릿이 채택한 라이브러리와 파일 배치를 규칙으로 고정한다.

어떻게 동작하나

규칙은 저장소 안에 AGENTS.md, 스킬 파일, Claude Code 플러그인 형태로 함께 들어간다. 에이전트가 저장소를 열면 이 파일들이 로드되어 작업 지침으로 작동한다. Wasp는 설정 파일에 라우트·인증·잡을 선언하고 그 선언에서 서버와 클라이언트 코드가 생성되는 구조이므로, 규칙은 설정 파일의 선언 지점과 생성된 코드 사이의 대응 관계를 유지하는 쪽으로 쓰인다. 백엔드 함수의 타입이 프런트엔드로 추론되는 타입 안전성, 잡 정의 방식, 배포 명령 같은 항목이 규칙에 포함된다.

무엇과 다른가

매 세션 프롬프트를 직접 작성하거나 범용 CLAUDE.md 한 장을 두는 방식과 달리, 여기서는 규칙이 템플릿 코드와 같은 저장소에 버전 관리된다. 템플릿을 업데이트하면 규칙도 같이 갱신되므로 코드와 지침이 어긋나지 않는다. 또 특정 스택에 묶여 있다는 점이 일반 규칙 파일과 다르다. Wasp 설정 파일, Prisma 스키마, ShadCN UI 컴포넌트, Astro 기반 문서·블로그라는 고정된 구조를 전제로 하며, 그 구조 안에서의 선택지만 규율한다.

어떻게 쓰나

설치는 Wasp CLI를 먼저 전역으로 깔고 템플릿을 생성하는 두 단계다. `npm i -g @wasp.sh/wasp-cli` 실행 후 `wasp new -t saas`를 실행하면 Open SaaS 템플릿의 깨끗한 복사본이 새 디렉터리에 생성된다. 이후 해당 디렉터리를 Claude Code에서 열면 플러그인과 규칙이 적용된 상태로 작업을 시작할 수 있다. 인증·결제·이메일 같은 서비스 연동은 저장소 문서의 안내에 따라 키를 채워 넣는 방식으로 진행한다.

전제와 한계

Claude Code 플러그인을 주된 대상으로 하지만, AGENTS.md와 스킬 파일을 읽는 Cursor·Codex·OpenCode 같은 도구에서도 같은 규칙을 사용할 수 있다. 전제 조건은 Wasp CLI 설치와 Node.js 환경이며, Wasp 프레임워크를 쓰지 않는 프로젝트에는 적용되지 않는다. 배포는 Railway 또는 Fly.io로의 단일 명령 배포를 지원하고 그 외 호스팅은 수동 배포로 처리한다. 규칙 자체가 애플리케이션 기능을 구현하지는 않으며, 에이전트가 템플릿 관례를 따르도록 제약하는 역할까지만 담당한다.

유사 스킬