monorepo 탐색 패턴
워크플로우중급
수십 개의 패키지가 있는 monorepo는 Claude Code에게 탐색 과제를 만듭니다. 가이드 없이는 관련 없는 패키지를 읽느라 컨텍스트를 낭비합니다. 이 패턴은 CLAUDE.md를 사용하여 패키지 맵, 의존성 그래프, 라우팅 규칙을 제공함으로써 Claude가 정확히 어디를 봐야 하는지 알게 합니다. 크로스 패키지 변경, 공유 타입 업데이트, 패키지별 오버라이드를 위한 컨벤션을 포함합니다.
monorepo탐색Turborepo워크스페이스
패턴 코드
# Monorepo Navigation Pattern
## Root CLAUDE.md — Package Map
```markdown
# Monorepo: Acme Platform
## Package Map
| Package | Path | Purpose | Owner |
|---------|------|---------|-------|
| @acme/web | apps/web | Next.js frontend | frontend-team |
| @acme/api | apps/api | Express API server | backend-team |
| @acme/admin | apps/admin | Admin dashboard | frontend-team |
| @acme/ui | packages/ui | Shared UI components | design-system |
| @acme/types | packages/types | Shared TypeScript types | all |
| @acme/db | packages/db | Database client + schema | backend-team |
| @acme/auth | packages/auth | Auth utilities | security-team |
| @acme/config | packages/config | Shared configs (ESLint, TS) | infra-team |
## Dependency Graph (simplified)
web → ui, types, auth, config
api → types, db, auth, config
admin → ui, types, auth, config
ui → types, config
db → types, config
## Routing Rules
- UI changes: start in packages/ui, then check apps/{web,admin}
- Type changes: update packages/types, then fix ALL consumers
- Auth changes: update packages/auth, verify in apps/api first
- Schema changes: packages/db first, then packages/types, then apps/api
## Cross-Package Change Checklist
1. Update the source package
2. Run `turbo build --filter=...^...` to check dependents
3. Update consumers if the public API changed
4. Run `turbo test` from root to verify everything
```
## Package-Level CLAUDE.md (apps/api/CLAUDE.md)
```markdown
# @acme/api
## Entry Point
- src/index.ts (Express app setup)
- src/routes/ (route definitions, one file per resource)
## Testing
- Run: `pnpm --filter @acme/api test`
- Integration tests need DATABASE_URL set
## Local Dependencies
- @acme/types: import { User, Order } from "@acme/types"
- @acme/db: import { db } from "@acme/db"
- @acme/auth: import { verifyToken } from "@acme/auth"
```
이 패턴을 프로젝트 설정에 복사하여 적용하세요.
실행 미리보기
monorepo 탐색 패턴
monorepo 탐색 패턴에 대해
Claude Code 패턴은 복잡한 개발 시나리오를 효과적으로 다루기 위한 검증된 아키텍처 설계와 워크플로우 구조입니다. monorepo 탐색 패턴은(는) 중급 수준의 워크플로우 패턴으로, 프로젝트에 맞게 응용할 수 있는 테스트된 반복 가능한 접근 방식을 제공하여 더 효율적이고 일관된 결과를 만들어 냅니다.