코드베이스를 로컬 지식 그래프로 변환하는 도구 Graphify
Graphify는 벡터 데이터베이스 없이 tree-sitter 기반 로컬 AST 파싱으로 코드와 문서를 지식 그래프로 변환합니다. 모든 연결에 추출 및 추론 신뢰도 태그를 부여하며 개발 어시스턴트 연동을 지원합니다.
이미지 출처: Graphify-Labs
벡터 임베딩을 대체하는 로컬 결정론적 AST 그래프 분석
Graphify-Labs가 개발한 Graphify는 전체 프로젝트의 소스 코드와 문서, PDF, 이미지, 동영상 등 멀티미디어 자료를 사용자가 직접 질의할 수 있는 지식 그래프(Knowledge Graph)로 구성하는 도구입니다. 임베딩이나 별도의 벡터 스토어를 사용하는 벡터 인덱스 방식이 아니며, 사용자가 직접 순회하고 탐색할 수 있는 실제 그래프 구조를 생성합니다. 이를 통해 개발자는 파일을 일일이 grep으로 검색하는 대신 생성된 그래프에 직접 질의하여 코드베이스 구조를 파악할 수 있습니다. 소스 코드 매핑은 tree-sitter AST 파서를 통해 로컬 환경에서 완전히 결정론적으로 이루어지므로, 코드 파싱 단계에서는 대형 언어 모델(LLM)이 개입하지 않으며 어떠한 코드 데이터도 로컬 머신 외부로 전송되지 않습니다. 다만 문서, PDF, 이미지, 비디오 및 오디오 파일의 시맨틱 분석에는 연동된 AI 어시스턴트의 모델이나 사용자가 별도로 설정한 API 키 백엔드가 사용됩니다.
명확한 연결 신뢰도 태그와 다중 어시스턴트 연동 지원
Graphify로 생성된 그래프 내의 모든 연결(엣지)에는 명확한 신뢰도 태그가 부여됩니다. 소스 코드에서 직접 읽어낸 명시적 연결은 'EXTRACTED'로 분류되고, Graphify의 분석 및 해석 과정을 거쳐 도출된 연결 관계는 'INFERRED'로 명확히 구분되어 사용자가 원본의 직접적 내용과 추론된 결과를 명확히 분별할 수 있습니다. 시스템 구동에는 Python 3.10 이상 및 uv(또는 pipx) 패키지 매니저가 필요하며, uv tool install graphifyy와 graphify install 명령을 통해 CLI 설치 및 어시스턴트 자동 등록을 진행합니다. Claude Code, Cursor, Codex, Gemini CLI, GitHub Copilot을 비롯해 20개 이상의 AI 어시스턴트 환경을 자동 감지하여 스킬로 등록할 수 있습니다. 설치 후 /graphify . 명령어를 실행하면 graphify-out/ 디렉터리에 브라우저에서 노드를 클릭하고 필터링 및 검색할 수 있는 인터랙티브 시각화 파일 graph.html, 핵심 개념과 주요 연결 구조를 요약한 GRAPH_REPORT.md, 그리고 통합 호환성을 위한 버전 정보(graph.schema_version, graph.graphify_version)를 포함하는 전체 그래프 데이터 graph.json 등 세 가지 파일이 생성됩니다.
서브시스템 커뮤니티 분할과 자체 보고 벤치마크 지표
Graphify는 약 40개 언어를 지원하며, 함수 호출(calls), 모듈 임포트(imports), 상속(inherits), 믹스인(mixes_in) 등의 관계를 tree-sitter AST를 통해 파일 간 교차 연결로 추적합니다. 연결도가 가장 높은 핵심 개념인 'God nodes'를 식별하고, Leiden 알고리즘을 활용해 LLM 없이 하위 시스템 커뮤니티로 분할하며, 코드 내 '# NOTE:', '# WHY:' 주석과 설계 문서(ADR, RFC) 인용도 그래프 상의 일급 노드로 통합합니다. 사용자는 터미널에서 graphify explain, graphify query, graphify path 명령을 활용해 특정 개념을 설명받거나 두 요소 간의 연결 경로를 추적할 수 있습니다. 벤치마크 수치와 관련하여, 이는 프로젝트가 공식 README에서 자체 보고한 지표이며 독립적으로 검증되지 않았고 구체적인 평가 방법과 비교 조건이 명시되지 않았습니다. 해당 자체 보고 내용에 따르면 LOCOMO(n=300) 테스트에서 0.497의 recall@10 및 45.3%의 QA 정확도를 기록했고, LongMemEval-S(n=50) QA 정확도는 76%, ERPNext cross-tool(n=6) 핵심 팩트 커버리지는 82.0%로 보고되었습니다. 이러한 수치는 외부의 독립적 검증을 거친 결과가 아니며, 다중 저장소 지원과 정형 검증 기능은 Graphify Cloud 상용 서비스를 통해 별도로 제공됩니다.