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>
This commit is contained in:
Antigravity Agent
2026-07-11 11:05:56 +09:00
parent 6549ead309
commit c24165b8bc
6193 changed files with 1717 additions and 31 deletions
@@ -0,0 +1,112 @@
---
id: rn-hermes-optimization
title: RN Hermes — Startup / Memory 최적화
category: Coding
status: draft
source_trust_level: B
verification_status: conceptual
created_at: 2026-05-09
updated_at: 2026-05-09
tags: [react-native, hermes, performance, vibe-coding]
tech_stack: { language: "Hermes / RN 0.70+", applicable_to: ["React Native"] }
applied_in: []
aliases: [bytecode, AOT, source map, sampling profiler]
---
# RN Hermes 최적화
> Hermes = RN 의 JS engine (JSC 대체). **Bytecode precompile + small heap = 빠른 startup**. 0.70+ default. profiler 사용 + 큰 deps 분할 + Hermes-friendly JS 작성이 핵심.
## 📖 핵심 개념
- Bytecode (.hbc): build 시 미리 컴파일. 사용자 디바이스 parse 시간 0.
- Sampling profiler: 무거운 함수 식별.
- Source map: minified stack → 원본.
## 💻 코드 패턴
### Hermes 활성화 (보통 디폴트)
```js
// android/app/build.gradle (디폴트 enabled)
project.ext.react = [ enableHermes: true ]
// iOS Podfile
use_react_native!(:path => config[:reactNativePath], :hermes_enabled => true)
```
### Sampling profiler
```ts
import { Hermes } from 'react-native-hermes';
// dev menu → "Hermes: Enable Sampling Profiler" → 작업 → "Disable" → .cpuprofile 다운로드
// Chrome devtools 또는 React Native debugger 에서 분석
```
### Source map upload (Sentry)
```bash
sentry-cli react-native gradle \
--build-script android/app/build.gradle \
--release "myapp@1.0.0+1"
```
### Build-time bytecode precompile
RN 0.70+ Hermes 가 release build 에서 자동 .hbc 생성.
### 무거운 lib 회피
```ts
// ❌ moment.js (수백 KB, locale)
import moment from 'moment';
// ✅ date-fns (tree-shake 가능, 작은 import)
import { format } from 'date-fns';
// ✅ 또는 native Intl
new Intl.DateTimeFormat('ko-KR').format(date);
```
### Splash screen 동안 critical asset 만 로드
```ts
import * as SplashScreen from 'expo-splash-screen';
SplashScreen.preventAutoHideAsync();
useEffect(() => {
(async () => {
await Promise.all([loadFonts(), loadAuthState()]);
await SplashScreen.hideAsync();
})();
}, []);
```
### InteractionManager — 무거운 작업 지연
```ts
useEffect(() => {
const handle = InteractionManager.runAfterInteractions(() => {
// 애니메이션 끝난 후 실행
heavyWork();
});
return () => handle.cancel();
}, []);
```
## 🤔 의사결정 기준
| 측정 | 도구 |
|---|---|
| Startup time | Flipper Hermes profiler |
| JS frame drop | Flipper Performance Monitor |
| Memory leak | Xcode Instruments (iOS), Profiler (Android Studio) |
| Bundle size | source-map-explorer (release bundle) |
| Native UI thread | Systrace / Perfetto |
## ❌ 안티패턴
- **moment.js / lodash 통째 import**: 번들 폭증. tree-shake / 대체.
- **JIT 가정 (eval, new Function)**: Hermes 는 JIT 없음 — 런타임 컴파일 X. 디자인 회피.
- **production 에 console.log 남김**: bridge 부하. babel plugin 으로 제거.
- **번들 분석 없이 추측**: source-map-explorer.
- **Hermes off + 옛 JSC 유지**: startup 느림. 마이그레이션 가능한 한.
- **`require` 동적 호출 무절제**: dead code elim 깨짐.
## 🤖 LLM 활용 힌트
- "Hermes 가정. moment 대신 date-fns 또는 Intl. console.log production 제거."
- profiler 측정 후 최적화.
## 🔗 관련 문서
- [[React_Native_Bridge_Performance]]
- [[DevOps_Build_Performance]]