c24165b8bc
에이전트 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>
2.6 KiB
2.6 KiB
id, title, category, status, source_trust_level, verification_status, created_at, updated_at, tags, tech_stack, applied_in, aliases
| id | title | category | status | source_trust_level | verification_status | created_at | updated_at | tags | tech_stack | applied_in | aliases | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| react-usecallback-reality | useCallback 의 현실 (대부분 불필요) | Coding | draft | B | conceptual | 2026-05-09 | 2026-05-09 |
|
|
|
useCallback 의 현실
useCallback 은 useMemo 의 함수 버전. 자식이 React.memo 거나 deps 에 함수가 들어가는 경우에만 의미 있음. 그 외엔 "옵티마이저처럼 보이는 코드 노이즈".
📖 핵심 개념
- 함수는 매 렌더마다 새 참조 생성 (JS object).
- React.memo 자식은 props 참조 비교 → 새 함수 prop = 매번 재렌더.
- useCallback 으로 안정화 → React.memo 효력 발휘.
useCallback 자체는 컴포넌트 렌더링을 최적화 안 한다. React.memo / useMemo / useEffect 의 deps 로 쓰일 때만 가치.
💻 코드 패턴
// ✅ 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 붙이면 제거 요청.