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>
5.6 KiB
5.6 KiB
id, title, category, status, canonical_id, aliases, duplicate_of, source_trust_level, confidence_score, verification_status, tags, raw_sources, last_reinforced, github_commit, tech_stack
| id | title | category | status | canonical_id | aliases | duplicate_of | source_trust_level | confidence_score | verification_status | tags | raw_sources | last_reinforced | github_commit | tech_stack | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| wiki-2026-0508-v8-engine | V8 Engine | 10_Wiki/Topics | verified | self |
|
none | A | 0.95 | applied |
|
2026-05-10 | pending |
|
V8 Engine
매 한 줄
"매 multi-tier JIT + generational GC 의 JavaScript runtime". 매 Google (2008) 의 Chrome 용 의 open-source 의 release 의 Node.js + Electron + Deno 의 ecosystem 의 substrate. 매 2026 년 의 V8 13.x 의 Maglev (mid-tier) + Turboshaft (top-tier) + sandbox + pointer-compression 의 modern stack.
매 핵심
매 execution pipeline (4-tier)
- Ignition — bytecode interpreter. 매 startup fast.
- Sparkplug — non-optimizing baseline JIT. 매 cheap compile.
- Maglev — mid-tier optimizing JIT (V8 11.7+). 매 quick optimize.
- TurboFan / Turboshaft — top-tier optimizing JIT. 매 peak perf.
매 memory subsystem
- Pointer compression cage (4GB).
- Generational GC — Scavenger (young) + Mark-Compact (old).
- Concurrent + incremental marking.
- Heap spaces: New, Old, Large object, Code, Map, etc.
매 응용
- Browser JS (Chrome, Edge, Brave, Opera).
- Server runtime (Node.js).
- Desktop (Electron).
- Edge / serverless (Cloudflare Workers, Vercel Edge — actually V8 isolates).
- Embedded scripting (CouchDB, MongoDB shell).
💻 패턴
Embed V8 in C++ (minimal hello)
#include <v8.h>
#include <libplatform/libplatform.h>
int main(int argc, char* argv[]) {
v8::V8::InitializeICUDefaultLocation(argv[0]);
auto platform = v8::platform::NewDefaultPlatform();
v8::V8::InitializePlatform(platform.get());
v8::V8::Initialize();
v8::Isolate::CreateParams params;
params.array_buffer_allocator =
v8::ArrayBuffer::Allocator::NewDefaultAllocator();
v8::Isolate* isolate = v8::Isolate::New(params);
{
v8::Isolate::Scope iscope(isolate);
v8::HandleScope hscope(isolate);
auto ctx = v8::Context::New(isolate);
v8::Context::Scope cscope(ctx);
auto src = v8::String::NewFromUtf8Literal(isolate, "1 + 2");
auto script = v8::Script::Compile(ctx, src).ToLocalChecked();
auto result = script->Run(ctx).ToLocalChecked();
v8::String::Utf8Value utf8(isolate, result);
printf("%s\n", *utf8);
}
isolate->Dispose();
v8::V8::Dispose();
return 0;
}
Inspect tier transitions (Node.js)
node --trace-opt --trace-deopt app.js
# Watch which functions get Turboshaft-optimized vs deoptimize
Hidden class / inline cache friendly
// GOOD — same shape every time → same hidden class → IC monomorphic
function Point(x, y) { this.x = x; this.y = y; }
const points = [new Point(1,2), new Point(3,4)];
// BAD — shape changes → IC megamorphic → slow
const p1 = {x:1, y:2};
const p2 = {x:1, y:2, z:3}; // different shape
Snapshot for fast startup
// Build a snapshot blob with pre-loaded JS, then restore it
v8::SnapshotCreator creator;
{
auto isolate = creator.GetIsolate();
v8::HandleScope hscope(isolate);
auto ctx = v8::Context::New(isolate);
v8::Context::Scope scope(ctx);
// run init JS...
creator.SetDefaultContext(ctx);
}
auto blob = creator.CreateBlob(v8::SnapshotCreator::FunctionCodeHandling::kClear);
// Save blob.data, load with v8::Isolate::CreateParams::snapshot_blob
Isolate-per-request (Cloudflare Workers model)
// Conceptual — V8 isolates as multi-tenant unit
class WorkerRunner {
async run(script, request) {
const isolate = new V8Isolate({ memoryLimit: 128_000_000 });
const ctx = isolate.createContext();
ctx.global.fetch = fetch;
try {
return await ctx.eval(script).fetch(request);
} finally {
isolate.dispose();
}
}
}
Force GC + heap snapshot
node --expose-gc --inspect app.js
# In code: global.gc(); v8.writeHeapSnapshot('s.heapsnapshot');
Tune for memory-constrained env
node --max-old-space-size=512 \
--max-semi-space-size=64 \
--optimize-for-size \
app.js
매 결정 기준
| 상황 | Tier / Setting |
|---|---|
| Cold start critical | Snapshot + Sparkplug |
| Steady-state CPU-bound | Let TurboFan/Turboshaft warm up |
| Memory-constrained | --optimize-for-size + lower max-old-space |
| Multi-tenant edge | One isolate per request |
| Native interop heavy | NAPI / N-API (stable ABI) |
기본값: 매 default flags 의 modern Node 의 OK; 매 measure 후 tune.
🔗 Graph
- 부모: JavaScript · JIT Compilation
- 변형: JavaScriptCore
- 응용: Nodejs · Electron · Deno · Cloudflare Workers
- Adjacent: Garbage Collection · Chrome V8 Heap Analysis · Electron V8 Memory Cage
🤖 LLM 활용
언제: 매 perf debugging 의 deopt 의 reading. 매 hidden class 의 explanation. 매 flag selection. 언제 X: 매 V8 internal API 의 frequent change. 매 LLM 의 outdated 의 risk → release notes 의 verify.
❌ 안티패턴
- Polymorphic shapes: 매 IC megamorphic 의 cause. 매 hidden class consistent 의 keep.
- Try/catch in hot loop (pre-V8 6): 매 modern V8 의 OK 지만 의 still 의 cost.
deleteon hot object: 매 hidden class transition 의 trigger.- Naive
eval: 매 deopt + security risk.
🧪 검증 / 중복
- Verified (V8 official docs, V8 blog 2026, Node.js v22+ docs).
- 신뢰도 A.
🕓 Changelog
| 날짜 | 변경 |
|---|---|
| 2026-05-08 | Phase 1 |
| 2026-05-10 | Manual cleanup — 4-tier pipeline + 2026 modern stack (Maglev, Turboshaft) |