feat: Wiki 지식 자산 업데이트 - UX Scenarios, Frontend, Game Design, Topics 추가 [2026-05-08]
This commit is contained in:
@@ -1,18 +1,29 @@
|
||||
---
|
||||
category: Unified
|
||||
id: wiki-2026-0508-코드베이스-투어-codebase-tours
|
||||
title: 코드베이스 투어 Codebase Tours
|
||||
category: 10_Wiki/Topics
|
||||
status: needs_review
|
||||
canonical_id: self
|
||||
aliases: []
|
||||
duplicate_of: none
|
||||
source_trust_level: A
|
||||
confidence_score: 0.92
|
||||
tags: [auto-wikified, technical-documentation]
|
||||
title: 코드베이스 투어 (Codebase Tours)
|
||||
description: "코드베이스 투어(Codebase Tours)는 특정 기능이나 역할에 맞춰 코드베이스를 단계별로 안내하는 대화형 가이드(Interactive guided tour)입니다 [1, 2]."
|
||||
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
|
||||
---
|
||||
|
||||
# 코드베이스 투어 (Codebase Tours)
|
||||
|
||||
## 📌 Brief Summary
|
||||
## 📌 한 줄 통찰 (The Karpathy Summary)
|
||||
코드베이스 투어(Codebase Tours)는 특정 기능이나 역할에 맞춰 코드베이스를 단계별로 안내하는 대화형 가이드(Interactive guided tour)입니다 [1, 2]. 신규 개발자의 온보딩을 돕거나 팀의 리팩토링 과정을 설명하기 위해 사용되며, 기존의 1대1 멘토링 시간을 크게 절약해 줍니다 [1, 3, 4]. 한 번 구축해 두면 개발자의 경력 수준이나 소속 팀에 맞춰 개인화된 학습 경험을 지속적으로 제공할 수 있습니다 [2, 4, 5].
|
||||
|
||||
## 📖 Core Content
|
||||
|
||||
## 📖 구조화된 지식 (Synthesized Content)
|
||||
* **대화형 단계별 가이드 (Interactive Guided Tour):**
|
||||
코드베이스 투어는 개발자가 특정 기능을 수행하기 위해 코드베이스를 단계별로 거쳐 가도록 안내합니다 [1]. 예를 들어, 리팩토링을 주도하는 팀 리더가 작업이 필요한 코드 요소를 보여주는 단계별 투어를 만들거나, 신규 입사자에게 코드 컴포넌트 간의 상호작용 방식을 안내하는 용도로 활용됩니다 [1].
|
||||
* **사용자 맞춤형 투어 구성 (Customization):**
|
||||
@@ -26,13 +37,12 @@ last_updated: 2026-05-02
|
||||
* **주요 이점 (Benefits):**
|
||||
코드 이해도 향상, 협업 증진, 코드 유지보수성 개선, 버그 수정 속도 단축, 개발 시간 단축, 그리고 효율적인 코드 리뷰에 기여합니다 [2]. 한 번 만들어두면 계속 사용할 수 있어("Build once; use forever") 경험이 많은 시니어 팀원의 귀중한 시간을 절약해 줍니다 [4].
|
||||
|
||||
## ⚖️ Trade-offs & Caveats
|
||||
## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
|
||||
* 코드베이스 투어를 설계하고 구축하는 데에는 팀 리더나 숙련된 개발자의 초기 시간과 노력이 투자되어야 합니다 [1, 4].
|
||||
* 신규 개발자의 수준(주니어 vs 시니어)이나 팀의 특성에 맞춰 투어를 세심하게 커스터마이징하지 않으면, 적절한 정보를 제공하지 못해 도구의 효용성이 떨어질 수 있습니다 [4, 5].
|
||||
* 복잡한 PR에 대해 투어 생성을 요구하는 자동화를 도입할 경우, 이는 온보딩에는 훌륭한 자료가 되지만 코드를 푸시하는 개발자에게는 추가적인 문서화 의무 및 작업 부담(Overhead)으로 작용할 수 있습니다 [8, 9].
|
||||
|
||||
## 🔗 Knowledge Connections
|
||||
|
||||
## 🔗 지식 연결 (Graph)
|
||||
### Related Concepts
|
||||
|
||||
#### [개념 이해/기반 지식]
|
||||
@@ -74,4 +84,53 @@ last_updated: 2026-05-02
|
||||
- 확장 방향: 시스템의 구조를 정적으로 표현하는 다이어그램이 어떻게 대화형인 코드베이스 투어와 맵의 초기 설계 기반이 되는지 이해 확장
|
||||
|
||||
---
|
||||
*Last updated: 2026-05-02*
|
||||
*Last updated: 2026-05-02*
|
||||
|
||||
## 🤖 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: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
|
||||
Reference in New Issue
Block a user