Pillar I · 카테고리 1 · 인덱싱 시스템

Hierarchical Knowledge Graph

마크다운 파일이 서로를 가리키며 탐색 가능한 graph를 형성한다 — agent는 검색 엔진이 인덱스를 타듯 트리를 효율적으로 탐색

1단계 · 진입

진입점 (Root)

agent가 가장 먼저 읽는 파일. 어디로 가야 할지 알려준다.

CLAUDE.md

→

2단계 · 1차 참조

@ 참조로 분기

진입점이 도메인별 문서로 가리킨다 — architecture, payments 등.

@docs/architecture.md
@docs/payments.md

→

3단계 · 2차 분기

결정 이력으로 심화

각 문서가 다시 ADR · 세부 결정으로 분기. 필요한 깊이까지만.

@decisions/
001-mysql.md
002-event-sourcing.md

⚡ 원칙

agent가 "navigate the knowledge graph effectively" — 매번 같은 진입점에서 같은 트리를 타고 같은 결정에 도달

✓ 결과

답이 결정론적으로 수렴 — variance가 줄어드는 게 측정 가능