# [[Trunk-based Development]]

## 📌 Brief Summary
Trunk-based Development는 개발자들이 짧은 주기로 작은 변경 사항을 중앙의 주 브랜치(주로 `main` 브랜치)에 지속적으로 병합하는 경량화된 브랜칭 워크플로우입니다 [1, 2]. 이 전략은 코드의 대규모 병합 충돌을 방지하고 코드의 빠른 통합(fast integration)을 달성하는 것을 목표로 합니다 [3, 4]. 주로 강력한 지속적 통합(CI) 환경을 갖춘 경험 많은 개발 팀에게 가장 적합한 방식이며, Git Flow와 같은 무거운 오버헤드를 피하고자 할 때 사용됩니다 [5].

## 📖 Core Content
- **핵심 원칙**: 메인 브랜치(`main`)는 직접적인 푸시(direct push)가 금지되며, 언제나 안정적이고 즉시 배포 가능한 상태(always stable, deployable)를 유지해야 합니다 [1, 2, 6].
- **단기 브랜치 운영 (Short-lived branches)**: 각 작업(Task) 당 하나의 브랜치를 생성하며, 변경 사항을 작게 유지하여 아주 짧은 주기(수일 내)에 메인 브랜치로 병합해야 합니다 [1, 2, 4].
- **빠른 통합 및 기능 플래그**: 개발자는 변경 사항을 작게 나누어 빠르게 커밋하며, 아직 완성되지 않은 기능은 기능 플래그(Feature flags)를 활용해 메인 브랜치에 병합하더라도 운영 환경에 영향을 주지 않도록 제어합니다 [4].
- **품질 보증 (PR 및 코드 리뷰)**: 코드를 병합하기 전에는 항상 풀 리퀘스트(PR)를 열어야 하며, 최소 1명 이상의 동료 리뷰(Peer Review)와 CI(지속적 통합) 테스트 통과가 필수 조건입니다 [2, 7].
- **히스토리 관리**: 깔끔한 커밋 히스토리를 유지하기 위해 스쿼시 병합(Squash merge)을 사용하며, 병합이 완료된 후에는 해당 기능 브랜치를 자동으로 삭제하여 레포지토리를 정리합니다 [2, 7].

## ⚖️ Trade-offs & Caveats
이 워크플로우는 무거운 프로세스 오버헤드를 제거하여 빠른 피드백을 제공하고, 장기 실행 브랜치(long-running branches)에서 발생하는 심각한 병합 충돌을 방지한다는 장점이 있습니다 [3, 8, 9]. 그러나 이러한 이점에는 분명한 반대 급부가 따릅니다. 먼저, 팀원들 간의 매우 긴밀한 조율(coordination)과 높은 규율이 요구됩니다 [3]. 두 번째로, 오류가 있는 코드가 병합되는 것을 막기 위해 매우 강력한 테스트 자동화와 CI 인프라가 필수적이며, 이러한 이유로 초보자보다는 숙련된 팀(very experienced teams)에게 적합합니다 [5]. 마지막으로 미완성 기능을 빠르게 병합하기 위해 기능 플래그(Feature flags)를 관리해야 하는 추가적인 복잡성과, 이를 뒷받침할 강력한 테스트 커버리지가 강제된다는 기술적 제약 사항이 있습니다 [4].

## 🔗 Knowledge Connections

### Related Concepts

#### [워크플로우 및 통합 아키텍처]
- [[Continuous Integration (CI)]]
  - 연결 이유: Trunk-based Development에서 짧은 주기로 코드를 병합할 때 메인 브랜치의 안정성을 검증하기 위한 필수 전제 조건입니다 [2, 5].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 자동화된 테스트가 통과해야만 병합을 허용하는 과정이 어떻게 빌드 실패와 버그를 사전에 차단하는지 이해할 수 있습니다.

#### [구현 및 코드 관리 도구]
- [[Feature Flags]]
  - 연결 이유: Trunk-based Development에서 코드 통합 속도를 높이기 위해, 아직 완성되지 않은 기능을 메인 브랜치에 안전하게 병합하는 데 사용되는 핵심 도구입니다 [4].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 코드의 배포(Deployment)와 기능의 릴리스(Release)를 기술적으로 어떻게 분리하여 관리할 수 있는지 파악할 수 있습니다.
- [[Squash Merge]]
  - 연결 이유: 짧은 수명의 브랜치를 자주 병합함에 따라 지저분해질 수 있는 메인 브랜치의 커밋 이력을 하나의 의미 있는 커밋으로 압축하여 깔끔하게 유지하는 병합 전략입니다 [2, 7, 10].
  - 이 개념을 통해 더 깊게 이해할 수 있는 부분: 잦은 통합 상황에서 코드 리뷰와 히스토리 추적을 용이하게 하는 Git 이력 관리 방법을 배울 수 있습니다.

### Deeper Research Questions
- Feature Branch 기반 전략에서 Trunk-based Development로 마이그레이션할 때, 개발팀의 코드 리뷰 문화와 CI 테스트 프로세스는 구체적으로 어떻게 변화해야 하는가?
- 미완성 기능을 통합하기 위해 기능 플래그(Feature flags)를 과도하게 사용할 경우 발생할 수 있는 기술 부채(Technical debt)는 무엇이며, 이를 어떻게 청산할 수 있는가?
- Trunk-based Development를 적용할 때, 스쿼시 병합(Squash merge)을 통해 깔끔한 메인 히스토리를 유지하는 것과 개별 작업 단위의 상세한 디버깅 추적성을 확보하는 것 사이의 균형은 어떻게 맞춰야 하는가?
- 경험이 적은 팀(초보 팀)이 Trunk-based Development를 도입했을 때 겪을 수 있는 가장 치명적인 문제점은 무엇이며, 이를 완화하기 위한 단계적 도입 방법은 무엇인가?
- 대규모 오픈소스 프로젝트나 대형 엔터프라이즈 환경에서 Trunk-based Development가 Git Flow 방식에 비해 가지는 구조적 한계점은 무엇인가?

### Practical Application Contexts

- **Implementation:** 작업을 매우 작은 단위 논리적 변경(atomic commits)으로 나누어 브랜치를 생성하고, 기능 플래그를 활용해 미완성 코드라도 지속적으로 메인 브랜치에 병합하는 방식으로 구현합니다 [4, 11].
- **System Design:** 코드가 메인 브랜치로 병합되기 전 자동으로 코드를 검증하는 강력한 CI(지속적 통합) 파이프라인과 브랜치 보호 규칙(Branch protection)을 시스템적으로 설계하고 연동해야 합니다 [5, 7].
- **Operation / Maintenance:** '병합 후 브랜치 자동 삭제(Auto-delete merged branches)' 설정을 켜고, 직접 푸시(direct push)를 금지하여 메인 브랜치를 항상 배포 가능한 깔끔한 상태로 유지보수합니다 [7, 11].
- **Learning Path:** 처음에는 단순한 Feature Branch 워크플로우를 통해 작은 커밋과 PR 과정을 익히고, CI가 강화되고 브랜치 수명을 수일 내로 단축할 수 있는 확신이 들 때 Trunk-based 전략으로 점진적으로 이관하는 것이 좋습니다 [4, 5].
- **My Project Relevance:** 소스에 관련 정보가 부족합니다.

### Adjacent Topics

- [[Git Flow]]
  - 확장 방향: Trunk-based Development와 대비되는 무겁고 복잡한 브랜칭 전략으로, 왜 소규모 팀이나 빠른 배포를 원하는 팀이 이 전략 대신 Trunk-based를 선택하는지 두 전략 간의 구조적 차이와 트레이드오프를 확장하여 비교해 볼 수 있습니다 [4, 5].
- [[Feature Branch Workflow]]
  - 확장 방향: 소규모 팀에 가장 친화적인 기본 워크플로우로, 이 전략의 브랜치 수명을 극단적으로 줄였을 때 어떻게 Trunk-based Development로 진화하게 되는지 연결하여 학습할 수 있습니다 [4, 12].

---
*Last updated: 2026-04-30*