graphify: AI 코딩 어시스턴트와 통합하여 아키텍처 질의를 수행하는 코드베이스-지식-그래프 매퍼

해결하는 문제

Graphify는 코드, 문서, PDF, 이미지, 비디오를 포함하는 복잡한 프로젝트 디렉토리를 질의 가능한 지식 그래프로 변환합니다. 이를 통해 코드베이스의 아키텍처와 연결 관계를 이해하기 위해 파일을 수동으로 grep하거나 모든 문서를 읽어야 하는 번거로움을 없애줍니다.

작동 방식

Graphify는 로컬 AST 추출(코드를 위한 tree-sitter 사용)과 다른 미디어 유형을 위한 AI 모델 API를 결합하여 프로젝트 파일을 분석합니다. 개념, 파일, 자산 간의 관계를 매핑하여 세 가지 주요 결과물을 생성합니다: 대화형 HTML 시각화, 상세한 Markdown 보고서 (GRAPH_REPORT.md), 그리고 프로그래밍 방식의 질의를 위한 graph.json 파일입니다. 다양한 AI 코딩 어시스턴트(Claude Code, Cursor, GitHub Copilot 등)에 "skill"로 통합될 수 있어, 어시스턴트가 원본 파일을 읽는 대신 그래프를 직접 질의할 수 있게 합니다.

대상 사용자

익숙하지 않은 코드베이스를 빠르게 파악하고, 다양한 파일 유형 간의 의존성을 추적하며, AI 코딩 어시스턴트에게 프로젝트의 상위 수준 아키텍처에 대한 구조화된 이해를 제공해야 하는 개발자와 아키텍트.

주요 특징

• 광범위한 파일 지원: 36개 이상의 프로그래밍 언어, Salesforce Apex, Terraform, PDF, Office 문서, 그리고 비디오/오디오 전사(transcription)까지 처리합니다.
• AI 어시스턴트 통합: 수십 개의 플랫폼(Claude Code, Cursor, Aider 등)에서 네이티브 skill로 설치되며, hook 또는 설정 파일을 통해 "항상 켜져 있는" 가이드를 제공합니다.
• 아키텍처 통찰력: "God nodes"(중심 개념), 놀라운 모듈 간 연결, 그리고 # WHY: 또는 # NOTE:와 같은 주석에서 설계 근거를 추출합니다.
• 자동화된 문서화: Mermaid 호출 흐름 다이어그램을 내보낼 수 있으며, 그래프로부터 Markdown 위키를 생성할 수 있습니다.