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>
2026-07-11 11:05:56 +09:00
parent 6549ead309
commit c24165b8bc
6193 changed files with 1717 additions and 31 deletions
@@ -0,0 +1,148 @@
+---
+id: wiki-2026-0508-incremental-marking
+title: Incremental Marking
+category: 10_Wiki/Topics
+status: verified
+canonical_id: self
+aliases: [Incremental GC, Tri-color Marking]
+duplicate_of: none
+source_trust_level: A
+confidence_score: 0.9
+verification_status: applied
+tags: [architecture, gc, runtime, performance, memory]
+raw_sources: []
+last_reinforced: 2026-05-10
+github_commit: pending
+tech_stack:
+  language: cpp
+  framework: v8-go-jvm
+---
+
+# Incremental Marking
+
+## 매 한 줄
+> **"매 GC mark phase 의 small slice 의 mutator 의 interleave 의 통한 pause time 의 reduction"**. 매 Dijkstra 의 1978 tri-color abstraction 의 origin, 매 V8 (2011), Go (2015 concurrent), ZGC/Shenandoah (sub-millisecond) 의 modern 의 ubiquity — 매 stop-the-world 의 long pause 의 avoid.
+
+## 매 핵심
+
+### 매 Tri-Color Abstraction
+- **White**: 매 unvisited / unreachable candidate.
+- **Gray**: 매 visited 의 children 의 X.
+- **Black**: 매 fully scanned (children 의 gray/black).
+- **Invariant**: 매 black → white edge 의 X (strong invariant) 의 violation 의 fix → write barrier.
+
+### 매 Write Barrier 종류
+- **Dijkstra (insertion)**: black → white 의 store 의 시 white 의 gray 로 promote.
+- **Yuasa (deletion / SATB)**: gray pointer 의 overwrite 시 old target 의 gray 로 (snapshot-at-the-beginning).
+- **Hybrid**: Go 1.8+ 의 hybrid barrier (stack 의 black 의 가정).
+
+### 매 응용
+1. V8 (Chrome/Node) — incremental + concurrent + lazy sweep.
+2. Go — concurrent tri-color mark, sub-ms STW.
+3. JVM ZGC / Shenandoah — colored pointers / load barriers.
+
+## 💻 패턴
+
+### Dijkstra Write Barrier (Pseudo-C)
+```c
+void write_barrier(Object** slot, Object* new_val) {
+  if (gc_phase == MARKING && new_val != NULL && new_val->color == WHITE) {
+    new_val->color = GRAY;
+    mark_stack_push(new_val);
+  }
+  *slot = new_val;
+}
+```
+
+### Tri-Color Marking Loop
+```cpp
+void incremental_mark_step(size_t budget_bytes) {
+  size_t scanned = 0;
+  while (scanned < budget_bytes && !mark_stack.empty()) {
+    Object* obj = mark_stack.pop();   // gray
+    for (Object* child : obj->refs()) {
+      if (child->color == WHITE) {
+        child->color = GRAY;
+        mark_stack.push(child);
+      }
+    }
+    obj->color = BLACK;
+    scanned += obj->size();
+  }
+}
+```
+
+### V8-Style Step Scheduling
+```cpp
+// Allocation 의 통한 mark step 의 trigger
+void* allocate(size_t n) {
+  void* p = bump_alloc(n);
+  marking_progress_ += n;
+  if (marking_progress_ >= step_threshold_) {
+    incremental_mark_step(/*budget=*/n * 2);  // pay-as-you-go
+    marking_progress_ = 0;
+  }
+  return p;
+}
+```
+
+### Go-Style SATB-ish Hybrid Barrier
+```go
+// runtime/mbarrier.go (simplified)
+//go:nowritebarrierrec
+func gcWriteBarrier(slot *unsafe.Pointer, ptr unsafe.Pointer) {
+    if writeBarrier.enabled {
+        // Shade ptr (Dijkstra) AND shade *slot (Yuasa)
+        shade(ptr)
+        shade(*slot)
+    }
+    *slot = ptr
+}
+```
+
+### Concurrent Mark Termination
+```cpp
+void mark_termination() {
+  stop_the_world();              // brief STW
+  drain_remaining_mark_stack();  // flush per-thread buffers
+  weak_ref_processing();
+  start_concurrent_sweep();
+  resume_world();
+}
+```
+
+## 매 결정 기준
+| 상황 | Approach |
+|---|---|
+| Latency-critical (game, trading) | ZGC / Shenandoah (sub-ms) |
+| Throughput-critical (batch) | Parallel STW collector |
+| Mid-size heap, mixed | G1, V8 incremental |
+| Tiny heap (embedded) | Reference counting / simple mark-sweep |
+
+**기본값**: 매 modern runtime 의 기본 (V8, Go, JVM G1) — explicit tuning 없이 incremental marking 의 enabled.
+
+## 🔗 Graph
+- 부모: [[Garbage Collection]] · [[Memory Management]]
+- 변형: [[Concurrent-Marking]]
+- 응용: [[V8]]
+- Adjacent: [[Write Barrier]] · [[Reference-Counting]]
+
+## 🤖 LLM 활용
+**언제**: GC pause 의 root cause 의 analysis, write barrier 의 correctness 의 reasoning, GC log 의 parse.
+**언제 X**: production GC tuning 의 final decision (workload-specific benchmark 필수).
+
+## ❌ 안티패턴
+- **Missing write barrier**: black → white 의 invariant 의 violation 의 → premature reclamation 의 use-after-free.
+- **Unbounded step**: incremental step 의 budget 의 X → STW-equivalent pause.
+- **Floating garbage 의 ignore**: SATB 의 dead 가 mark, 매 cycle 의 retain — frequent collection 의 통한 mitigation.
+- **Allocator 의 black allocation 의 fail**: marking 중 allocate 의 white → 매 next cycle 까지 reachable 의 보장 의 X.
+
+## 🧪 검증 / 중복
+- Verified (Dijkstra "On-the-fly Garbage Collection" 1978, V8 blog, Go GC design doc, Hudson "A Unified Theory of GC").
+- 신뢰도 A.
+
+## 🕓 Changelog
+| 날짜 | 변경 |
+|---|---|
+| 2026-05-08 | Phase 1 |
+| 2026-05-10 | Manual cleanup — incremental GC marking 의 full content |