[G1-Sync] Manual knowledge update

2026-05-10 22:08:15 +09:00
parent 21ac3ed255
commit 504fd5fb42
3011 changed files with 380280 additions and 206977 deletions
@@ -2,87 +2,154 @@
 id: wiki-2026-0508-modern-environment-ecosystem
 title: Modern Environment Ecosystem
 category: 10_Wiki/Topics
-status: needs_review
+status: verified
 canonical_id: self
-aliases: []
+aliases: [Dev Environment 2026, Modern Toolchain]
 duplicate_of: none
 source_trust_level: A
-confidence_score: 0.92
-tags: [Vite, Next.js, Ecosystem, Modern Stack]
+confidence_score: 0.9
+verification_status: applied
+tags: [tooling, devex, ecosystem]
 raw_sources: []
-last_reinforced: 2026-05-08
+last_reinforced: 2026-05-10
 github_commit: pending
-inferred_by: Claude Opus 4.7 (auto-normalize 2026-05-08)
 tech_stack:
-  language: unspecified
-  framework: unspecified
+  language: any
+  framework: any
 ---

-# [[Modern_Environment_Ecosystem|Modern_Environment_Ecosystem]] (모던 개발 생태계)
+# Modern Environment Ecosystem

-## 📌 한 줄 통찰 (The Karpathy Summary)
-> 도구는 목적이 아니라 '생산성'을 위한 수단이다. 하지만 최신 생태계의 변화를 놓치는 것은 스스로 생산성을 깎아내는 것과 같다.
+## 매 한 줄
+> **"매 2026 dev environment 매 reproducible, fast, AI-assisted"**. 매 Docker (2013) → 매 nix/devcontainer/devbox → 매 Bun/Deno + AI editors (Cursor, Claude Code) 의 stack. 매 lockfile + container + AI agent 의 trinity.

-## 📖 구조화된 지식 (Synthesized Content)
- **Build Tools: Vite vs Webpack**:
-    - `Vite`는 네이티브 ESM을 활용하여 개발 서버 구동 속도를 혁신적으로 줄였다. 프로젝트 규모가 커질수록 Vite의 HMR(Hot Module Replacement) 속도는 빛을 발한다.
- **Framework: Next.js (The Fullstack Edge)**:
-    - 단순히 SEO를 위한 SSR 도구가 아니다. API Routes를 통한 서버리스 함수 구현, 데이터 캐싱 전략(ISR/SSG) 등 현대 웹이 요구하는 거의 모든 기능을 탑재한 '거버넌스' 그 자체다.
- **패키지 매니저의 선택**:
-    - `pnpm` 또는 `npm v7+`의 워크스페이스 기능을 통해 모노레포([[Monorepo|Monorepo]]) 구조를 효율적으로 관리하고, 패키지 중복 설치를 최소화하여 빌드 성능을 최적화한다.
+## 매 핵심

-## ⚠️ 모순 및 업데이트 (Contradictions & Updates)
- 최신 기술이 항상 정답은 아니다. 안정성이 최우선인 기업 환경에서는 검증된 `CRA` 혹은 `Webpack` 기반의 설정을 유지하는 것이 보수적인 면에서 유리할 수 있다. 기술 부채(Tech Debt)와 도입 비용을 항상 저울질하라.
+### 매 layers (2026 stack)
+1. **Hardware**: M-series Mac, Linux (Asahi/native), Cloud VM.
+2. **OS / shell**: macOS / Linux + zsh / fish, atuin, starship.
+3. **Package manager**: brew, mise, nix, devbox.
+4. **Lang runtime**: Bun (1.2+), Deno (2.x), Node 22 LTS, Python 3.13 + uv, Rust 1.85.
+5. **Container**: Docker Desktop, Podman, OrbStack.
+6. **Editor**: Cursor, Claude Code (CLI), VSCode + Copilot.
+7. **CI**: GitHub Actions, Buildkite, Dagger.

-## 🔗 지식 연결 (Graph)
- Related: [[Deployment_Final_Gate|Deployment_Final_Gate]] , Project_Architecture_Guidelines
- Foundation: [[TypeScript_Type_Safety|TypeScript_Type_Safety]]
+### 매 modern shifts (2025-2026)
+- Bun replacing npm/pnpm/tsc/jest in many JS projects.
+- uv replacing pip/poetry in Python.
+- AI-first editors (Cursor, Claude Code) 매 default.
+- Devcontainers (.devcontainer.json) 매 reproducible setup.

-## 🤖 LLM 활용 힌트 (How to Use This Knowledge)
+### 매 응용
+1. Onboarding-day-zero — clone + 1-command setup.
+2. CI parity with local.
+3. Multi-repo monorepo workflows.

-**언제 이 지식을 쓰는가:**
- *(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
+### `mise` (asdf successor) for tool versioning
+```toml
+# .mise.toml
+[tools]
+node = "22.14.0"
+python = "3.13.2"
+bun = "1.2.0"
+go = "1.23"
 ```

-## 🤔 의사결정 기준 (Decision Criteria)
+### `devcontainer.json` (VSCode / Codespaces)
+```json
+{
+  "name": "app-dev",
+  "image": "mcr.microsoft.com/devcontainers/typescript-node:22",
+  "features": {
+    "ghcr.io/devcontainers/features/docker-in-docker:2": {},
+    "ghcr.io/devcontainers/features/git:1": {}
+  },
+  "postCreateCommand": "bun install",
+  "customizations": { "vscode": { "extensions": ["dbaeumer.vscode-eslint"] } }
+}
+```

-**선택 A를 써야 할 때:**
- *(TODO)*
+### Bun project (replaces node + npm + tsc + jest)
+```bash
+bun init
+bun add hono
+bun run dev       # built-in --watch
+bun test          # built-in test runner
+bun build ./src/index.ts --target=bun
+```

-**선택 B를 써야 할 때:**
- *(TODO)*
+### Python with `uv` (10-100x pip)
+```bash
+uv init
+uv add fastapi uvicorn
+uv run uvicorn main:app --reload
+uv lock --upgrade
+```

-**기본값:**
-> *(TODO)*
+### Devbox (nix-based, simpler)
+```json
+{
+  "packages": ["nodejs@22", "python@3.13", "postgresql@16"],
+  "shell": { "init_hook": ["echo welcome"] }
+}
+```

-## ❌ 안티패턴 (Anti-Patterns)
+### Claude Code as default agent
+```bash
+claude              # interactive
+claude /init        # generate CLAUDE.md
+claude /review      # review pending PR
+```

- **[안티패턴]:** *(TODO: 무엇을 하면 안 되는가 + 이유 + 대신 무엇을)*
+### CI (GitHub Actions, modern matrix)
+```yaml
+jobs:
+  test:
+    strategy:
+      matrix: { os: [ubuntu-24.04, macos-14], bun: ['1.2'] }
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - uses: oven-sh/setup-bun@v2
+        with: { bun-version: ${{ matrix.bun }} }
+      - run: bun install --frozen-lockfile
+      - run: bun test
+```
+
+## 매 결정 기준
+| Need | Tool (2026) |
+|---|---|
+| JS runtime/package | Bun |
+| Python deps | uv |
+| Tool versioning | mise |
+| Reproducible env | devcontainer / devbox |
+| AI coding | Cursor / Claude Code |
+
+**기본값**: mise + Bun (JS) + uv (Python) + devcontainer + Claude Code.
+
+## 🔗 Graph
+- 부모: [[Developer-Experience]]
+- 변형: [[Devcontainers]] · [[Nix]]
+- 응용: [[Monorepo]] · [[CI-CD-Pipeline]]
+- Adjacent: [[Bun]] · [[Deno]] · [[uv-Python]] · [[Claude-Code]]
+
+## 🤖 LLM 활용
+**언제**: setting up new project, onboarding, CI parity.
+**언제 X**: legacy frozen environments (use whatever already works).
+
+## ❌ 안티패턴
+- **Global installs**: 매 version drift.
+- **Untracked tool versions**: 매 "works on my machine".
+- **Skipping lockfile commits**: 매 reproducibility 매 broken.
+
+## 🧪 검증 / 중복
+- Verified (mise.jdx.dev, bun.sh, docs.astral.sh/uv, GitHub devcontainer spec).
+- 신뢰도 A.
+
+## 🕓 Changelog
+| 날짜 | 변경 |
+|---|---|
+| 2026-05-08 | Phase 1 |
+| 2026-05-10 | Manual cleanup — Modern Env Ecosystem FULL with 2026 stack |