HMP-01.research — GBrain 역할·Hermes 통합·운영 계약

TL;DR

• 방법: GitHub garrytan/gbrain 저장소를 이미 클론한 /tmp/gbrain-hmp01-source(v0.45.2.0, 2026-08-12 시점 1차 소스 스냅샷)에서만 조사했다. 네트워크 재클론/도구 실행/설치/Hermes 설정 변경 없음. 모든 주장은 로컬 파일 경로로 인용.
• 결론: GBrain은 Hermes의 memory.provider 내장 목록에 없는 독립 CLI/MCP 지식 브레인이다. Hermes 통합은 ① stdio MCP gbrain serve --surface verbs(다섯 동사) 또는 --surface full, ② skillpack 스캐폴딩(skills 디렉터리에 스킬 파일 복사, 컨텍스트 훅)으로 가능하고, memory provider plugin 경로는 공식적으로 없으며 turn capture 자동화도 기본 기능이 아니다. 시스템 오브 레코드는 마크다운 저장소이므로 복구·삭제·내보내기 계약이 명확하다. 한국어 키워드 FTS는 제약이 실재한다(PGLite는 CJK fallback 패치됨, Postgres는 미해결 TODO).

1. 역할(Role) — 무엇을 맡을 수 있나

• GBrain은 "Postgres-native personal knowledge brain with hybrid RAG search"로 자칭하며, PGLite(기본)·Postgres+pgvector(스케일) 플러그형 엔진, 26개 fat-markdown 스킬, 계약-우선 운영을 특징으로 한다 [Sources: llms.txt; package.json].
• Brain vs Source 이중 축: brain=데이터베이스(여러 개 가능), source=브레인 내부의 이름 붙은 콘텐츠 저장소(여러 개 가능). 슬러그는 소스별 고유이므로 source=wiki와 source=gstack에서 같은 슬러그가 별개 페이지가 된다. vault 위키와 코드 노트를 하나의 브레인에서 격리하는 용도에 정합 [Sources: docs/architecture/brains-and-sources.md].
• 하이브리드 RAG: 키워드(Postgres tsvector/tsquery) + 벡터(임베딩) 검색 암. 임베딩 제공자가 없으면 키워드 전용으로 자동 열화(search_degraded)하며 에러가 아니다 [Sources: docs/protocol/MEMORY_VERBS_v1.md; docs/guides/multi-language-fts.md].
• 존 슬롯: 단독 지식 브레인(Hindsight 유사)으로서의 역할이 Hindsight와 비교 가능한 후보가 되려면 메모리 동사 서피스가 핵심이며, role/roles를 하이브리드 검색·엔티티 카드·종합(합성)·망각 계약으로 구체화한다(아래 §4, §5).

2. Hermes 통합 경로

• 공식 문서가 Hermes를 지원 대상으로 명시: "Already running OpenClaw or Hermes?" → bun install -g github:garrytan/gbrain#latest-stable → gbrain init --pglite → gbrain skillpack scaffold --all → gbrain doctor [Sources: docs/INSTALL.md §1]. 주의: npm 레지스트리의 gbrain은 무관한 패키지 — github:garrytan/gbrain(또는 #latest-stable)만 지원 [Sources: INSTALL_FOR_AGENTS.md Step 1, npm-trap].
• 경로 A — stdio MCP (우선 경로): claude mcp add gbrain -- gbrain serve --surface verbs / codex mcp add gbrain -- ...; Hermes도 동일하게 stdio MCP 서브프로세스로 붙일 수 있다. --surface verbs면 다섯 동사만, 기본값 full이면 전체 툴 카탈로그 [Sources: docs/INSTALL.md §2; docs/protocol/MEMORY_VERBS_v1.md].
• 경로 B — skills/context 훅: skillpack 스캐폴딩으로 에이전트 워크스페이스에 스킬 파일을 복사하고, 에이전트는 skills/RESOLVER.md를 요청당 한 번 읽고 스킬로 라우팅한다. Hermes 메모리 제공자 플러그인으로 등록하는 경로는 문서에 없음(공식적으로 memory.provider 내장 목록 부재). MCP 연동을 쓰지 않는 대안으로 컨텍스트 주입(스킬/문서)은 가능하나 자동 prefetch는 아님 [Sources: docs/INSTALL.md §1; llms.txt skill resolver].
• 경로 C — 원격/HTTP MCP: gbrain serve --http(OAuth 2.1, admin SPA) + gbrain connect <url> --token ... --agent <harness>; model-context-protocol을 지원하는 모든 클라이언트에 원격 브레인 연결 [Sources: docs/INSTALL.md §3; docs/architecture/topologies.md Topology 2].
• 자동 prefetch/turn capture: 기본 제공되지 않는다. 대신 ① gbrain autopilot --install(야간 enrichment 백그라운드 데몬), ② gbrain sync --watch(60초 폴링 라이브 싱크), ③ push-context 문서(대화 창에서 confidence-gated 페이지 자원 봉사, ambient reflex/volunteer_context/watch 3채널)가 근접 기능이다. "turn capture"라 할 만한 세션 자동 기록은 없고, 회의 대본/대화 백필(conversation-backfill) 경로가 있다 [Sources: docs/INSTALL.md §2; docs/guides/live-sync.md; llms.txt push-context; docs/operations/]

3. five memory verbs surface vs full tool surface (보안·스키마 트레이드오프)

• MEMORY_VERBS v1 (동결 프로토콜): recall(읽기, 사실+하이브리드검색 양팔), remember(쓰기, provenance 필수), entity(읽기, 제로-LLM, p99<100ms), synthesize(읽기, 고비용/느림 — LLM 호출, gaps[]+cost 블록 반환), forget(쓰기, 사실 ID로, 감사 추적과 함께 만료 — 삭제 아님) [Sources: docs/protocol/MEMORY_VERBS_v1.md].
• 서피스 모드: --surface verbs는 광고된 툴 목록과 디스패치 모두 fail-closed로 필터(숨은 op는 이름으로 호출해도 unknown_tool). --surface full(기본)은 모든 op 공개. 기본값은 gbrain config set mcp_surface verbs로 영속화 가능. verdict: Hermes에 붙일 때는 verbs 서피스가 툴스키마 노출 면적을 5개로 줄여 보안·맥락 비용 측면에서 우위, 단 실험/운영 명령(sync, export 등)은 CLI에서 별도 실행 필요 [Sources: docs/protocol/MEMORY_VERBS_v1.md "Surface modes"].
• 신뢰 경계: 쿼리는 소스당 격리, 원격 호출자는 visibility=world 사실만 봄, remember/forget는 write-스코프 OAuth. 에러 계약은 {error, message, suggestion, detail, protocol_version} 통일 [Sources: docs/protocol/MEMORY_VERBS_v1.md "Trust boundary", "Error contract"].

4. 저장 단위 · provenance · 그래프 · 하이브리드 검색 · 종합 · 갭 분석 · forget/delete/export/backup

• 시스템 오브 레코드: GitHub 저장소(마크다운+fence/프론트매터)가 오브 레코드, DB(PGLite/Postgres)는 파생 캐시. DB는 백업하지 않고 저장소에서 재구축한다. 페이지 단위 pages, 청크 content_chunks, 사실 facts(fence 테이블 <!--- gbrain:facts:begin -->), takes, links, timeline, tags가 마크다운에서 파생 [Sources: docs/architecture/system-of-record.md].
• provenance: 모든 사실에 인라인 [Source: {who}, {channel/context}, {date} {time} {tz}] 인용 필수(컴파일드 트루스·타임라인 포함). 출처 충돌 시 둘 다 기록하고 단일 선택하지 않음. 우선순위: 사용자 직접 발언 > 1차 출처 > enrichment API > 웹검색 > 소셜 [Sources: docs/guides/source-attribution.md].
• 그래프: 엔티티 카드가 edges[](타이핑된 엣지 ~10개, 멘션 제외, out-edges 우선), backlink_count, alias>정확타이틀>슬러그 순 해석, miss 시 found:false+키워드 근접 제안 [Sources: docs/protocol/MEMORY_VERBS_v1.md entity()].
• 하이브리드 검색/예산: recall에 budget_tokens 전달 시 서버 측 압축(facts 우선, 검색 결과는 잔여 예산, budget_used/dropped_count 보고 — 클라이언트 조언 아님). 검색 모드(conservative/balanced/tokenmax)가 검색 페이로드 크기를 결정 [Sources: docs/protocol/MEMORY_VERBS_v1.md; INSTALL_FOR_AGENTS.md Step 3.5].
• 종합/갭 분석: synthesize가 다중 페이지 증거 결합 {answer, sources[], gaps[], cost{model, input_tokens, output_tokens, usd_estimate}} 반환. cost는 best-effort 집계(송장이 아닌 정직한 신호). LLM 미설정 시 unavailable 에러 [Sources: docs/protocol/MEMORY_VERBS_v1.md synthesize()].
• forget: 사실 ID로 만료. v0.32.2+는 fence 재작성(claim 취소선 + valid_until 오늘 + forgotten: <reason> 컨텍스트)이라 gbrain rebuild 후에도 만료 상태가 재현됨(없어지지 않음). 레거시 v51 이전 행은 DB 직접 만료로 폴백 — 이 경우 rebuild 후 forget이 되돌아감(명시적 예외) [Sources: src/core/facts/forget.ts].
• delete/export: 사실은 삭제가 아니라 만료(감사 추적). gbrain export --dir <out> [--type] [--slug-prefix] [--restore-only]로 페이지를 마크다운 직렬화 내보내기; --restore-only는 db_only 티어 복원 전용(저장소 구성 필수). gbrain reinit-pglite가 임베디드 DB 전체를 초기화 [Sources: src/commands/export.ts; docs/architecture/system-of-record.md].
• backup/재해복구: DB 백업 없음 — 마크다운만 있으면 gbrain sync && gbrain extract all로 전 DB 재구축. 멀티머신 동기화는 git [Sources: docs/architecture/system-of-record.md].
• 프라이버시 경계 3층: 청커에서 사실/takes fence 스트립(비공개 텍스트가 임베딩·검색에 안 닿음) + 원격 get_page 응답 스트립 + git 추적 결정은 사용자 몫(db_only 경로 자동 gitignore) [Sources: docs/architecture/system-of-record.md].

5. vault/llm-wiki를 소스로 — 중복 소유권, 링크 해석, 한국어 FTS 제약

• 소스로 쓰기: 임의 마크다운 폴더를 gbrain import ~/my-knowledge 또는 gbrain sources add+gbrain sync로 브레인 소스로 등록 가능; 라이브 싱크는 git diff 기반 증분 [Sources: docs/INSTALL.md §2; docs/guides/live-sync.md]. Obsidian vault는 일반 마크다운 소스로 정합하며, wikilink은 마크다운 인라인 링크 파서가 처리한다(소스-소스·페이지 슬러그 해석). vault의 기존 llm-wiki 상태와 gbrain 파생 상태가 같은 정보를 중복 보유하므로, 오브 레코드는 vault/git이며 gbrain DB는 파생 인덱스라는 계약을 지키면 중복 소유권 충돌이 구조적으로 사라진다 [Sources: docs/architecture/system-of-record.md].
• 한국어 FTS 제약(실재): 키워드 검색 암은 Postgres to_tsvector/tsquery 기반, 토크나이저 언어는 GBRAIN_FTS_LANGUAGE(기본 english, 브레인당 1개 언어). Postgres 기본 tsvector에는 한국어/CJK 토크나이저가 없어 멀티테넌트 Postgres에서 CJK 쿼리가 빈 결과 — TODO에 v0.42 항목으로 pgroonga/zhparser/ngram trigram 계획이 있고, v0.32.7에서 PGLite 한정 CJK 키워드 fallback(hasCJK+escapeLikePattern, src/core/cjk.ts)이 이미 착륙했다. 즉 한국어 콘텐츠는 ① PGLite 기본 엔진에선 키워드 검색이 동작하되 토큰화 품질은 snowball 수준, ② Postgres/Supabase 엔진은 확장(pgroonga 등) 설치 전까지 빈 결과 위험, ③ 벡터 검색 암은 언어 무관이라 임베딩 키면 커버된다 [Sources: docs/guides/multi-language-fts.md; TODOS.md 2312-2317, 2985-2995].
• 주의: FTS 언어 변경은 env var만으로 기존 행을 재토큰화하지 않음 — gbrain reindex-search-vector --yes 필요 [Sources: docs/guides/multi-language-fts.md].

6. 무-키 모드 vs 외부 전송·비용

• 무-키(no-embedding): gbrain init --no-embedding(키리스 부트스트랩)이면 어떤 비용 게이트도 발화할 수 없고 키워드 검색만 동작. recall은 search_degraded 표기. synthesize는 LLM 미설정 시 unavailable — 거짓 답변 없음 [Sources: docs/operations/spend-controls.md "Keyless mode"; MEMORY_VERBS_v1.md].
• 외부 전송 범위: 임베딩은 제공자 API로 외부 전송(기본 v0.36.2.0+ ZeroEntropy zembed-1 2560dim $0.05/1M; OpenAI 1536dim $0.13/1M; OpenRouter $0.02/1M 단일 키 다중 모델; 로컬 Ollama/llama-server는 무료·무전송), reranker(ZeroEntropy zerank-2 호스팅 기본), LLM(챗/검색 확장/엔티티 강화/synthesize)은 키 설정 시에만. Anthropic 키는 검색 품질(쿼리 확장) 선택 사항. 로컬 reranker(llama-server, $0/call)도 지원 [Sources: docs/integrations/embedding-providers.md; INSTALL_FOR_AGENTS.md Step 2; llms.txt].
• 비용 범위 (검색 모드 LLM): per-query LLM 검색 비용 매트릭스(10K 쿼리/월): conservative $40–200/월, balanced $100–500/월, tokenmax $200–1,000/월 (Haiku→Opus) — 25배 코너-코너 스프레드 [Sources: INSTALL_FOR_AGENTS.md Step 3.5 cost matrix].
• 임베딩 비용 게이트: spend.posture가 스위치(기본 gated, tokenmax는 게이트를 정보 제공으로). 게이트: sync.cost_gate_min_usd(기본 $0.50 — 비대화형에서 임베드 자동 지연), embed.backfill_max_usd_per_source_24h(기본 $25), embed.backfill_max_usd(기본 $10), per-call --max-usd. 0은 "off"가 아님(block-on-any) [Sources: docs/operations/spend-controls.md].
• 교훈 사건: 2026-05-20 LSD 비용 폭발($0.96 예상 vs $50.71 실측, 53×; 원인 far-set 1985페이지 폭주 + 회로 차단기 부재) — 이후 far-set 상한, --max-cost(기본 $5)/--strict-budget(5× 추정 시 중단)/--max-far-set(기본 50), judge 배치 청킹, 유니코드 정화 구현됨. 고비용 LLM 명령 사용 시 경계 필요성의 실례 [Sources: docs/incidents/2026-05-20-lsd-cost-explosion.md].

7. cron / dream cycle / continuous ingest — 선택사항인가

• 모두 선택사항이다. 기본 브레인은 설치만으로 동작하고, 크론/데몬이 없어도 검색·기록은 된다. 자동화 표면: ① gbrain dream(야간 유지보수 사이클 — lint, backlinks, extract, sync, embed, synthesize를 한 명령으로), ② gbrain jobs/minions(재시도·백오프·감사 추적 포함 작업 큐), ③ gbrain autopilot(자체 주기로 도는 장수명 데몬), ④ gbrain sync --watch(60초 폴링), ⑤ bootstrap의 HEARTBEAT.md 세션-트리거 스케줄, ⑥ cron-scheduler 스킬. 시스템 크론 예시는 30분 주기 이메일/X 수집, 주 3회 회의 싱크, 매일/주간 브리핑, 야간 드림 [Sources: docs/guides/cron-schedule.md; docs/INSTALL.md; docs/guides/live-sync.md].
• Hermes 실사용 판단: Hindsight 비교 목적이라면 핵심은 MCP verbs 서피스(선택)이고, vault 소스 동기화에는 gbrain sync(크론 또는 수동)가 필요하며, enrichment·드림 사이클은 품질 옵션으로 보고 비용 게이트와 함께만 켜는 게 안전하다.

8. 설치 제거 · 데이터 삭제 · 롤백 · 흔한 운영 실패

• 설치: Bun≥1.3.10 필요(Bun+TypeScript 런타임). bun install -g github:garrytan/gbrain#latest-stable → gbrain init --pglite(2초, 서버 불필요). npm 설치 금지. 키는 ~/.gbrain/config.json 또는 env [Sources: package.json; INSTALL_FOR_AGENTS.md; docs/INSTALL.md].
• 제거: gbrain bootstrap uninstall — 머신-로컬 설치 영수증(~/.gbrain/bootstrap/receipt.json)에 키된 제거로, receipt.created_paths만 정확히(경로 containment 검증) 제거. PGLite 데이터 dir 잠금이 살아있으면 거부("close your agent sessions first"). 브레인 삭제는 PGLite 데이터 dir + bootstrap/ + 영수증만 제거 — 글로벌 config.json, clones/ 등은 생존 [Sources: src/core/bootstrap/uninstall.ts; docs/guides/bootstrap.md 27,136].
• 데이터 삭제/롤백: 사실 forget은 fence 재작성(rebuild 후에도 유지). DB 전체 리셋은 gbrain reinit-pglite; 레거시 행 forget은 rebuild 후 되돌아감(예외). 마크다운 오브 레코드 덕에 "롤백=git revert + sync"가 공식 재해복구 절차 [Sources: src/core/facts/forget.ts; system-of-record.md].
• 흔한 운영 실패: ① bun install -g postinstall 훅 차단 → schema_version: 0, gbrain apply-migrations --yes 또는 git clone+bun link 폴백(#218) [INSTALL_FOR_AGENTS.md Step 1]; ② npm trap(npm install -g gbrain) — 무관 패키지 [INSTALL_FOR_AGENTS.md]; ③ 첫 import 치수 불일치(expected N dimensions, not M) — v0.37+ rm -rf ~/.gbrain 불필요, gbrain doctor 수리 경로 [embedding-providers.md]; ④ PGLite WASM 잠금 웨지 → reinit+재구축 [system-of-record.md]; ⑤ Supabase 직접 커넥션 IPv6-only 문제 → pooler 폴백/GBRAIN_DIRECT_DATABASE_URL [live-sync.md]; ⑥ 비용 폭발(§6 사건) [incidents/2026-05-20]; ⑦ FTS 언어 env 불일치 — 쓰는 모든 환경(CLI/MCP/cron)에서 동일 GBRAIN_FTS_LANGUAGE 유지 [multi-language-fts.md].
• 런타임 자원: PGLite는 임베디드 WASM Postgres(단일 프로세스, 단일-기록자 — 데이터 dir 잠금으로 보호). Postgres/Supabase 전환은 gbrain migrate --to supabase(1000+ 마크다운 파일 권장 기준) [Sources: docs/INSTALL.md §2; src/core/bootstrap/uninstall.ts; system-of-record.md].

비교에 넘기는 사실 (Hindsight 비교용)

1. 버전/라이선스/런타임: v0.45.2.0, MIT, Bun≥1.3.10 전용(TypeScript), npm 배포 아님(github:garrytan/gbrain만), trusted dep @electric-sql/pglite 0.4.3 [package.json; VERSION; INSTALL_FOR_AGENTS.md].
2. 엔진: PGLite(기본, 임베디드 WASM Postgres — 단일 프로세스/단일-기록자, 잠금 기반) / Postgres+pgvector(Supabase 등, 스케일) / thin-client(로컬 엔진 없이 원격 MCP) 3토폴로지 [topologies.md; uninstall.ts].
3. 시스템 오브 레코드 = 마크다운 저장소, DB = 파생 캐시 — 백업 없이 sync + extract all 재구축, 멀티머신 동기화는 git, 프라이버시는 fence 3-layer 스트립 [system-of-record.md].
4. 다섯 동사 프로토콜(MEMORY_VERBS v1, 동결): recall/remember/entity/synthesize/forget — --surface verbs fail-closed vs full; Hermes 표준 stdio MCP로 연결 [MEMORY_VERBS_v1.md; INSTALL.md].
5. 한국어 FTS 한계 실재: 기본 english 토크나이저, 브레인당 1언어; PGLite는 v0.32.7 CJK fallback 있음, Postgres는 pgroonga/ngram TODO(v0.42)로 미해결 — 한국어 키워드 검색 품질은 엔진 선택에 의존 [multi-language-fts.md; TODOS.md].
6. 비용 자세: 무-키 모드로 완전 로컬·무전송 시작 가능; 임베딩·reranker·LLM은 키 추가 시에만 외부 전송. spend.posture(기본 gated) + sync.cost_gate_min_usd $0.50 + backfill 상한($25/24h/소스, $10/잡) + per-call --max-usd가 게이트. 검색 모드 LLM 비용 $40–1,000/월(10K 쿼리, Haiku–Opus) [spend-controls.md; INSTALL_FOR_AGENTS.md].
7. 운영 최소면: cron/dream/autopilot 모두 선택사항; 최소 자동화는 gbrain sync(크론/--watch) + gbrain embed --stale. 제거는 gbrain bootstrap uninstall(영수증 키, 잠금 보호, config.json 생존) [cron-schedule.md; uninstall.ts].
8. Hermes 연동 제약: memory.provider 플러그인 미지원(공식 경로는 MCP+스킬 스캐폴딩), turn capture 없음(autopilot/push-context가 근접), 듀얼 오브 레코드(vault/git vs gbrain DB) 계약 준수 필요 [INSTALL.md; system-of-record.md].

Sources

모든 출처는 2026-08-12에 /tmp/gbrain-hmp01-source(클론 스냅샷, HEAD=v0.45.2.0)에서 로컬 열람. 원본 리포: https://github.com/garrytan/gbrain.

1. package.json / VERSION — 버전 0.45.2.0, MIT, engines.bun >=1.3.10, @electric-sql/pglite@0.4.3 trustedDependencies. (1차)
2. llms.txt / llms-full.txt — 리포 문서 맵·개요(브레인/GStack mod, 26 스킬). (1차)
3. docs/INSTALL.md — Hermes/OpenClaw 대상 설치, CLI/MCP 접속, 엔진 전환·migrate, 키 위치. (1차)
4. INSTALL_FOR_AGENTS.md — 에이전트용 9단계 설치, npm-trap, search-mode 비용 매트릭스. (1차)
5. docs/architecture/system-of-record.md — 마크다운 오브 레코드/DB 파생 캐시, 3층 프라이버시 스트립, DB-only 예외. (1차)
6. docs/architecture/brains-and-sources.md — brain/source 이중 축, 소스 분리 라우팅. (1차)
7. docs/architecture/topologies.md — 단일/원격 thin-client/분할 엔진 3토폴로지, OAuth HTTP MCP. (1차)
8. docs/protocol/MEMORY_VERBS_v1.md — 동결 5동사 프로토콜, surface 모드, 신뢰 경계, 에러 계약, conformance. (1차)
9. docs/guides/multi-language-fts.md — GBRAIN_FTS_LANGUAGE(기본 english), 브레인당 1언어, reindex-search-vector. (1차)
10. docs/guides/source-attribution.md — [Source: …] 인용 계약, 출처 우선순위, 충돌 처리. (1차)
11. docs/guides/cron-schedule.md — cron/드림/autopilot/jobs 스케줄 표와 선택성. (1차)
12. docs/guides/live-sync.md — sync + embed --stale 체인, --watch, Supabase 커넥션 함정. (1차)
13. docs/operations/spend-controls.md — spend.posture, 임베딩 비용 게이트 표, 무-키 모드. (1차)
14. docs/integrations/embedding-providers.md — 16개 제공자 표(치수·가격·로컬 여부), 치수 불일치 수리 경로. (1차)
15. docs/incidents/2026-05-20-lsd-cost-explosion.md — 53× 비용 폭발 사건과 후속 가드레일 구현. (1차)
16. src/commands/export.ts — gbrain export --dir/--restore-only 내보내기 계약. (1차)
17. src/core/facts/forget.ts — fence 재작성 forget(rebuild 생존) vs 레거시 DB만료 폴백. (1차)
18. src/core/bootstrap/uninstall.ts — 영수증 키 uninstall, 경로 containment, 잠금 프로브, config.json 생존. (1차)
19. docs/guides/bootstrap.md — 설치 영수증 위치, bootstrap uninstall 요약. (1차)
20. TODOS.md — v0.42 Postgres CJK FTS(pgroonga/zhparser/ngram) TODO, v0.32.7 PGLite CJK fallback 기록(src/core/cjk.ts). (1차)
21. README.md 개요 및 GitHub 리포 메타 — https://github.com/garrytan/gbrain (1차; llms.txt 경유). (2차 요약은 사용 안 함)

검증 한계 (evidence pending)

• gbrain CLI의 실제 실행 동작·벤치마크 수치는 설치/실행 금지 지침에 따라 미검증 — 위 인용은 모두 소스 코드/문서 계약이며 README 마케팅 수치는 제외함.
• Obsidian vault의 wikilink 해석 세부(슬러그 충돌 시 동작)는 문서로만 확인 — 실측은 설치 후 검증 항목.