graphify: 코드베이스를 위한 지식 그래프 생성기 – 그렙(grep) 대신 경로 추적 및 의미 기반 질의를 제공

해결하는 문제

Graphify는 코드베이스와 연관된 문서를 검색 가능한 지식 그래프로 변환합니다. 이를 통해 파일을 수동으로 그렙하거나 벡터 기반 검색에만 의존하던 방식을 대체하고, 개발자가 개념 간 정확한 경로를 추적하고 구조화된 관계를 통해 프로젝트 아키텍처를 이해할 수 있게 합니다.

작동 원리

Graphify는 tree‑sitter AST를 사용해 약 40개 언어의 소스 코드를 로컬에서 결정론적으로 파싱하고, 호출, 임포트, 상속 등 관계를 매핑합니다. PDF, 이미지, 비디오와 같은 비코드 자산은 LLM 또는 API를 통한 의미 분석을 거칩니다. 이후 전체 그래프를 담은 graph.json 파일, 인터랙티브 시각화인 graph.html, 주요 아키텍처 하이라이트를 요약한 GRAPH_REPORT.md를 생성합니다. 사용자는 explain 같은 명령으로 특정 개념을 설명받거나 path 명령으로 두 노드 간 최단 연결을 찾는 식으로 그래프를 질의할 수 있습니다.

대상 사용자

AI 코딩 어시스턴트(Claude Code, Cursor, GitHub Copilot, Aider 등)를 사용하는 개발자로, 복잡한 코드베이스를 보다 정밀하게 탐색하고 다양한 컴포넌트 간 상호작용을 이해하고자 하는 사람들을 위한 도구입니다.

주요 특징

• Local-first 코드 파싱: LLM 없이도 tree‑sitter AST를 이용해 결정론적으로 매핑하고, 코드를 외부로 전송할 필요가 없습니다.
• 멀티모달 지원: 코드, 문서, PDF, 이미지, 오디오/비디오를 하나의 통합 그래프로 매핑합니다.
• 명시적 출처 표시: 모든 연결은 EXTRACTED(소스에 명시) 또는 INFERRED(해석에 의해 도출)로 태그됩니다.
• AI 어시스턴트 통합: 20개 이상의 AI 코딩 플랫폼에 스킬로 등록되어 어시스턴트를 그래프 기반 질의로 유도할 수 있습니다.
• 아키텍처 인사이트: "God nodes"(가장 많이 연결된 개념)를 자동으로 식별하고 Leiden 커뮤니티 탐지 알고리즘을 사용해 서브시스템을 감지합니다.