Monorepo vs Polyrepo 논쟁을 넘어선 Dependency Graph 중심 설계

Monorepo vs polyrepo: the debate is measuring the wrong thing

Daniel Westgaard2026년 6월 7일19분intermediate

AI 요약

Context

레포지토리 구조 결정 시 단순 관리 편의성보다 의존성 가시성 확보가 핵심인 상황. Monorepo는 원자적 변경이 가능하나 빌드 인프라 비용이 증가하며, Polyrepo는 팀 자율성은 높으나 전역적 의존성 파악이 어려운 한계 존재.

Atomic Cross-project Change 구현을 통한 API 계약 변경 및 클라이언트 업데이트의 단일 Commit 처리
Build Graph 기반의 Bazel, Nx 도입으로 변경 사항만 선별적으로 빌드하는 Change Detection 및 Remote Caching 적용
Polyrepo 환경 내 Manifest(Terraform, Dockerfile, go.mod) 파싱을 통한 가상 Dependency Graph 구축
AI Coding Agent의 효율적 컨텍스트 제공을 위해 전역 덤프 대신 Directory-scoped Rules 및 MCP Server 활용
단순 Co-location이 아닌 쿼리 가능한 구조적 데이터 제공을 통한 의존성 분석 비용 절감

실천 포인트

1. 강한 결합도와 조정된 릴리즈가 우선이라면 빌드 인프라 투자 전제로 Monorepo 검토

2. 팀 자율성과 이기종 스택 운영이 중요하다면 Polyrepo 유지 및 의존성 매핑 도구 도입

3. AI Agent 도입 시 단순 코드 제공보다 MCP Server 등을 통한 구조화된 메타데이터 제공 방안 수립

4. Polyrepo 사용 시 Manifest 파일을 분석하여 전역 의존성 그래프를 가시화하는 프로세스 구축

태그