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

10_Wiki/Topics/AI_and_ML/Code_Smells.md

@@ -1,16 +1,29 @@
 ---
-category: Unified
+id: wiki-2026-0508-code-smells
+title: Code Smells
+category: 10_Wiki/Topics
+status: needs_review
+canonical_id: self
+aliases: []
+duplicate_of: none
+source_trust_level: A
+confidence_score: 0.92
 tags: [auto-consolidated, technical-documentation]
-title: [[코드 악취 식별과 리팩토링 징후 (Code Smells)]]
-last_updated: 2026-05-02
+raw_sources: []
+last_reinforced: 2026-05-08
+github_commit: pending
+inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
+tech_stack:
+  language: unspecified
+  framework: unspecified
 ---
 
 # [[코드 악취 식별과 리팩토링 징후 (Code Smells)]]
 
-## 📌 Brief Summary
+## 📌 한 줄 통찰 (The Karpathy Summary)
 No summary available.
 
-## 📖 Core Content
+## 📖 구조화된 지식 (Synthesized Content)
 소스 코드에 명시된 리팩토링 카탈로그에 따르면, 코드 악취는 코드베이스를 읽고 구조를 파악하는 데 방해가 되는 여러 가지 패턴으로 분류됩니다 [4, 5]. (※ 소스에는 각 코드 악취에 대한 구체적인 작동 원리나 상세 설명은 부족하며, 주로 분류 체계 및 목록 위주의 정보가 제공됩니다.)
 
 *   **비대화 (Bloaters)**
@@ -33,14 +46,14 @@ No summary available.
 
 이러한 코드 악취들은 코드 분석 도구(Code Analysis Tools)에 의해 식별될 수 있으며, 이를 정리하면 더 적은 버그, 더 나은 유지보수성, 팀의 생산성 증가라는 결과를 가져옵니다 [2].
 
-## ⚖️ Trade-offs & Caveats
+## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
 *※ 소스에 코드 악취 해결(리팩토링) 자체에 대한 명시적인 부작용이나 제약 사항이 깊이 있게 서술되어 있지는 않습니다. 다만 코드 분석 및 리팩토링의 맥락에서 다음 사항들을 유추 및 확인할 수 있습니다.*
 
 *   **오탐(False Positives)으로 인한 피로감:** 코드 악취나 취약점을 잡기 위해 자동화된 코드 스캐닝 도구를 무분별하게 사용할 경우, 잘못된 경고(False Positives)가 과도하게 발생할 수 있습니다. 이는 개발자의 신뢰를 떨어뜨리고 리뷰에 불필요한 시간을 낭비하게 만드는 부작용(Alert Fatigue)을 낳을 수 있습니다 [6-9].
 *   **성능과 개발 속도 저하:** 코드 악취를 찾기 위한 도구가 파이프라인 성능에 영향을 주거나 통합이 원활하지 않으면 시스템 릴리스 주기를 지연시키고 개발자의 경험을 저해할 수 있습니다 [9, 10].
 *   **섣부른 추상화 경계:** '추측성 일반화'와 같은 악취를 예방하기 위한 지나친 리팩토링이나, 코드 악취인 '중복 코드'를 제거하기 위한 조기 추상화는 오히려 코드의 복잡성을 가중시킬 수 있습니다 [11].
 
-## 🔗 Knowledge Connections
+## 🔗 지식 연결 (Graph)
 - [[Refactoring]]: 코드 악취를 제거하기 위한 구체적인 기술적 해법.
 - [[Technical_Debt]]: 코드 악취를 방치했을 때 축적되는 결과물.
 - [[Clean_Code]]: 코드 악취가 없는 상태의 지향점.
@@ -137,4 +150,41 @@ No summary available.
 ## 🧬 중복 검사 (Duplicate Check)
 - **기존 유사 문서:** None
 - **처리 방식:** CREATE
-- **처리 이유:** 신규 지식 체계 도입
+- **처리 이유:** 신규 지식 체계 도입
+
+## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
+
+**언제 이 지식을 쓰는가:**
+- *(TODO)*
+
+**언제 쓰면 안 되는가:**
+- *(TODO)*
+
+## 🕓 변경 이력 (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: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*