tae2089/code-context-graph

code-context-graph은(는) 무엇을 하나요?

AI 코딩 에이전트를 위한 벡터리스 코드 검색 — 비즈니스 의도(@intent, @domainRule)로 코드를 검색하며, MCP를 통해 MSA에 구축되었습니다.

개요

이 스킬은 AI 코딩 에이전트(예: Claude Code, Cursor, Codex)가 벡터 데이터베이스나 임베딩 없이도 코드베이스를 의미론적으로 검색할 수 있도록 설계되었습니다. 비즈니스 의도(예: @intent)와 도메인 규칙(예: @domainRule)을 코드 조각에 태깅함으로써, 개발자는 AI 에이전트에게 코드의 목적과 컨텍스트를 명확히 전달할 수 있습니다. AI는 이러한 태그를 인식하여 관련 코드를 직관적으로 찾아내고, 복잡한 쿼리를 단순화합니다.

주요 기능

• 벡터리스 검색: 임베딩이나 벡터 데이터베이스 없이도 코드 검색이 가능합니다.
• 의도 기반 태깅: @intent 및 @domainRule과 같은 태그를 사용하여 코드의 비즈니스 의미를 정의합니다.
• MCP 지원: Model Context Protocol을 통해 에이전트 간 컨텍스트 공유를 지원합니다.
• MSA 최적화: 마이크로서비스 아키텍처에서 여러 서비스에 걸쳐 코드 검색이 가능합니다.

사용 방법

1. 코드베이스에서 검색하려는 코드 조각에 태그를 추가합니다.

   @intent("사용자 인증 처리")
   def authenticate_user():
       pass
   

2. AI 에이전트에게 @intent 또는 @domainRule을 사용하여 쿼리합니다.
   • 예: @intent("사용자 인증 처리")
3. AI가 태그된 코드를 자동으로 찾아서 컨텍스트를 제공합니다.

설치

# MCP 서버 설정을 통해 활성화합니다.
# 자세한 내용은 공식 문서를 참조하세요.

지원 플랫폼

• Claude Code
• Cursor
• Codex
• 기타 MCP 호환 에이전트

라이선스

MIT