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>
3.3 KiB
3.3 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 | |||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| rn-hermes-optimization | RN Hermes — Startup / Memory 최적화 | Coding | draft | B | conceptual | 2026-05-09 | 2026-05-09 |
|
|
|
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 활성화 (보통 디폴트)
// android/app/build.gradle (디폴트 enabled)
project.ext.react = [ enableHermes: true ]
// iOS Podfile
use_react_native!(:path => config[:reactNativePath], :hermes_enabled => true)
Sampling profiler
import { Hermes } from 'react-native-hermes';
// dev menu → "Hermes: Enable Sampling Profiler" → 작업 → "Disable" → .cpuprofile 다운로드
// Chrome devtools 또는 React Native debugger 에서 분석
Source map upload (Sentry)
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 회피
// ❌ 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 만 로드
import * as SplashScreen from 'expo-splash-screen';
SplashScreen.preventAutoHideAsync();
useEffect(() => {
(async () => {
await Promise.all([loadFonts(), loadAuthState()]);
await SplashScreen.hideAsync();
})();
}, []);
InteractionManager — 무거운 작업 지연
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 측정 후 최적화.