fix(topics): 지식 그래프 정상화 — 고아 29%→4%, 인덱스 12개·개념 문서 13편
링크 그래프 분석(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>
This commit is contained in:
@@ -0,0 +1,36 @@
|
||||
---
|
||||
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]]
|
||||
Reference in New Issue
Block a user