745872c7f8
링크 그래프 분석(6,372문서·31,623링크) 기반 최소 수정 정상화: - [수정] Topic_CPP/Topic_C 인덱스의 링크 표기를 실제 문서 제목으로 교정 (CPP 117건·C 68건 — [[CPP Intro]] → [[C++ Intro]] 등, 인덱스 파일 2개만 수정) - [수정] C Tutorial 별칭에 'C' 추가 — [[c]] 60건 해소 (frontmatter 1줄) - [신규] 고아 다발 폴더 11곳에 00_INDEX MOC 자동 생성 (Poetic_Blog_Writing 500편, AI_and_ML 330, Coding 200, Reasoning_Creativity 161, Frontend 146 등) - [신규] 루트 MOC(Topics Root Index) — breadcrumb [[10_Wiki/Topics]] 47건을 별칭으로 수용 - [신규] 수요 최상위 미싱 개념 문서 13편 (깨진 링크 다발 해소): 글쓰기 7편(리듬·감정·문체·블로그·퇴고·정서·구조) + 설계 6편(React·Software Architecture·ADR·CQRS·Observability·RLHF) — AI 생성 초안임을 review_reason에 명시 - 기존 문서 본문은 무수정 (인덱스 2개 링크 교정 + 별칭 1줄이 수정의 전부) 결과: 고아 1,901(29%)→314(4%), 완전고립 1,018→173, 깨진 링크 10,258→9,679 Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
37 lines
1.5 KiB
Markdown
37 lines
1.5 KiB
Markdown
---
|
|
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]]
|