docs(10_Wiki): 위키 전체 재구성 — Topic_* 폴더를 4개 카테고리로 통합 + 대규모 중복 제거

Topic_Agent/Topic_Blog/Topics/Topics_Biz/Topics_Meeting/Topics_Rag의 마크다운 지식 문서를
Topic_General/Topic_Programming/Topic_Graphic/Topic_Business 4개 카테고리로 재분류.

- 중복 제거: frontmatter의 status:duplicate/merged + duplicate_of/redirect_to 필드로
  자기 자신을 중복으로 선언한 리다이렉트 stub 1032개 제거, 완전 동일 내용 파일 472개 제거,
  동일 파일명·다른 내용 충돌 시 더 큰(완전한) 버전만 유지(162개 제거) — 총 1639개 중복 제거.
- 분류: 폴더 단위로 명확한 항목(AI_and_ML/Coding/Architecture 등 → Programming,
  Comfyui/Visual_Effects → Graphic, Topics_Biz/Topics_Meeting/사업 등 → Business,
  Poetic_Blog_Writing/창의성/Game_Design 등 → General)은 폴더 우선순위로,
  나머지 혼재 폴더(Topic_Agent/Topic_Blog/Topics 루트/Thinking & Reasoning/Other/UI_UX_Assets)는
  title/tags 키워드 스코어링으로 파일 단위 분류(불명확한 경우 General로 폴백).
  원본 폴더명은 "From_*" 서브폴더로 보존해 추적 가능성 유지.
- 최종 배치: Programming 2784 / General 1608 / Graphic 285 / Business 249 = 4926개 문서.
- 에이전트 운영 상태(.astra/.agent/.obsidian/sessions/memory/_company/docs/lessons/_shared/src)는
  지식 콘텐츠가 아니므로 재분류 대상에서 제외하고 원위치 유지.
- Topics/Topic_email(상위 보호 폴더 Topic_email과 파일명 100% 중복) 삭제 — 보호 폴더 자체는 미변경.
- 완전히 비게 된 Topic_Agent/Topic_Blog/Topics_Biz/Topics_Rag 폴더 제거.
This commit is contained in:
Antigravity Agent
2026-07-05 00:33:48 +09:00
parent 1cfd3bbb56
commit 9148c358d0
6455 changed files with 1 additions and 86875 deletions
@@ -0,0 +1,131 @@
---
id: devops-monorepo-patterns
title: Monorepo — Turborepo / Nx / pnpm workspaces
category: Coding
status: draft
source_trust_level: B
verification_status: conceptual
created_at: 2026-05-09
updated_at: 2026-05-09
tags: [devops, monorepo, turborepo, pnpm, vibe-coding]
tech_stack: { language: "Node.js / pnpm / Turborepo", applicable_to: ["Web", "Backend"] }
applied_in: []
aliases: [workspace, packages, pnpm, turborepo, nx]
---
# Monorepo
> 한 repo 에 여러 패키지. **공유 코드 + 원자적 변경 + 통합 CI** 의 장점, **빌드 캐시 / 부분 build 가 핵심**. pnpm workspaces + Turborepo / Nx 가 2026 스택.
## 📖 핵심 개념
- Workspace: package.json 의 `workspaces` 또는 pnpm-workspace.yaml.
- Task graph: turbo.json 또는 nx.json — 패키지 간 의존성 + 캐시.
- 변경 감지: `--filter ...[HEAD~1]` 으로 영향 받는 패키지만.
## 💻 코드 패턴
### pnpm workspaces
```yaml
# pnpm-workspace.yaml
packages:
- "apps/*"
- "packages/*"
```
```
.
├── apps/
│ ├── web/ # Next.js
│ └── mobile/ # React Native
├── packages/
│ ├── ui/ # 공유 UI 컴포넌트
│ ├── shared/ # 공유 로직
│ └── eslint-config/
└── pnpm-workspace.yaml
```
### 패키지 간 의존
```json
// apps/web/package.json
{
"dependencies": {
"@scope/ui": "workspace:*",
"@scope/shared": "workspace:*"
}
}
```
### Turborepo task graph
```json
// turbo.json
{
"$schema": "https://turbo.build/schema.json",
"tasks": {
"build": {
"dependsOn": ["^build"], // 의존 패키지 build 먼저
"outputs": ["dist/**", ".next/**"],
"inputs": ["src/**", "package.json"]
},
"test": {
"dependsOn": ["^build"],
"outputs": ["coverage/**"]
},
"lint": { "dependsOn": [] },
"dev": { "cache": false, "persistent": true }
}
}
```
```bash
turbo run build # 모든 패키지 build (의존 순서 + 캐시)
turbo run test --filter=@scope/ui
turbo run build --filter=...[HEAD~1] # 변경 영향만
```
### CI — 변경 영향만 build
```yaml
- name: Build affected
run: pnpm turbo run build --filter=...[origin/main]
```
### Remote cache — 팀 공유
```bash
turbo login
turbo link
# 이후 모든 빌드가 Vercel / 자체 cache 와 공유
```
### Versioning — Changesets
```bash
pnpm changeset # 변경 영향 + 노트 작성
pnpm changeset version # version bump
pnpm changeset publish # npm publish (필요시)
```
## 🤔 의사결정 기준
| 상황 | 도구 |
|---|---|
| Node.js 다수 패키지 | pnpm + Turborepo |
| 다언어 (Go + TS + Python) | Bazel / Nx |
| 작은 팀, 2-3 패키지 | pnpm workspaces 만, Turbo 없이 |
| Mobile + Web 공유 코드 | Yarn Berry + workspace 또는 pnpm |
| OSS 라이브러리 + example | Turborepo example template |
| 큰 팀 + 다양 언어 | Nx (graph 시각화 강함) |
## ❌ 안티패턴
- **`npm install` 모든 곳 별도**: deps 중복. workspace 사용.
- **버전 hoisting 가정**: pnpm 은 strict — peer dep 명시 필수.
- **package 간 circular dep**: 빌드 끝없이 회전. Turbo 가 fail.
- **task output 정의 안 함**: 캐시 안 됨. outputs 필드.
- **dev 와 build 캐시 같이**: dev 는 `"cache": false`.
- **monorepo + git submodule 혼용**: 복잡. 한 모델.
- **패키지 이름 namespace 없음**: 충돌. @scope/* 권장.
- **CI 가 항상 모든 패키지 build**: 시간 폭증. --filter 로 affected 만.
## 🤖 LLM 활용 힌트
- pnpm workspaces + Turborepo + Changesets 가 표준 스택.
- task 마다 inputs / outputs 정확히 → 캐시 효력.
## 🔗 관련 문서
- [[DevOps_Build_Performance]]
- [[Android_Modularization]]