지식 그래프

지식 그래프는 프로젝트 내 엔티티 간의 구조화된 관계를 저장합니다. 평면적인 메모리와 달리, 어떤 서비스가 무엇에 의존하는지, 누가 어떤 컴포넌트를 소유하는지, 아키텍처 결정이 어떻게 발전하는지를 포착합니다.

핵심 개념

모든 관계는 주어 - 서술어 - 목적어 트리플입니다.

각 팩트에는 신뢰도 점수(0-1)가 있습니다. 높은 신뢰도의 팩트는 확립된 사실이며, 낮은 점수는 변경될 수 있는 가정이나 초기 결정을 나타냅니다.

팩트는 삭제 없이 무효화할 수 있습니다. 타임라인은 히스토리를 보존합니다 — 현재 무엇이 사실인지뿐만 아니라, 언제 무엇이 사실이었는지 확인할 수 있습니다.

# Record architecture decisions as facts

kg_add

subject: "backend"

predicate: "uses"

object: "PostgreSQL"

confidence: 0.95

# Track ownership

kg_add

subject: "auth-module"

predicate: "owned-by"

object: "backend-team"

# What does the backend use?

kg_query

entity: "backend"

direction: "outgoing"

> backend uses PostgreSQL (0.95)

> backend uses Express (0.90)

> backend deployed-on Docker (0.95)

# See how decisions evolved

kg_timeline

entity: "database"

> 2026-03-01 database considered MongoDB

> 2026-03-05 database decided PostgreSQL

> 2026-03-01 MongoDB consideration invalidated

어떤 서비스가 어떤 기술을 사용하는지, 컴포넌트가 어떻게 연결되는지, 무엇이 무엇에 의존하는지 추적합니다.

왜 그런 선택을 했는지, 어떻게 발전했는지 기록합니다. 이미 결정된 사항을 다시 논의할 필요가 없습니다.

누가 어떤 모듈, 서비스, 도메인을 소유하는지 매핑합니다. 대규모 코드베이스에 유용합니다.

변경하기 전에 영향을 파악합니다. 컴포넌트를 수정하기 전에 무엇이 해당 컴포넌트에 의존하는지 조회합니다.

지식 그래프에는 5개의 전용 도구와 대응하는 REST 엔드포인트가 있습니다. 요청/응답 세부사항은 전체 API 레퍼런스를 참고하세요. REST API →