ADR은 깃 저장소 안의 마크다운이라서 /update-docs로 함께 추적됩니다. 매 장에서 새 ADR이 추가될 때마다 같은 파일이 한 항목씩 늘어납니다.
▼ 표 5-1 매 장마다 누적되는 ADR과 결정된 도구들
|
시점 |
ADR 누적 |
신규 결정 |
|
3장 |
ADR-001~002 |
ArgoCD, GitHub Actions |
|
4장 |
ADR-003~005 |
Prometheus와 Grafana, Loki와 Fluent Bit, PrometheusRule |
|
5장 |
ADR-006~007 |
Gateway API, Blue/Green |
|
6장 |
ADR-008~010 |
Valkey, Secret Manager CSI, Canary 전환 |
|
7장 |
ADR-011~013 |
노드풀 분리, App of Apps, 멀티 테넌시 |
|
8장 |
ADR-014~016 |
Kafka, Tempo, CronJob |
메모리가 나의 작업 컨텍스트를 책임진다면, ADR은 팀의 결정 기록을 책임집니다. 두 가지가 합쳐져야 결정의 컨텍스트가 내 PC를 넘어 팀에 전달됩니다.
9장 회고에서 ‘지금까지 어떤 결정을 했고 왜 그랬는지 정리해줘’라고 하면 클로드 코드가 ADR을 모두 시간 순서대로 종합합니다. 깃 커밋 히스토리는 ‘무엇을 바꿨는지’를, ADR은 ‘왜 바꿨는지’를 보여줍니다.