핸드북 › 엔터프라이즈 프로젝트 설계 › 검증 리포트 한국어 English 검증 리포트 엔터프라이즈 프로젝트 설계 핸드북의 코드·링크·패턴 정합성 검증 결과
단계 검증 항목 방법 1단계 meta.json ↔ MDX 파일 일치 파일 목록 자동 비교 2단계 코드 블록 문법 오류 TypeScript/YAML/JSON 파싱 3단계 외부 링크 HTTP 상태 URL 접근 테스트 4단계 기술 정보 정확성 공식 문서 교차 검증
항목 결과 meta.json pages 수 17개 (index + 13챕터/부록 + updates + verification) MDX 파일 수 17개 (index + 12챕터 + templates + references + updates + verification) 챕터 번호 연속성 Ch1-Ch13 연속, 실무 템플릿은 부록 내부 링크 정합성 index.mdx의 Card href ↔ 실제 파일 일치 frontmatter 필수 필드 모든 파일에 title, description, updatedAt 존재
챕터 코드 블록 수 검증 결과 Ch1. 모노레포 아키텍처 3 package.json 형식 정상 Ch2. Workspace 설계 5 tsconfig extends 경로 정상 Ch3. 공유 패키지 5 exports 필드 Node.js 규격 준수 Ch4. 파이프라인 4 turbo.json 스키마 준수 Ch5. Next.js 패턴 5 App Router API 일치 (Next.js 16) Ch6. Vercel 배포 4 turbo prune 플래그 정상 Ch7. CI/CD 4 GitHub Actions 문법 정상 Ch8. 테스트 5 Vitest/Playwright 설정 정상 Ch9. Agentic 개발 4 Claude Code 설정 형식 준수 Ch10. skills.sh 3 npx skills 명령 형식 정상Ch11. 보안 4 CODEOWNERS/Renovate 형식 정상 Ch12. 모니터링 4 Sentry/Vercel SDK API 일치 부록. 실무 템플릿 7 JSON/YAML/TOML/Markdown 템플릿 형식 정상 Ch13. 레퍼런스 2 ADR 템플릿 형식 정상
카테고리 링크 수 상태 Turborepo 공식 문서 8 turbo.build 도메인 접근 가능 Next.js 공식 문서 5 nextjs.org 도메인 접근 가능 Vercel 공식 문서 8 vercel.com 도메인 접근 가능 GitHub 레포 5 github.com 접근 가능 기타 (Vitest, Playwright 등) 8 접근 가능
항목 검증 내용 결과 Turborepo dependsOn ^ 접두사 의미 — 의존 패키지 우선 실행공식 문서 일치 workspace:* Yarn workspace 프로토콜 동작 공식 문서 일치 turbo prune --docker Docker 멀티스테이지 빌드 구조 공식 문서 일치 Next.js revalidateTag App Router ISR 함수 시그니처 Next.js 16 문서 일치 Vercel 환경 변수 스코프 Production/Preview/Development 분리 공식 문서 일치 Core Web Vitals 임계값 LCP ≤2.5s, INP ≤200ms, CLS ≤0.1 web.dev 2025 기준 일치 skills.sh npx skills 설치·검색·업데이트 명령 형식 Vercel Skills v1.1.1 기준 일치 Claude Code Hooks PreToolUse/PostToolUse 구조 공식 문서 일치 Codex requirements approval/sandbox/hooks/MCP allowlist OpenAI 공식 문서 일치
검증 한계 안내
skills.sh 스킬 이름 : 저장소와 스킬 이름은 실시간으로 변동됩니다.Next.js API : Next.js 16 기준이며, 이후 버전에서 API가 변경될 수 있습니다.Vercel 기능 : Vercel 플랫폼 기능은 수시로 업데이트되므로, 최신 문서를 확인하세요.코드 예제 : 개념 설명용 간소화 코드이며, 프로덕션 그대로 복사하기보다 프로젝트에 맞게 수정해야 합니다.외부 링크 : 검증 시점의 유효성이며, 시간이 지나면 URL이 변경될 수 있습니다. 챕터 주요 변경 검증 항목 Ch3. 공유 패키지 Prisma lazy singleton, Prisma 7.x 예시 Next.js 빌드 안전 패턴, npm 최신 버전 확인 Ch4. Turborepo --affected, worktree cache sharing, 2.9 deprecationTurborepo 2.9 블로그와 caching 문서 대조 Ch5. Next.js proxy.ts, Cache Components, Node.js Proxy 런타임Next.js 16 upgrade/proxy 문서 대조 Ch6. Vercel Rolling Releases, Skew Protection, Deployment Protection, Fluid Compute Vercel 공식 문서 대조 Ch9-Ch11. Agentic/보안 version-specific 단정 제거, npx skills, Codex requirements Vercel Skills v1.1.1, OpenAI Codex 문서 대조 부록. 실무 템플릿 복사 가능한 운영 템플릿 추가 JSON/YAML/TOML/Markdown 문법 점검
챕터 주요 변경 검증 항목 Ch1. 모노레포 아키텍처 Turborepo Boundaries 추가 Turborepo 공식 문서 대조 Ch3. 공유 패키지 React 19 타입 변경 (forwardRef 제거) React 19 릴리스 노트 대조 Ch4. 파이프라인 Composable config, Sidecar, Boundaries, turbo.jsonc Turborepo 2.3/2.4 블로그 대조 Ch5. Next.js 패턴 Next.js 16: use cache, Turbopack 기본, proxy 리네임 Next.js 16 블로그 및 마이그레이션 가이드 대조 Ch6. Vercel 배포 Firewall, DDoS, Conformance, proxy.ts 리네임 Vercel 공식 문서 대조 Ch8. 테스트 전략 Vitest 4.x Browser Mode, Playwright Aria snapshots 각 공식 문서 대조 Ch9. Agentic 개발 Claude Code Agent SDK, worktree 격리, MCP, Hooks 강화 Claude Code 공식 문서 대조 Ch13. 레퍼런스 기술 선택 근거 표 갱신 (React 19, Tailwind 4, 버전 업데이트) 각 공식 릴리스 대조
범위 안내
Turborepo Boundaries는 2026년 3월 기준 실험적(experimental) 기능이며, API가 변경될 수 있습니다.
Next.js 16의 proxy.ts 리네임은 기존 middleware.ts와 하위 호환되지만, 신규 문서는 Proxy를 기준으로 작성합니다.
분기별로 외부 링크 유효성 재검증
Next.js/Turborepo 메이저 업데이트 시 코드 예제 업데이트
skills.sh 생태계 변화에 따른 Ch10 스킬 목록 갱신
실제 프로젝트 적용 피드백을 반영한 패턴 보강
관련 문서