feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]

10_Wiki/Topics/Architecture/Architectural Violations.md

@@ -1,14 +1,26 @@
 ---
-id: P-REINFORCE-WIKI-C08C3C0C
-category: Unified
+id: wiki-2026-0508-architectural-violations
+title: Architectural Violations
+category: 10_Wiki/Topics
+status: needs_review
+canonical_id: self
+aliases: [P-REINFORCE-WIKI-C08C3C0C]
+duplicate_of: none
+source_trust_level: A
 confidence_score: 0.95
-tags: ['architectural-violations', 'architecture-erosion', 'technical-debt', 'static-code-analysis-tools', 'software-architecture-recovery', 'architecture-principles']
+tags: [architectural-violations, architecture-erosion, technical-debt, static-code-analysis-tools, software-architecture-recovery, architecture-principles]
+raw_sources: []
 last_reinforced: 2026-05-02
+github_commit: pending
+inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
+tech_stack:
+  language: unspecified
+  framework: unspecified
 ---
 
 # [[Architectural Violations]]
 
-## 📌 Brief Summary
+## 📌 한 줄 통찰 (The Karpathy Summary)
 아키텍처 위반(Architectural Violations)은 기술 부채의 축적(accumulation of technical debt), 지식 증발(knowledge vaporization)과 함께 **소프트웨어 아키텍처 침식(Architecture erosion)을 일으키는 주요 원인 중 하나**입니다 [1]. 이는 시간이 지남에 따라 초기에 의도했던 설계와 실제 구현된 아키텍처 간의 격차가 점진적으로 벌어지는 현상을 초래합니다 [1]. 소스 내에서는 아키텍처 침식의 원인으로서 간략하게 언급되어 있으며, 아키텍처 위반이라는 단일 개념에 대한 구체적인 정의나 세부 사례에 관한 정보는 부족합니다.
 
 ## 📖 Core 소스에 관련 정보가 부족합니다.
@@ -18,13 +30,12 @@ last_reinforced: 2026-05-02
 *   **시스템에 미치는 치명적 영향**: 아키텍처 위반이 누적되어 침식이 발생하면 **소프트웨어 성능이 저하**되고, 시스템의 **진화 및 유지보수 비용(evolutionary costs)이 실질적으로 증가**하며, 전반적인 **소프트웨어 품질이 하락**하게 됩니다 [1, 2]. 
 *   **탐지 및 식별 접근법**: 이러한 위반과 침식을 조기에 발견하고 완화하기 위해 일관성 기반(consistency-based), 진화 기반(evolution-based), 결함 기반(defect-based), 결정 기반(decision-based) 접근법이 제안되었습니다 [2]. 구체적으로는 **자동화된 아키텍처 적합성 검사(automated architecture conformance checks)**와 **정적 코드 분석 도구(static code analysis tools)**, 그리고 리팩토링 기술이 식별에 활용됩니다 [2].
 
-## ⚖️ Trade-offs & Caveats
+## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
 소스에 아키텍처 위반 선택에 따른 직접적인 제약 사항이나 반대 급부(Trade-off)에 대한 세부 정보가 부족합니다. 그러나 위반을 통제하기 위한 관리적 측면에서 다음과 같은 한계와 기회비용이 존재합니다.
 
 *   **예방 및 치료적 조치의 비용 vs 방치 시의 막대한 위험**: 아키텍처 위반을 방지하기 위해서는 아키텍처 규칙 강제, 정기적인 코드 리뷰, 자동화된 테스트와 같은 **'예방적 조치(preventative measures)'**를 엄격히 시행해야 합니다 [3]. 또한 이미 발생한 위반에 대해서는 리팩토링, 재설계, 문서 업데이트 등의 **'치료적 조치(remedial measures)'**가 수반되어야 합니다 [3]. 이러한 조치들은 개발 과정에서 시간과 노력을 요구하지만, 위반을 방치할 경우 초기 설계 결함과 지속적인 변경으로 인해 2년이라는 시간을 재개발에 소모해야 했던 넷스케이프(Netscape)의 모질라(Mozilla) 브라우저 사례처럼 막대한 수리 비용과 프로젝트 지연을 감수해야만 합니다 [1, 3].
 
-## 🔗 Knowledge Connections
-
+## 🔗 지식 연결 (Graph)
 ### Related Concepts
 
 #### [소프트웨어 아키텍처 문제 및 현상]
@@ -59,4 +70,61 @@ last_reinforced: 2026-05-02
   - 확장 방향: 이미 심각한 아키텍처 위반과 침식이 진행되어 문서와 구현이 불일치하는 시스템에서, 현재 구현된 아키텍처를 역공학(reverse engineering)하여 본래의 의도와 구조를 복구해 내는 기법 및 프로세스로 이해를 확장할 수 있습니다 [3].
 
 ---
-*Last updated: 2026-05-02*
+*Last updated: 2026-05-02*
+
+## 📖 구조화된 지식 (Synthesized Content)
+
+**추출된 패턴:**
+> *(TODO)*
+
+**세부 내용:**
+- *(TODO)*
+
+## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
+
+**언제 이 지식을 쓰는가:**
+- *(TODO)*
+
+**언제 쓰면 안 되는가:**
+- *(TODO)*
+
+## 🧪 검증 상태 (Validation)
+
+- **정보 상태:** needs_review
+- **출처 신뢰도:** A
+- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
+
+## 🧬 중복 검사 (Duplicate Check)
+
+- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
+- **처리 방식:** UPDATE (자동 정규화)
+- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
+
+## 🕓 변경 이력 (Changelog)
+
+| 날짜 | 변경 내용 | 처리 방식 | 신뢰도 |
+|------|-----------|-----------|--------|
+| 2026-05-08 | P-Reinforce Phase 1 정규화 (frontmatter + 헤더 표준화) | UPDATE | A |
+
+## 💻 코드 패턴 (Code Patterns)
+
+**패턴 1:** *(TODO: 이 프로젝트 컨벤션 반영한 구조 스켈레톤)*
+
+```text
+# TODO
+```
+
+## 🤔 의사결정 기준 (Decision Criteria)
+
+**선택 A를 써야 할 때:**
+- *(TODO)*
+
+**선택 B를 써야 할 때:**
+- *(TODO)*
+
+**기본값:**
+> *(TODO)*
+
+## ❌ 안티패턴 (Anti-Patterns)
+
+- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*