graphify: 코드와 문서를 AI 어시스턴트를 위한 쿼리 가능한 지도으로 변환하는 프로젝트 전체 지식 그래프 생성기

graphify: 코드와 문서를 AI 어시스턴트를 위한 쿼리 가능한 지도으로 변환하는 프로젝트 전체 지식 그래프 생성기

해결하는 문제

Graphify는 코드, 문서, PDF, 이미지, 비디오 등 프로젝트의 다양한 파일을 쿼리 가능한 지식 그래프로 변환합니다. 이를 통해 파일을 일일이 grep하거나 전체 디렉터리를 살펴보며 코드베이스의 구조와 연결 관계를 이해할 필요가 없어집니다.

작동 방식

Graphify는 로컬 AST 추출(코드의 경우 tree‑sitter 사용)과 비코드 파일에 대한 AI 모델 API를 결합합니다. 프로젝트를 그래프 구조로 매핑하고 세 가지 주요 출력을 생성합니다: 인터랙티브 HTML 시각화, 핵심 개념과 "god nodes"를 강조한 상세 Markdown 보고서, 그리고 프로그래밍 방식으로 쿼리할 수 있는 JSON 파일. 이를 다양한 AI 코딩 어시스턴트(Claude Code, Cursor, GitHub Copilot 등)의 "skill"로 통합하면 어시스턴트가 원시 파일을 읽는 대신 그래프에 직접 쿼리할 수 있습니다.

대상 사용자

복잡한 코드베이스를 탐색하고, 모듈 간 관계를 이해하며, 새로운 프로젝트에 빠르게 온보딩해야 하는 개발자와 아키텍트.

주요 특징

  • 광범위한 파일 지원: 코드용 36개의 tree‑sitter 문법과 PDF, Office 문서, Google Workspace 파일, 비디오/오디오 전사본을 처리합니다.
  • AI 어시스턴트 통합: Claude Code, Cursor, Aider, Trae 등 수십 개 플랫폼에 네이티브 skill로 설치되어 어시스턴트를 그래프 기반 쿼리로 유도합니다.
  • 깊은 인사이트: 가장 많이 연결된 개념인 "god nodes"와 멀리 떨어진 모듈 간의 "놀라운 연결"을 식별합니다.
  • 신뢰도 추적: 모든 관계를 EXTRACTED, INFERRED, AMBIGUOUS 로 표시해 확실한 사실과 AI 추측을 구분합니다.
  • 아키텍처 내보내기: 아키텍처 문서를 위한 Mermaid 호출 흐름 다이어그램을 생성할 수 있습니다.

Sources