refactor(topics): 멀티 에이전트용 지식 재편 — _Common(공통 기본기) + Domain_* 구조

에이전트 8종(대화형/프로그래머 C·S/디자이너/설계자/기획자/QA/PD/PM)에게
[공통 기본 능력 + 롤별 Specialty] 2층으로 지식을 주입하기 위한 재분류.
문서 내용·포맷은 무수정, 폴더 이동만 (6,372개 문서 수 보존 확인).

- Topic_Programming → Domain_Programming (내부 구조 보존)
- Topic_Graphic → Domain_Design
- Topic_Business → Domain_Product
- Topic_General → Domain_General
- _Common 신설: Math(구 Topic_Math_Specialty), Reasoning(구 General/From_Thinking & Reasoning),
  Reasoning_Creativity(구 General/From_창의성), Communication(Poetic_Blog_Writing + From_writing)
- 타 도메인의 From_* 폴더는 유지 (출처 표기일 뿐, 이미 도메인에 맞게 분류된 문서)
- 빈 폴더 정리 (memory/procedures)
- 에이전트→폴더 매핑은 workspace의 .astra/agent-knowledge-map.json (9개 에이전트)

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

10_Wiki/Topics/Domain_Programming/Programming & Language/Inventory Management Example.md

@@ -0,0 +1,152 @@
+---
+id: wiki-2026-0508-inventory-management-example
+title: Inventory Management Example
+category: 10_Wiki/Topics
+status: verified
+canonical_id: self
+aliases: [Inventory Domain Model, 재고 관리 예제]
+duplicate_of: none
+source_trust_level: B
+confidence_score: 0.85
+verification_status: applied
+tags: [example, domain-modeling, typescript, ddd]
+raw_sources: []
+last_reinforced: 2026-05-10
+github_commit: pending
+tech_stack:
+  language: TypeScript
+  framework: Zod
+---
+
+# Inventory Management Example
+
+## 매 한 줄
+> **"매 SKU · stock · reservation 의 type-safe domain model 의 walking example"**. 매 branded types · discriminated unions · runtime validation 매 결합 — 2026 modern TS pattern 의 canonical illustration.
+
+## 매 핵심
+
+### 매 도메인 entities
+- `SKU` (branded string)
+- `Stock` (positive int)
+- `Reservation` (id, sku, qty, expiresAt)
+- `InventoryEvent` (Tagged: Received | Reserved | Shipped | Cancelled)
+
+### 매 invariants
+- 매 stock ≥ 0 항상.
+- 매 reservation 의 release 후 stock 회복.
+- 매 ship 의 reservation 의 존재 시.
+
+### 매 응용
+1. E-commerce checkout flow (재고 차감 · 복구).
+2. Warehouse management (multi-location).
+3. Event-sourced inventory ledger.
+
+## 💻 패턴
+
+### Branded SKU
+```ts
+type SKU = string & { readonly __brand: "SKU" }
+
+const SkuSchema = z.string().regex(/^[A-Z]{3}-\d{6}$/).brand("SKU")
+const sku = SkuSchema.parse("ABC-123456") // SKU
+```
+
+### Stock value object
+```ts
+class Stock {
+  private constructor(public readonly value: number) {}
+  static of(n: number): Stock {
+    if (!Number.isInteger(n) || n < 0) throw new Error("invalid stock")
+    return new Stock(n)
+  }
+  reserve(qty: number): Stock { return Stock.of(this.value - qty) }
+  release(qty: number): Stock { return Stock.of(this.value + qty) }
+}
+```
+
+### Discriminated event union
+```ts
+type InventoryEvent =
+  | { type: "Received"; sku: SKU; qty: number; at: Date }
+  | { type: "Reserved"; sku: SKU; qty: number; reservationId: string }
+  | { type: "Shipped"; reservationId: string }
+  | { type: "Cancelled"; reservationId: string }
+
+function reduce(state: Map<SKU, Stock>, e: InventoryEvent): Map<SKU, Stock> {
+  switch (e.type) {
+    case "Received":
+      return new Map(state).set(e.sku, (state.get(e.sku) ?? Stock.of(0)).release(e.qty))
+    case "Reserved":
+      return new Map(state).set(e.sku, state.get(e.sku)!.reserve(e.qty))
+    case "Shipped":
+    case "Cancelled":
+      return state
+  }
+}
+```
+
+### Reservation lifecycle (Result type)
+```ts
+type Result<T, E> = { ok: true; value: T } | { ok: false; error: E }
+
+function reserve(stock: Stock, qty: number): Result<Stock, "INSUFFICIENT"> {
+  if (stock.value < qty) return { ok: false, error: "INSUFFICIENT" }
+  return { ok: true, value: stock.reserve(qty) }
+}
+```
+
+### Zod runtime parse (API boundary)
+```ts
+const ReserveCmd = z.object({
+  sku: SkuSchema,
+  qty: z.number().int().positive(),
+  customerId: z.string().uuid(),
+})
+
+app.post("/reserve", (req, res) => {
+  const cmd = ReserveCmd.safeParse(req.body)
+  if (!cmd.success) return res.status(400).json(cmd.error.flatten())
+  // ... cmd.data is fully typed
+})
+```
+
+### Exhaustive switch guard
+```ts
+function never(x: never): never { throw new Error(`unhandled: ${x}`) }
+// switch default → never(e) 매 새 event 추가 시 compile error
+```
+
+## 매 결정 기준
+| 상황 | Approach |
+|---|---|
+| Single-location inventory | In-memory `Map<SKU, Stock>` |
+| Multi-location | Add `LocationId` brand · partition state |
+| Audit-required | Event sourcing (full event log) |
+| High-concurrency | Optimistic concurrency token + retry |
+
+**기본값**: event-sourced reduce 매 audit + replay benefit. 매 단순 case도 future-proof.
+
+## 🔗 Graph
+- 부모: [[Domain-Driven Design]] · [[견고한 도메인 모델 및 API 계약 설계]]
+- 변형: [[Result Type]] · [[Discriminated_Unions|Discriminated Unions]]
+- 응용: [[Zod 파싱과 브랜디드 타입을 결합한 런타임 데이터 검증]]
+- Adjacent: [[브랜디드 타입 (Branded Types)]] · [[ts-brand]] · [[완전성 검사(Exhaustiveness Checking)]]
+
+## 🤖 LLM 활용
+**언제**: 매 type-safe domain modeling 의 teaching example 으로 reuse.
+**언제 X**: 매 production app 의 직접 copy — 매 oversimplified.
+
+## ❌ 안티패턴
+- **Plain `number` for stock**: 매 invariant 의 enforce 의 X — class · brand 의 사용.
+- **Stringly-typed events**: 매 discriminated union 의 사용.
+- **Skipping runtime parse at boundary**: 매 type erasure 후 — Zod / Effect Schema 의 필수.
+
+## 🧪 검증 / 중복
+- Verified (DDD blue book · Effect/Zod docs · TypeScript handbook 2026).
+- 신뢰도 B (illustrative example, not canonical implementation).
+
+## 🕓 Changelog
+| 날짜 | 변경 |
+|---|---|
+| 2026-05-08 | Phase 1 |
+| 2026-05-10 | Manual cleanup — full domain example with brands · DU · event sourcing |