cc-serverpod#
Serverpod 백엔드 — 모델/엔드포인트 생성, 마이그레이션 + 심화 패턴(아키텍처, 인증, 캐싱, DB, IAP, 테스트; 구 cc-backend 통합)
Serverpod backend plugin (Model, Endpoint, Migrations)
Skills#
| 이름 | 설명 |
|---|---|
| database-design | Serverpod 데이터베이스 스키마 설계. Serverpod 모델의 테이블, 관계(relation), 인덱스를 설계할 때 사용합니다. |
| serverpod | Serverpod 모델/엔드포인트 생성과 migration. .spy.yaml 모델, endpoint를 만들거나 serverpod generate/migration을 실행할 때 사 |
| serverpod-api-design | Serverpod REST API 설계 원칙과 패턴. Serverpod 백엔드에서 엔드포인트, 요청/응답 DTO, API 버전 관리를 설계할 때 사용합니다. |
| serverpod-architecture | Serverpod 아키텍처 패턴과 구조 설계. Serverpod 서버 구조를 설계하거나 서비스를 조직화하거나 백엔드에 Clean Architecture를 적용할 때 사용합니다. |
| serverpod-auth-identifier-domains | serverpod_auth 를 쓰는 백엔드에서 사용자 식별자가 User.id / UserInfo.id / AuthUser UUID 세 도메인으로 갈리는데 컬럼 이름이 전부 user |
| serverpod-auth-patterns | Serverpod 인증 구현(serverpod_auth_server, getCurrentUserInfo). Serverpod에서 로그인, 세션 검증, 범위(scope) 기반 인가를 |
| serverpod-auth-rules | Serverpod 3.x 인증 규칙 — AuthenticationInfo API. Serverpod 3.x에서 AuthenticationInfo API로 인증을 구현할 때 사용합니 |
| serverpod-caching-patterns | Serverpod 캐싱 전략과 구현. Serverpod에서 캐시를 추가하거나 로컬 캐시와 Redis 캐시 중 선택하거나 캐시 무효화를 튜닝할 때 사용합니다. |
| serverpod-database-patterns | Serverpod Database 심화 — ORM, 쿼리, 마이그레이션. 복잡한 쿼리, 관계(relation), 트랜잭션을 작성하거나 스키마 마이그레이션을 관리할 때 사용합니다. |
| serverpod-iap | 인앱 결제(IAP) 엔드투엔드 설정 — Apple/Google 스토어 등록, StoreKit 구성, in_app_purchase 통합, Serverpod 영수증 검증. 인앱 결제를 |
| serverpod-local-fullstack |
Serverpod 4.0 beta(
4.0.0-beta.0
)의 로컬 풀스택 핫리로드 dev loop —
serverpod start
(내장 Postgres, Docker 불필요
|
| serverpod-logging-rules | Serverpod 로깅 통합 규칙 — 클라이언트 API 요청/응답 로깅(ApiInterceptor, PII 마스킹)과 서버 측 session.log·보관 정책(retentionPe |
| serverpod-mcp-guide |
Serverpod 4.0 beta MCP 서버 가이드(
serverpod mcp-server
) — AI 에이전트가 실행 중인 로컬 서버와 대화할 수 있게 해주는 번들 MCP입니다
|
| serverpod-migration-rules | Serverpod migration 생성·배포·복구 규칙 — repair migration 계약, drift 진단·정리, 타임스탬프 역전으로 인한 조용한 영구 스킵, 무중단 인덱스 |
| serverpod-session-revocation | 동시 로그인 기기 한도와 세션 revoke 아키텍처 — legacy AuthKey 와 idp RefreshToken 두 저장소에 각각 한도를 강제, 한도는 runMode 별 분기하 |
| serverpod-soft-delete | 도메인별 소프트 삭제(deletedAt) 정책 매트릭스 — 활성 조회 vs. 이력 조회. 도메인에 deletedAt 소프트 삭제를 추가하거나 활성/이력 조회를 작성할 때 사용합니다 |
| serverpod-testing-patterns | Serverpod 테스트와 TDD 패턴. 엔드포인트 통합 테스트, 단위 테스트를 작성하거나 Serverpod 서비스에 TDD를 적용할 때 사용합니다. |
| serverpod-transaction-rules | Serverpod 3.x transaction 전파와 raw SQL 안전 규칙. Serverpod 3.x transaction이나 raw SQL을 안전하게 작성할 때 사용합니다. |
| serverpod-worktree-parallel | 여러 Serverpod 4.0 beta 풀스택 인스턴스를 병렬 git worktree에서 실행합니다 — 내장 Postgres가 DB를 공짜로 격리해 주지만(상대경로 dataDir |
Commands#
| 이름 | 설명 |
|---|---|
| /cc-serverpod:endpoint — 서버 API 창구 자동 생성기 | Serverpod endpoint 및 service 클래스 생성 |
| /cc-serverpod:merge-migrations — 흩어진 DB 변경 기록을 하나로 합치기 | 여러 migration을 하나로 병합합니다 (프로덕션 배포 전 정리) |
| /cc-serverpod:model — 백엔드 데이터 설계도 만들기 |
Serverpod 데이터 설계도(
.spy.yaml
)를 만듭니다 — 본체 entity, 생성/수정 요청 DTO, 목록 응답 DTO, enum 을 한국어 설명·생성일시·인덱스까지
|
Agents#
| 이름 | 설명 |
|---|---|
| backend-architect | Serverpod backend architecture design expert. Use for API design, service decomposition, and Clean A |
| serverpod | Serverpod backend expert. Use for model, endpoint, and migration tasks |
| serverpod-endpoint-agent | Serverpod Endpoint 전문가. endpoint 및 service 클래스 생성에 사용합니다. |
| serverpod-exception-agent | Serverpod exception, validation, constants 클래스 생성 전문가. 오류 처리 패턴을 구현할 때 사용합니다. |
| serverpod-model-agent | Serverpod Model 전문가. .spy.yaml 모델 정의, 필드 타입, 인덱스 작업에 사용합니다. |
| serverpod-test-agent | Serverpod 테스트 전문가. Integration/Unit 테스트 생성에 사용합니다. |
| tdd-orchestrator | Serverpod TDD Red-Green-Refactor orchestrator. Use for test-driven backend development |
Rules#
| 이름 | 설명 |
|---|---|
| Backend Test Patterns | Patterns applied when writing Serverpod backend integration tests. |
| backend-conventions | Serverpod backend coding conventions |
관련 플러그인#
| 플러그인 | 설명 |
|---|---|
| cc-bricks | cob(co-bricks) 기반 브릭 생성 가이드. kobic Clean Architecture feature 모듈 11종 + 그린필드 프로젝트 초기 세팅(project-init |
| cc-clickhouse | ClickHouse 기반 BI 분석 |
| cc-compass | 코코드 스킬 저장소 나침반 — 작업 유형(워크플로우/도구/규칙/레퍼런스)에 따라 알맞은 플러그인·커맨드·스킬로 안내 |
| cc-dev | 개발 사이클 자동화 (이슈 사이클, 버그 사이클, 세션, ZenHub, Agent Teams) |
| cc-e2e | flutter-skill 탐색 → Gherkin 초안 → Patrol 박제로 이어지는 E2E 시나리오 저작 파이프라인 |
| cc-flutter | Flutter 개발 핵심 (UI 패턴, Feature 생성, BLoC, 테스트) |
| cc-pixel-loop | Figma + Marionette + Dart MCP를 활용한 픽셀 퍼펙트 Flutter UI 에이전틱 루프 (Read → Write → Reload → Capture → Comp |
| cc-security | 보안 통합 — API/앱 보안, 보안 감사, CI 시크릿, 결제/IAP 엔드포인트 보안, 도서 PDF DRM (구 cc-uiux-security 확장) |
| cc-spec | 스펙 명확성 검증 (소크라테스식 인터뷰, Seed spec, 모호성 스코어링, contrarian/simplifier 에이전트, 3단계 평가) |
설치#
claude plugins install coco-de/skills/plugins/cc-serverpod