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

10_Wiki/Topics/Backend/대규모 확장성과 유지보수성이 요구되는 프런트엔드 모노레포 프로젝트.md

@@ -1,9 +1,29 @@
+---
+id: wiki-2026-0508-대규모-확장성과-유지보수성이-요구되는-프런트엔드-모노레포-
+title: 대규모 확장성과 유지보수성이 요구되는 프런트엔드 모노레포 프로젝트
+category: 10_Wiki/Topics
+status: needs_review
+canonical_id: self
+aliases: []
+duplicate_of: none
+source_trust_level: A
+confidence_score: 0.92
+tags: [uncategorized]
+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
+---
+
 # [[대규모 확장성과 유지보수성이 요구되는 프런트엔드 모노레포 프로젝트|대규모 확장성과 유지보수성이 요구되는 프런트엔드 모노레포 프로젝트]]
 
-## 📌 Brief Summary
+## 📌 한 줄 통찰 (The Karpathy Summary)
 현대적인 프런트엔드 모노레포는 웹 앱, 어드민, 모바일 웹 및 공유 UI 라이브러리와 같은 여러 프런트엔드 프로젝트를 단일 Git 저장소에서 관리하며 일관된 의존성 그래프로 연결하는 구조입니다 [1, 2]. 이는 UI 원시(primitives), 디자인 토큰, 라우팅 규칙 등을 공유하는 다수의 애플리케이션 간의 일관성을 유지하는 데 필수적입니다 [2, 3]. 강력한 빌드 도구와 아키텍처 규칙(예: FSD)을 통해 모듈 간의 결합도를 낮추고 응집도를 높임으로써, 원자적 리팩터링(atomic refactors)을 지원하고 대규모 프런트엔드 플랫폼을 효율적으로 확장할 수 있게 합니다 [2, 4, 5].
 
-## 📖 Core Content
+## 📖 구조화된 지식 (Synthesized Content)
 - **아키텍처 원칙 및 경계 강제 ([[Boundaries|Boundaries]] & [[Public APIs|Public APIs]]):**
   확장 가능한 모노레포는 단순히 여러 폴더의 집합이 아니라, 강제된 경계와 명확한 의존성 방향을 가진 모듈 시스템입니다 [1, 6]. UI 컴포넌트 패키지가 내부 깊숙한 파일 경로로 직접 참조(deep imports)되는 것을 방지하기 위해, 패키지별로 단일 진입점(`src/index.ts`)을 통한 **명시적인 공개 API(Public API)**를 구성해야 합니다 [7-9]. 또한, 공유 UI 원시 요소(Shared UI primitives)는 상위 계층의 비즈니스 기능(Feature) 패키지를 절대 임포트하지 않도록 엄격한 **계층적 의존성(Layered Dependencies)**을 유지해야 합니다 [10, 11].
 
@@ -19,10 +39,64 @@
 - **CI/CD 및 성능 최적화 (CI/CD & Caching):**
   대규모 컴포넌트 라이브러리를 공유할 때 모든 PR이 전체 시스템을 다시 빌드하게 하면 막대한 비용이 발생합니다 [2, 9]. 따라서 "영향을 받는(affected) 앱과 패키지만 빌드 및 배포한다"는 전략이 필수적입니다 [23, 24]. 원격 캐싱(Remote caching)을 활용하면 머신 간 빌드 결과물을 재사용할 수 있어, 공통 UI 패키지가 변경될 때 발생하는 피드백 루프와 연산 비용을 획기적으로 줄일 수 있습니다 [9, 25].
 
-## 🔗 Knowledge Connections
+## 🔗 지식 연결 (Graph)
 - **Related Topics:** [[Feature-Sliced Design (FSD)|Feature-Sliced Design (FSD]], Turborepo 및 Nx 빌드 시스템, Reusable UI Components, Design Tokens, React Server Components (RSC
 - **Projects/Contexts:** Uber의 Base Web 등 다양한 내부 앱 관리를 위한 디자인 시스템 도입, 확장 가능한 프런트엔드를 위한 의존성 및 패키지 구조화
 - **Contradictions/Notes:** 모노레포 아키텍처는 코드 공유와 원자적 커밋의 이점을 제공하지만, "공유 모듈이 무분별하게 참조되는 스파게티 코드(spaghetti sharing)"를 유발할 위험이 있습니다. 소스에서는 이를 방지하기 위해 린트(Lint) 규칙, 엄격한 코드 소유권(CODEOWNERS), FSD와 같은 경계 강제가 없으면 오히려 통합 비용이 급증할 수 있다고 경고합니다 [1, 8, 26, 27]. 또한, 서로 코드를 공유할 필요가 거의 없는 완전히 독립적인 제품들의 경우 폴리레포(Polyrepo)가 더 안전한 선택이라고 조언합니다 [28].
 
 ---
-*Last updated: 2026-04-26*
+*Last updated: 2026-04-26*
+
+## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
+
+**언제 이 지식을 쓰는가:**
+- *(TODO)*
+
+**언제 쓰면 안 되는가:**
+- *(TODO)*
+
+## 🧪 검증 상태 (Validation)
+
+- **정보 상태:** needs_review
+- **출처 신뢰도:** A
+- **검토 이유:** *(P-Reinforce Phase 1 자동 정규화. 본문 검증 필요.)*
+
+## 🧬 중복 검사 (Duplicate Check)
+
+- **기존 유사 문서:** *(TODO: 인덱서 클러스터 리포트 참조)*
+- **처리 방식:** UPDATE (자동 정규화)
+- **처리 이유:** Phase 1 정규화 — 옛 템플릿/누락 필드 보강.
+
+## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
+
+- **과거 데이터와의 충돌:** 없음
+- **정책 변화:** 없음
+
+## 🕓 변경 이력 (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: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*