AI 칼럼

온톨로지@donghyeok99운영진

graphify: 폴더 하나를 에이전트가 묻는 지식 그래프로

한 개발자가 GPTers 저장소 3개, 단어 152만 개를 graphify로 그래프 하나에 접었어요

/graphify . 한 줄에 코드·문서·SQL·PDF가 노드로 떠올라 graph.html에서 커뮤니티로 묶이고, FastAPI에서 ModelField까지 3단계 경로가 켜져요
/graphify . 한 줄에 코드·문서·SQL·PDF가 노드로 떠올라 graph.html에서 커뮤니티로 묶이고, FastAPI에서 ModelField까지 3단계 경로가 켜져요
누가
Safi Shamsi가 Claude Code 스킬로 시작했고, 지금은 Graphify Labs(YC S26)가 Apache-2.0으로 공개해요
언제
2026년 4월 3일 저장소가 열렸고, 최신 릴리스는 0.9.97(2026년 10월 27일)이에요
어디서
Claude Code, Codex, Cursor, Gemini CLI 등 20여 개 어시스턴트 · macOS, Linux, Windows · 코드는 내 PC에서 분석

이게 불편했어요

큰 저장소에서 에이전트에게 「인증이 DB까지 어떻게 이어져?」라고 물으면, 에이전트는 grep으로 파일을 하나씩 열어 보며 답을 찾아요. 다음 세션에 같은 걸 물으면 또 처음부터 읽고요. 코드 옆에 설계 문서, SQL 스키마, 논문 PDF까지 섞여 있으면 어디서부터 봐야 할지 사람도 감이 안 와요.

그래서 이렇게 풀어요

graphify는 폴더 전체를 한 번 읽어 지식 그래프로 남겨 두고, 그 뒤로는 파일 대신 그래프에 물어보게 해요. 코드는 tree-sitter로 내 PC에서 파싱하니 LLM도 API 키도 쓰지 않고, 연결마다 소스에서 직접 읽은 것(EXTRACTED)인지 추론한 것(INFERRED)인지 꼬리표가 붙어요. 임베딩이나 벡터 DB 없이 진짜 그래프를 따라가기 때문에, 두 개념이 어떤 길로 이어지는지 경로째 보여 줄 수 있어요.

FastAPI 코드베이스를 graphify로 그린 graph.html, 색은 커뮤니티예요
FastAPI 코드베이스를 graphify로 그린 graph.html, 색은 커뮤니티예요
graphify explain "APIRouter"Node: APIRouter  Source:    routing.py L2210  Community: 2  Degree:    47Connections (47):  --> RequestValidationError [uses] [INFERRED]  --> .get() [method] [EXTRACTED]  <-- __init__.py [imports] [EXTRACTED]graphify path "FastAPI" "ModelField"Shortest path (3 hops):  FastAPI --uses--> DefaultPlaceholder <--references-- get_request_handler() --references--> ModelField
README의 실행 예시

이걸로 만든 사람들

gpters.orgGPTers 회원2026-04

GPTers 저장소 3개(파일 1,643개, 단어 약 152만 개)를 graphify로 돌려 노드 4,942개·커뮤니티 166개짜리 그래프를 만들고 과정을 글로 정리했어요.

GPTers 3개 레포 152만 단어를 하루 만에 정리한 이야기
좋아요 4 · 댓글 1 (2026-10-30 기준)gpters.org ↗
Hacker Newshamzmu2026-04-12

Rootly의 장애·알림·팀 데이터를 graphify 그래프로 바꾸는 임포터(rootly-graphify-importer)를 만들어, 서비스별 장애와 온콜 공백을 graph.html에서 걸러 보게 했어요.

Used Graphify to turn incidents into a queryable knowledge graph
좋아요 10 · 댓글 0 (2026-10-30 기준)Hacker News ↗

안에서는 이렇게 돌아가요

  1. 1

    나 → /graphify 스킬 (SKILL.md)

    graphify install스킬을 ~/.claude/skills/graphify/SKILL.md에 놓고 CLAUDE.md와 PreToolUse 훅에 등록해요graphify/install.py
  2. 2

    /graphify 스킬 (SKILL.md) → Claude Code

    /graphify .Claude Code가 SKILL.md 순서대로 폴더 파일을 코드·문서·논문·이미지·영상으로 나눠요graphify/detect.py
  3. 3

    Claude Code → tree-sitter AST 추출

    코드 파일 → 클래스·함수·import·호출코드는 LLM 없이 로컬에서 파싱해 EXTRACTED 연결로 남겨요graphify/extract.py
  4. 4

    Claude Code → 의미 추출 서브에이전트

    문서·PDF·이미지 묶음Agent 도구로 서브에이전트를 나눠 띄워 노드·엣지 JSON 조각을 받아요. 코드만 있으면 건너뛰어요graphify/skill.md
  5. 5

    Claude Code → graphify-out/

    병합 → Leiden 커뮤니티 → graph.json두 결과를 합쳐 그래프를 만들고 밀도로 커뮤니티를 나눠 저장해요graphify/cluster.py
  6. 6

    graphify-out/ → 나

    graph.html · GRAPH_REPORT.md브라우저로 여는 그래프와, 핵심 개념·의외의 연결·추천 질문을 담은 보고서graphify/exporters/html.py
  7. 7

    Claude Code → graphify-out/

    graphify query / path / explain그다음부터는 원본 파일 대신 graph.json을 읽어 질문에 답해요graphify/cli.py

넣으면 이렇게 나와요

graphify explain "APIRouter"routing.py L2210, 커뮤니티 2, 연결 47개와 각 연결의 EXTRACTED/INFERRED 표시
graphify path "FastAPI" "ModelField"3단계 경로: FastAPI → DefaultPlaceholder → get_request_handler() → ModelField
GPTers 저장소 3개, 파일 1,643개 · 단어 약 152만 개노드 4,942개 · 엣지 9,235개 · 커뮤니티 166개 (GPTers 글)
/graphify add https://arxiv.org/abs/1706.03762논문을 받아 같은 그래프에 더해요

나한테 맞을까요

이럴 때 좋아요

  • 처음 맡은 큰 저장소의 구조를 한 장으로 먼저 보고 싶을 때
  • 에이전트가 같은 파일을 세션마다 다시 grep하며 읽는 게 답답할 때
  • 코드와 설계 문서·SQL 스키마·논문이 한 폴더에 섞여 있는 프로젝트
  • 코드를 밖으로 보내면 안 되는 저장소(코드 분석은 로컬에서만 돌아요)

이건 안 돼요

  • 문서·PDF·이미지는 어시스턴트 모델이나 설정한 API 키로 읽어서 토큰이 들어요. 코드만 있으면 들지 않아요.
  • 노드가 5,000개를 넘으면 graph.html이 커뮤니티 묶음 보기로 바뀌어요(--node-limit로 조정).
  • leiden 추가 설치 없이는 Louvain으로 대신 묶여요. 나중에 바꾸면 커뮤니티가 전부 다시 섞여요.
  • 늘 켜져 있는 그래프, 여러 저장소 연결, 형식 검증은 유료 Graphify Cloud(14일 무료 체험) 쪽 기능이에요.

발행 전에 Devalley 편집자가 검토했어요. 칼럼은 어떻게 만드나요

로그인하면 글을 쓰고 댓글과 좋아요로 참여할 수 있어요.로그인

신고하기

사유

커뮤니티 규칙 보기