정의
코딩 에이전트를 위한 관계 인덱스로서의 온톨로지는 파일, 모듈, 서비스, API, 제약 조건을 단순 문서 목록으로 저장하는 대신 calls, depends-on, part-of, is-a 같은 타입이 있는 관계 그래프로 표현하는 방식이다. 목적은 Claude Code 같은 에이전트가 매번 전체 문서를 다시 읽고 관계를 추론하지 않게 하고, 이미 명시된 관계선을 따라 필요한 맥락만 가져오게 하는 것이다.
핵심 속성
- 문제 인식:
CLAUDE.md,@file, Markdown 목록은 지식의 위치와 이름은 알려주지만, 개념 사이의 관계를 충분히 표현하지 못한다. - 핵심 단위: 클래스, 인스턴스, 속성, 관계, 제약 조건.
- 관계 타입:
is-a,part-of,calls,depends-on처럼 연결의 의미를 타입으로 고정한다. - 효과: 관련 없는 파일을 덜 읽게 하여 토큰을 줄이고, 관계 추론을 모델의 즉흥 판단이 아니라 데이터 추적으로 바꾼다.
- RAG와의 차이: RAG는 의미적으로 가까운 문서를 찾고, 온톨로지는 노드 사이의 명시적 관계를 따라간다.
관계
- 20260609-codegraph-local-knowledge-graph — 연장: 코드 그래프 MCP와 같은 도구가 실용적으로 구현하려는 구조다.
- 20260508-atomic-notes-enable-context-injection — 보완: 원자 단위 노트는 컨텍스트의 입도를 줄이고, 온톨로지는 그 단위 간 경로를 제공한다.
- 20260606-claude-code — 적용 대상: Claude Code가 대형 코드베이스를 다룰 때 컨텍스트 탐색 비용을 낮추는 방식이다.
인용
태그와 폴더는 관계를 모델이 추측하게 하지만, 온톨로지는 관계를 미리 확정해 모델이 그 선을 따라가게 한다.