harshkedia177/axon

해결하는 문제

Axon은 코드베이스의 구조적 지식 그래프를 생성하여 변경으로 인한 파손을 방지하고 개발자 및 AI 에이전트의 인지 부담을 줄입니다. AI 에이전트가 '평평한 텍스트'(문자열 검색)로 작업하는 문제를 해결합니다. 이는 간접적 의존성의 누락과 코드가 실제로 어떻게 연결되어 있는지 이해하지 못하는 문제를 초래합니다.

작동 방식

Axon은 로컬에서 실행되는 12단계 분석 파이프라인을 사용하여 리포지토리를 인덱싱합니다. tree-sitter를 통해 AST를 추출하고, 임포트를 해결하며, 함수 호출을 추적하고, 타입 관계를 분석합니다. 이후 Leiden 알고리즘을 사용해 커뮤니티 탐지 및 git 히스토리를 분석하여 '변경 결합'(자주 함께 변경되는 파일)을 찾습니다. 이 데이터는 그래프에 저장되며, 웹 대시보드, CLI, 또는 MCP(Model Context Protocol) 서버를 통해 쿼리할 수 있습니다. AI 에이전트는 하이브리드 검색(BM25 + 벡터 + 퍼지)과 영향 분석을 수행할 수 있습니다.

대상 사용자

• AI 에이전트 개발자: Claude Code나 Cursor와 같은 에이전트에 컨텍스트 창에 과도하게 넣지 않고도 깊은 아키텍처 인식을 제공하고 싶은 사람.
• 소프트웨어 엔지니어: 콜 그래프를 시각화하거나, 죽은 코드를 탐지하거나, 리팩터링 전에 영향 범위 분석이 필요한 개발자.

주요 기능

• 인터랙티브 웹 UI: 커뮤니티 헐을 겹친 힘 기반 그래프 시각화와 Cypher 쿼리 콘솔.
• MCP 통합: axon_impact와 axon_context와 같은 도구를 노출하여 에이전트가 단일 도구 호출로 의존성을 이해할 수 있도록 합니다.
• 심층 분석: 프레임워크 인식 기반의 죽은 코드 탐지 및 실행 흐름 추적(예: FastAPI 또는 Express 라우트 탐지).
• Git 결합: git 히스토리를 분석하여 함께 변경되는 파일을 통해 숨겨진 의존성을 식별합니다.
• 로컬 우선: 모든 파싱, 임베딩, 그래프 저장은 클라우드 의존 없이 로컬에서 실행됩니다.