대규모 코드베이스 이해를 위한 AI 에이전트용 그래프 기반 CLI 도구 'Nomik' 출시

핵심 요약

Nomik은 Neo4j 그래프 데이터베이스와 MCP를 활용하여 AI 에이전트가 대규모 코드베이스의 전체 아키텍처와 의존성을 정확히 파악하도록 돕는 CLI 도구이다.

배경

AI 에이전트가 대규모 코드베이스에서 전체적인 아키텍처를 파악하지 못하고 환각(Hallucination)을 일으키는 문제를 해결하기 위해, 로컬 코드를 Neo4j 그래프로 인덱싱하여 MCP를 통해 에이전트에게 제공하는 Nomik을 개발하여 공개했다.

의미 / 영향

AI 에이전트의 성능 한계가 단순한 모델 지능보다 컨텍스트 제공 방식의 문제임을 시사한다. 그래프 DB를 활용한 아키텍처 매핑이 코드 에이전트의 정확도를 높이는 실무적인 해결책이 될 수 있음이 확인됐다.

커뮤니티 반응

작성자가 도구를 직접 소개하며 대규모 레포지토리에서의 성능 검증을 마쳤음을 강조했다. 복잡한 코드베이스에서 AI 에이전트의 성능 저하를 겪는 개발자들에게 피드백을 요청하며 실무 적용 가능성을 제시했다.

언급된 도구

Nomik추천링크

AI 에이전트용 코드 그래프 인덱싱 CLI 도구

Neo4j추천

관계 쿼리 처리를 위한 그래프 데이터베이스

Tree-sitter추천

정밀한 코드 파싱을 위한 파서 생성기

Cursor추천

MCP를 통해 Nomik과 연동되는 AI IDE

섹션별 상세

AI 에이전트의 코드 이해 한계 극복을 위해 기존 AI 에이전트가 현재 열려 있는 파일 위주로 컨텍스트를 파악하는 방식을 개선했다. 코드 변경이 전체 아키텍처에 미치는 영향인 '폭발 반경(Blast Radius)'을 이해하지 못하는 문제를 해결하기 위해 로컬 코드를 파싱하여 Neo4j 그래프에 저장한다. 이를 통해 에이전트가 쿼리할 수 있는 영구적인 '메모리'를 생성하여 복잡한 레포지토리에서도 정확한 답변을 유도한다.

심층 파싱 및 교차 도메인 추적 기술을 적용하여 Tree-sitter 기반의 커스텀 파서로 함수 호출, 클래스 계층 구조, 임포트 관계를 정밀하게 매핑한다. 단순한 코드 구조뿐만 아니라 Prisma나 Supabase 같은 DB 작업, 이벤트 이미터(Event Emitters), 라우트 정보까지 추적하여 도메인 간의 연결 고리를 시각화한다. 대규모 레포지토리인 leboncoin 등에서 테스트를 거쳐 파서의 안정성을 검증했다.

영향 분석 및 실시간 에이전트 연동 기능을 통해 특정 서비스를 수정할 때 발생하는 의존성 그래프를 추적한다. 사용자가 "UserService를 변경하면 어떤 일이 발생하는가?"와 같은 질문을 던지면 전체 레포지토리를 관통하는 의존성 그래프를 추적하여 답변한다. MCP(Model Context Protocol)를 기본적으로 지원하여 Cursor나 Windsurf 같은 AI IDE와 직접 연결되어 에이전트가 실시간으로 그래프 정보를 조회하도록 설계됐다.

이미지 분석

Screenshot
코드베이스의 의존성 구조나 분석된 메트릭을 시각적으로 보여준다. 도구가 실제로 어떻게 코드를 파싱하고 관계를 시각화하는지 인터페이스를 통해 확인할 수 있다.
Nomik의 코드 분석 결과 및 대시보드 스크린샷

실무 Takeaway

Nomik은 대규모 코드베이스에서 AI 에이전트의 환각 현상을 줄이기 위해 그래프 기반의 코드 인덱싱을 활용한다.
Neo4j와 Tree-sitter를 사용하여 코드 간의 복잡한 의존성과 DB/이벤트 흐름을 정밀하게 추적한다.
MCP 지원을 통해 Cursor 등 최신 AI IDE에서 에이전트가 코드 아키텍처를 실시간으로 참조할 수 있다.

언급된 리소스

DemoNomik 공식 홈페이지