엔터프라이즈 프로젝트 설계
Next.js + Turborepo + Vercel 환경에서 다수 서비스를 설계·운영하는 시니어 개발자를 위한 실전 가이드
Next.js 앱을 하나 만드는 것은 쉽습니다. 세 개 이상의 서비스를 동시에 설계·배포·운영하면서 Claude Code로 개발 속도까지 극대화하는 것이 이 핸드북의 주제입니다.
대상 독자
Turborepo 모노레포에서 Next.js 앱 여러 개를 운영해야 하는 시니어 개발자. 기본 사용법은 생략하고 엔터프라이즈 패턴·Agentic 자동화·보안 중심으로 구성합니다.
2026-03-27 업데이트
- Claude Code v2.1.77-81:
--bareCI 실행,--channels연구 프리뷰,rate_limits사용량 모니터링,StopFailure훅, frontmatter 선언적 에이전트 제어 - JetBrains Central (2026-03-24): 에이전트 거버넌스 플랫폼 — 정책 강제, IAM, 관측성, 비용 귀속
- AI 코딩 스킬 보안 감사: 22,511개 스킬 중 140,963개 보안 이슈 발견, ClawHavoc 사건 대응
- Codex v0.116.0 엔터프라이즈: Smart Approvals guardian, 엔터프라이즈 프록시,
userpromptsubmit훅 - 거버넌스 준비도: Deloitte 조사 기준 30%, "Graduated autonomy" 패턴 제시
핸드북 구조
목차
Ch1. 모노레포 아키텍처 설계
Turborepo 기반 apps/packages 분리 전략, 의존성 방향, 네이밍 규칙
Ch2. Workspace 설계와 프로토콜
workspace:* 프로토콜, tsconfig 상속, ESLint 공유
Ch3. 공유 패키지 설계 패턴
UI, utils, config, types 패키지의 설계 패턴과 트리셰이킹
Ch4. Turborepo 파이프라인과 캐싱
dependsOn, remote caching, 환경 변수 캐시 무효화
Ch5. Next.js App Router 엔터프라이즈 패턴
Multi-zone, ISR, Middleware, Server Actions, Edge Runtime
Ch6. Vercel 배포 전략
모노레포 배포, Preview 환경, turbo prune
Ch7. CI/CD 파이프라인 설계
GitHub Actions + Turborepo, affected 감지, Changesets
Ch8. 테스트 전략
모노레포 테스트 피라미드, Vitest, Playwright
Ch9. Agentic 개발 체계
CLAUDE.md 설계, 멀티세션, 서브에이전트, Hooks 자동화
Ch10. skills.sh 생태계 활용
추천 스킬 조합, 커스텀 스킬 제작·배포
Ch11. 보안과 코드 거버넌스
CODEOWNERS, 의존성 감사, 에이전트 보안
Ch12. 모니터링과 장애 대응
Vercel Analytics, 에러 트래킹, 인시던트 플레이북
연관 핸드북
- Claude Code 멀티세션·자동화 상세 내용은 Claude Code 고급 활용을 참고하세요.
- 에이전틱 MVP 빌드 전략은 Agentic MVP를 참고하세요.