아키텍처 의사결정 기록 (Architecture Decision Record, ADR) 작성
ADR (Architecture Decision Record) 는 소프트웨어 아키텍처 결정의 이유와 맥락을 명확히 기록하는 문서입니다.
2025년 07월 07일

아키텍처 결정 기록 (ADR, Architecture Decision Record)
ADR은 소프트웨어 아키텍처에 관한 중요한 결정을 문서화하는 짧은 텍스트 파일입니다. “왜” 특정 기술이나 접근 방식을 선택했는지에 대한 맥락, 결정 내용, 그리고 그로 인한 결과를 기록하여 미래의 팀원들이나 자기 자신이 과거의 의사결정을 쉽게 이해하도록 돕습니다.
ADR의 장점
- 지식 공유: 팀 전체가 아키텍처 결정의 배경을 이해할 수 있습니다.
- 신규 팀원 온보딩: 새로운 멤버가 프로젝트의 기술적 역사를 빠르게 파악할 수 있습니다.
- 논의 반복 방지: 과거에 왜 특정 선택을 했는지 기록이 남아있어 동일한 논의를 반복하지 않아도 됩니다.
- 책임과 투명성: 결정 과정을 투명하게 만들어 책임 소재를 명확히 합니다.
ADR (Architecture Decision Record) 기본 템플릿
프로젝트 docs/adr 폴더 등에 마크다운(.md) 파일로 저장하는 것이 일반적입니다. 파일명은 ADR-001-결정-요약.md 와 같이 번호와 제목을 포함합니다.
