아키텍처 결정 기록 (ADR)

아키텍처적으로 중요한 단일 결정과 그 맥락, 그리고 결과를 담은 짧은 문서입니다.

아키텍처 결정 기록 (ADR)란?

ADR은 결정을 미래의 동료들이 이해할 수 있도록 만듭니다. 일반적으로 맥락(어떤 힘이 작용했는지), 결정, 검토된 대안, 그리고 결과(이제 감수하게 된 트레이드오프)를 기록합니다. ADR은 코드와 함께 버전 관리되며, 수정되기보다 새로운 기록으로 대체됩니다. 사고의 역사가 현재의 답만큼이나 가치 있기 때문입니다.

다른 이름: adr.

관련 용어

  • 아키텍처 드리프트 — 문서화된 아키텍처와 실제로 프로덕션에서 동작하는 시스템 사이에 벌어지는 격차입니다.
  • 리빙 도큐멘테이션 — 동작하는 시스템으로부터 생성되거나 검증되어, 시스템이 발전해도 정확성을 유지하는 문서입니다.

자세히 보기