대규모 Java/Spring 모노레포를 Claude에 맞게 압축하는 오픈소스 CLI

sourcecode라는 오픈소스 CLI 도구가 대규모 엔터프라이즈 저장소를 Claude 친화적 컨텍스트로 압축하기 위해 출시되었습니다. Java/Spring 모노레포를 대상으로 하며, 코드베이스를 Claude와 같은 LLM에 제공할 때 발생하는 과도한 토큰 사용 문제를 해결합니다.

기능

이 도구는 기본적으로 여러 기능을 제공합니다:

• 저장소 컨텍스트 압축 — 실제 Java Spring Boot + Angular 모노레포(~4k 파일)를 수동 추정 약 300만 토큰에서 --agent 모드: 약 5k 구조화 토큰, 또는 --compact 모드: 약 1.7k 토큰으로 줄입니다.
• Git 핫스팟/변경 탐지 — 자주 변경되는 파일 식별.
• TODO/FIXME 추출 — 모든 코드 주석 추출.
• 심볼 조회 — 중복 모듈 및 프로젝트 전반에서 조회.
• PR 델타 워크플로우 — Claude 워크플로우를 위한 구조화된 JSON/YAML 출력 생성.

현재 한계

저자는 깊은 Java 의미론, Spring/MyBatis 이해, 파일 간 추론 및 전체 아키텍처 이해는 여전히 주요 진행 중인 작업이라고 언급합니다. 이 도구는 현재 범용 AI 코드 인텔리전스 플랫폼보다는 컨텍스트 압축 및 탐색 도구로서 훨씬 유용합니다.

향후 계획

앞으로 이 프로젝트는 다음에 집중할 것입니다:

• 특히 Java/Spring 모노레포
• 의미론적 심볼 그래프
• 영향 분석
• 작업 트리 인식

설치

PyPI 및 npm을 통해 사용 가능:

pip install sourcecode==1.0.0
# or
npm install sourcecode-npm

GitHub 저장소: HarounDominique/sourcecode

대상 사용자

대규모 Java/Spring 모노레포를 사용하는 Claude 개발자로서 컨텍스트 크기를 줄이면서 탐색성과 핵심 코드 구조를 유지해야 하는 분들.