개념과 목적
아키텍처 결정(Architectural Decision, AD)은 아키텍처에 중요한 기능적 또는 비기능적 요구사항을 충족하기 위한, 근거가 있는 설계 선택이다. 아키텍처 중요 요구사항(Architecturally Significant Requirement, ASR)은 소프트웨어 및 하드웨어 시스템의 아키텍처와 품질에 측정 가능한 영향을 미치는 요구사항이다.
아키텍처 결정 기록(Architectural Decision Record, ADR)은 하나의 AD와 그 근거를 기록한다. 이를 통해 선택한 아키텍처 결정의 이유와 절충점, 결과를 파악할 수 있다. 프로젝트에서 작성하고 관리하는 ADR의 모음은 해당 프로젝트의 의사결정 기록을 이룬다. 이 개념은 아키텍처 지식 관리(Architectural Knowledge Management, AKM)에 속하지만, ADR은 설계 및 다른 결정까지 기록하는 용도로 확장해 사용할 수 있다.
GitHub adr 조직은 다음을 목표로 한다.
- AD를 기록해야 하는 이유와 이점을 알리고 공통 용어를 정립한다.
- 애자일 관행과 반복적·점진적 엔지니어링 프로세스를 뒷받침하도록 ADR 도구를 강화한다.
- AKM과 ADR에 관한 공개 지식 자료를 안내한다.
미디어와 참고 자료
- 독일어 발표 아키텍처 결정을 가시적이고 이해하기 쉽게 만들기는 JavaLand 2026에서 2026년 3월 10일 진행됐다.
- Azure Well-Architected Framework는 ADR과 이 웹사이트를 소개한다(2024년 11월 10일).
- 마이클 킬링(Michael Keeling)이 IEEE Software 39권 4호의 Pragmatic Designer 칼럼에 기고한 사랑은 이루어지지 않았다: 아키텍처와 애자일의 이야기, 그리고 아키텍처 결정 기록이 둘을 연결한 방법이 있다. PDF
- LeanPub 전자책 Design Practice Reference는 아키텍처 결정 기록을 핵심 활동 가운데 하나로 다룬다.
- Pearson의 Addison Wesley Signature Series에 실린 Patterns for API Design: Simplifying Integration with Loosely Coupled Message Exchanges 3장은 API 설계의 개념을 안내하는 여섯 가지 서사를 소개한다. 여기에는 선택지와 기준이 있는 반복적 결정 29개가 담겼다. 자세한 내용은 블로그 게시물에서 확인할 수 있다.
- 독일어 기사 잘 기록하기: Architecture Decision Records는 계정 @obfischer가 작성해 heise online에 게재됐다.
배경과 안내
adr 조직의 작업은 츠둔(Zdun) 등 연구자의 지속 가능한 아키텍처 결정에 담긴 지침과 원칙을 바탕으로 한다. 해당 글에서 제안한 Y-문장 형식도 그 예다.
보다 일반적인 배경 정보와 ADR 안내 자료는 다음과 같다.
- WICSA 2015 학회 논문 프로젝트 전반의 아키텍처 결정 안내 — 문제 공간 모델링, 결정 백로그 관리와 클라우드 컴퓨팅 지식은 일곱 가지 템플릿을 비교한다.
- 아키텍처 결정 — 만들어지는 과정은 1990년대 후반부터 이어진 아키텍처 결정 기록의 역사와 사례, 결정 근거 작성 안내를 제공한다.
- 마이클 나이가드(Michael Nygard)가 2011년에 작성해 이 개념을 널리 알린 블로그 글은 아키텍처 결정 문서화하기다.
- 아키텍처 결정 기록(ADR): 개방적이고 투명한 의사결정 이력은 Open Practice Library의 실천 방법이다.
- AWS Prescriptive Guidance는 소프트웨어 개발 프로젝트의 기술적 의사결정을 간소화하기 위해 아키텍처 결정 기록을 사용할 것을 권고한다.
- 마이클 킬링(IBM Watson Group)과 조 룬데(IBM)의 발표 실전 아키텍처 결정 기록은 실증 수치를 포함한다.
- 마크 리처즈의 동영상 시리즈 ADR과 아키텍처 스토리는 나이가드의 템플릿을 바탕으로 ADR을 설명한다.
- 추가 자료와 링크는 아키텍처 지식 관리(AKM) 웹페이지에서 확인할 수 있다.
댓글 (0)
로그인하면 이 기사에 내 생각을 남길 수 있어요