• AI 코딩 어시스턴트에서
  /graphify .

하면 코드/문서/PDF/이미지/영상 전체가 지식 그래프로 매핑되어, 파일을 grep하는 대신 질문으로 탐색하는 방식으로 전환

• 질문하면 관련 서브그래프만 반환해서 전체 파일을 읽을 필요 없음

• 코드는
  tree-sitter AST로 로컬 파싱되어 LLM 호출 자체를 하지 않음. 즉 그래프 빌드하는 LLM 토큰은 제로

• 코드가 머신 밖으로 나가지 않아, 데이터 레지던시 요구가 있는 조직도 API 키 없이 완전 오프라인으로 인덱싱 가능

• 모든 연결에
  EXTRACTED

(원문 명시) / INFERRED

(추론) 신뢰도 태그가 붙어, LLM 결과를 그대로 믿어야 하는 상황을 피하고 어디까지가 근거인지 확인 가능

• 임베딩 및 벡터 스토어를 쓰지 않는
  실제 그래프여서, 유사도 검색이 아니라 두 대상 간 경로 추적(path

)과 개념 설명(explain

)이 가능

• 코드 외에 SQL 스키마, Terraform/HCL, MCP 설정, 패키지 매니페스트, Office 문서, PDF, 이미지, 영상 URL까지 동일 그래프로 통합

• 핵심 질의 명령 3종
  graphify query "what connects auth to the database?"

• 자연어 질문에 범위 한정 서브그래프 반환
  graphify path "FastAPI" "ModelField"

• 두 대상 간 최단 경로를 홉 단위로 출력
  graphify explain "APIRouter"

• 소스 위치, 커뮤니티, 차수, 연결 목록 표시

# NOTE:

/ # WHY:

주석과 ADR/RFC 인용이 일급 노드로 추출되어 코드와 연결 → 코드만 봐서는 알 수 없는 설계 이유까지 검색 대상

• 어시스턴트가 항상 그래프를 먼저 참조하도록 훅/지시 파일을 설치, 원본 파일을 하나씩 읽는 동작을
  질의로 대체하도록 강제 가능
  graphify-out/

을 git에 커밋하면 팀 전원이 같은 코드 지도에서 시작, 커밋마다 자동 재빌드되며 API 비용도 발생하지 않음
python -m graphify.serve

로 그래프를 MCP 서버로 노출해, --transport http

로 팀 전체가 하나의 URL 공유 가능

• MIT 라이선스

댓글과 토론