이 서비스만 고치면 되겠지? AI가 놓치는 숨은 의존성을 추적하는 법

문제 상황

• AI 코딩 도구가 단일 레포 기준으로만 코드를 이해해 MSA 환경의 서비스 간 숨은 의존성을 놓치는 문제
• 벡터 RAG로는 의미 유사 문서 검색은 가능하지만, API 호출 체인과 영향 범위 같은 다단계 관계 추적에는 한계
• 코드 변경 시 직접 영향뿐 아니라 간접 영향까지 파악하지 못하면 장애로 이어질 위험

해결 방법

• 코드 분석으로 API, 테이블, 큐, 이벤트 구조를 추출하고 LLM과 도메인 전문가 검수로 의미를 보강
• Neo4j 그래프 DB에 서비스, API, 엔티티, 규칙, 워크플로우를 연결해 관계 중심 지식 그래프 구축
• MCP 서버를 통해 Claude Code와 Cursor가 그래프를 실시간 조회하고 멀티홉 의존성을 추적

구조와 흐름

• 1단계 코드 파싱으로 정적 구조 정보 수집
• 2단계 YAML 기반 SSOT와 Neo4j 동기화로 지식 저장 및 버전 관리
• 3단계 MCP 도구로 영향도, 호출 체인, 관련 엔티티를 즉시 질의