JordanCoin/codemap

해결하는 문제

코드 에이전트는 일반적으로 개별 파일의 텍스트만 보기 때문에 코드베이스 내의 구조적 관계를 이해하는 데 어려움을 겪습니다. 특정 파일에 의존하는 파일은 무엇인지, 변경의 "폭발 반경"은 어느 정도인지, 또는 빌드 시스템 규칙(예: go.mod 또는 tsconfig 별칭)이 가져오기(import)에 어떻게 영향을 미치는지 쉽게 파악할 수 없습니다. codemap은 에이전트가 비용이 큰 수동 스캔 없이 의존성과 프로젝트 구조를 이해할 수 있도록 하는 구조적 "진실"을 제공합니다.

작동 방식

codemap은 단순한 문자열 매칭이 아니라 생태계별 규칙을 사용하여 리포지토리를 분석합니다. Rust용 cargo metadata, Go용 go.mod, JS/TS용 package.json과 같은 빌드 도구와 통합하여 가져오기(import)를 정확히 해결합니다. 21개 언어에 걸쳐 일반적인 가져오기 추출에는 ast-grep를 사용합니다. 신뢰성을 보장하기 위해 "카バレ지 계약"을 구현하여 의존성을 해결할 수 없는 경우 명시적으로 보고하여 에이전트가 부분적인 그래프를 완전한 것으로 오해하지 않도록 합니다.

대상 사용자

Claude Code나 Codex와 같은 AI 코드 에이전트를 사용하면서 프로젝트 아키텍처와 의존성 흐름에 대해 더 깊이 있는 구조적 이해가 필요한 개발자에게 적합합니다.

주요 기능

• 빌드 시스템 인식 해결: Go, Rust, JS/TS, Dart/Flutter의 실제 생태계 규칙을 사용하여 가져오기를 해결합니다.
• 폭발 반경 분석: 빠르게 "허브 파일"(높은 수의 가져오기 파일)을 식별하고 변경 시 영향을 받는 대상을 정확히 파악합니다.
• 에이전트 통합: 19개 도구를 갖춘 MCP 서버, 자동 컨텍스트용 세션 훅, 기계가 읽을 수 있는 프로젝트 지능용 컨텍스트 프로토콜을 제공합니다.
• 에이전트 간 전달: 어떤 에이전트가 어떤 파일을 편집했는지 추적하여 다른 AI 도구로 전환해도 원활하게 이어갈 수 있습니다.
• 원격 분석: 로컬 전체 클론 없이도 공개된 GitHub 또는 GitLab 리포지토리를 분석할 수 있습니다.