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/Coding/React_useCallback_Reality.md

@@ -0,0 +1,66 @@
+---
+id: react-usecallback-reality
+title: useCallback 의 현실 (대부분 불필요)
+category: Coding
+status: draft
+source_trust_level: B
+verification_status: conceptual
+created_at: 2026-05-09
+updated_at: 2026-05-09
+tags: [react, hooks, useCallback, performance, vibe-coding]
+tech_stack: { language: "TypeScript / React 18+", applicable_to: ["Web", "React Native"] }
+applied_in: []
+aliases: [callback memoization, function reference]
+---
+
+# useCallback 의 현실
+
+> useCallback 은 useMemo 의 함수 버전. 자식이 React.memo 거나 deps 에 함수가 들어가는 경우에만 의미 있음. 그 외엔 "옵티마이저처럼 보이는 코드 노이즈".
+
+## 📖 핵심 개념
+- 함수는 매 렌더마다 새 참조 생성 (JS object).
+- React.memo 자식은 props 참조 비교 → 새 함수 prop = 매번 재렌더.
+- useCallback 으로 안정화 → React.memo 효력 발휘.
+
+useCallback 자체는 **컴포넌트 렌더링을 최적화 안 한다**. React.memo / useMemo / useEffect 의 deps 로 쓰일 때만 가치.
+
+## 💻 코드 패턴
+
+```ts
+// ✅ React.memo 자식 + 함수 prop
+const Child = memo(({ onSelect }: { onSelect: (id: string) => void }) => { ... });
+
+function Parent() {
+  const onSelect = useCallback((id: string) => { ... }, []); // deps 변하지 않으면 안정
+  return <Child onSelect={onSelect} />;
+}
+
+// ❌ memoized 안 된 자식 → 효력 없음 (어차피 매 렌더 새 인스턴스)
+function Parent() {
+  const onClick = useCallback(() => {}, []);
+  return <button onClick={onClick}>X</button>; // 의미 없음
+}
+```
+
+## 🤔 의사결정 기준
+| 자식 / 사용처 | useCallback 필요 |
+|---|---|
+| React.memo 컴포넌트의 함수 prop | ✅ |
+| useEffect / useMemo 의 deps 에 함수 | ✅ |
+| 일반 DOM 핸들러 (onClick, onChange) | ❌ |
+| 한 번 이벤트 등록 후 떼는 핸들러 | useEvent 패턴 또는 ref 보관 |
+
+## ❌ 안티패턴
+- **모든 함수에 useCallback**: 대부분 무의미. 코드 노이즈.
+- **React.memo 없는 자식 + useCallback**: 효력 0.
+- **deps 자주 바뀜**: useCallback 가 매번 새 함수 → 안정화 효과 0.
+- **stale closure**: 함수가 state/props 캡처. deps 누락하면 옛 값 참조. exhaustive-deps lint 사용.
+- **이벤트 핸들러 패턴 대신 useEvent 미사용**: React 19 useEvent (실험적) 가 stale closure 문제 해결.
+
+## 🤖 LLM 활용 힌트
+- "useCallback 은 React.memo 자식이거나 deps 인 경우에만" 강조.
+- LLM이 일반 onClick 에 useCallback 붙이면 제거 요청.
+
+## 🔗 관련 문서
+- [[React_useMemo_When_Not_To]]
+- [[React_Rendering_Optimization]]