엔터프라이즈 프로젝트 설계
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 자동화·보안 중심으로 구성합니다.
문서 업데이트
Next.js·Turborepo·Vercel 운영 기준의 변경 기록은 업데이트 내역에서 확인할 수 있습니다.
핸드북 구조
목차
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를 참고하세요.