---
id: adr
title: "ADR"
category: "Architecture"
status: "draft"
verification_status: "conceptual"
canonical_id: ""
aliases: ["ADR", "Architecture Decision Record", "아키텍처 결정 기록"]
duplicate_of: ""
source_trust_level: "B"
confidence_score: 0.80
created_at: 2026-07-11
updated_at: 2026-07-11
review_reason: "깨진 링크 다발 해소용 AI 생성 초안 — 원출처 리서치로 검증·보강 권장"
merge_history: []
tags: ["architecture","documentation"]
raw_sources: []
applied_in: []
github_commit: ""
---

# [[ADR]]

## 🎯 한 줄 통찰 (One-line insight)
아키텍처 결정을 "무엇을·왜·무엇을 포기하고" 선택했는지 한 장으로 남기는 기록 — 코드는 결과만 보여주고, ADR은 이유를 보존한다.

## 🧠 핵심 개념 (Core concepts)
- **구성 요소** — 맥락(Context) / 결정(Decision) / 결과(Consequences) 세 부분이 핵심. 상태(제안/승인/폐기)를 함께 관리한다.
- **불변 기록** — 결정이 바뀌면 기존 ADR 을 수정하지 않고 새 ADR 이 이전 것을 대체(supersede)한다. 결정의 역사가 남는다.
- **작성 시점** — 되돌리기 비싼 결정(프레임워크, 데이터 저장 방식, 통신 방식, 경계 설계)을 내릴 때마다 짧게라도 쓴다.

## 🧩 추출된 패턴 (Extracted patterns)
- "6개월 뒤의 나(또는 새 팀원)가 왜 이렇게 됐는지 물을 결정인가?"가 ADR 작성 여부의 판별식이다.

## 🔗 Knowledge Connections
- **Related Topics:** [[Software Architecture]] · [[CQRS]]