엔터프라이즈 프로젝트 설계
Next.js + Turborepo + Vercel 환경에서 다수 서비스를 설계·운영하는 시니어 개발자를 위한 실전 가이드
최근 수정된 챕터
Claude Code 중심 CLAUDE.md 설계, 멀티세션, 서브에이전트, Hooks 자동화
GitHub Actions + Turborepo, 병렬 빌드, 선택적 테스트, 릴리스 전략
Vercel Analytics, 에러 트래킹, 성능 모니터링, 인시던트 플레이북
Turborepo 기반 apps/packages 분리 전략, 의존성 방향, 네이밍 규칙
Multi-zone, Cache Components, Proxy, Server Actions, Route Handlers, 런타임 선택
Next.js 앱을 하나 만드는 것은 쉽습니다. 이 핸드북은 세 개 이상의 서비스를 동시에 설계·배포·운영하면서 Claude Code로 개발 속도까지 끌어올리는 법을 다룹니다.
대상 독자
Turborepo 모노레포에서 Next.js 앱 여러 개를 운영해야 하는 시니어 개발자. 기본 사용법은 생략하고 엔터프라이즈 패턴·Agentic 자동화·보안 중심으로 구성합니다.
2026-05-14 업데이트
- Next.js 16.2+:
proxy.ts중심 라우팅 경계,cacheComponents/use cache, Node.js Proxy 런타임 기준으로 Ch5 갱신 - Turborepo 2.9+:
--affected, Git worktree 캐시 공유,cacheDir주의사항, daemon deprecation 기준으로 Ch4 갱신 - Vercel 배포 운영: Rolling Releases, Skew Protection, Deployment Protection, Fluid Compute를 Ch6 배포 전략에 추가
- skills.sh v1.1+: deprecated
npx add-skill대신npx skills find/add/update흐름으로 Ch10 갱신 - 에이전트 거버넌스: Codex
requirements.toml, MCP allowlist, managed hooks, 승인 정책 템플릿을 Ch11과 부록에 추가
핸드북 구조
목차
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, Cache Components, Proxy, Server Actions, 런타임 선택
Ch6. Vercel 배포 전략
모노레포 배포, Preview 환경, turbo prune
Ch7. CI/CD 파이프라인 설계
GitHub Actions + Turborepo, affected 감지, Changesets
Ch8. 테스트 전략
모노레포 테스트 피라미드, Vitest, Playwright
Ch9. Agentic 개발 체계
CLAUDE.md 설계, 멀티세션, 서브에이전트, Hooks 자동화
Ch10. skills.sh 생태계 활용
npx skills CLI, 추천 스킬 조합, 커스텀 스킬 제작·배포
Ch11. 보안과 코드 거버넌스
CODEOWNERS, 의존성 감사, 에이전트 보안
Ch12. 모니터링과 장애 대응
Vercel Analytics, 에러 트래킹, 인시던트 플레이북
부록. 실무 템플릿
turbo.json, CI, CODEOWNERS, Codex requirements, 인시던트 런북
Ch13. 레퍼런스와 아키텍처 결정 기록
ADR 템플릿, 기술 선택 근거, 전체 참고 문헌
부록. 검증 리포트
핸드북 콘텐츠의 정합성·링크·예제 검증 결과
연관 핸드북
- Claude Code 멀티세션·자동화 상세 내용은 Claude Code 고급 활용을 참고하세요.
- 에이전틱 MVP 빌드 전략은 Agentic MVP를 참고하세요.