repo-scan

repo-scan

생태계마다 패키지 매니저는 있지만, C++, Android, iOS, Web 전체를 가로질러 실제로 무엇이 내 코드이고, 무엇이 서드파티이며, 무엇이 죽은 짐인지 알려주는 도구는 드뭅니다.

사용 시점

• 큰 레거시 코드베이스를 인수받아 구조 개요가 필요할 때
• 대형 리팩터링 전에 핵심, 중복, 폐기 대상을 파악할 때
• 패키지 매니저 선언이 아니라 소스에 직접 포함된 서드파티 의존성을 감사할 때
• 모노레포 재구성을 위한 아키텍처 의사결정 기록을 준비할 때

설치

# 재현 가능성을 위해 고정된 커밋만 가져온다
mkdir -p ~/.claude/skills/repo-scan
git init repo-scan
cd repo-scan
git remote add origin https://github.com/haibindev/repo-scan.git
git fetch --depth 1 origin 2742664
git checkout --detach FETCH_HEAD
cp -r . ~/.claude/skills/repo-scan

어떤 에이전트 스킬이든 설치 전에는 소스를 검토합니다.

핵심 기능

기능	설명
크로스 스택 스캔	C/C++, Java/Android, iOS(OC/Swift), Web(TS/JS/Vue)를 한 번에 스캔
파일 분류	각 파일을 프로젝트 코드, 서드파티 코드, 빌드 산출물로 태깅
라이브러리 탐지	50개 이상의 알려진 라이브러리(FFmpeg, Boost, OpenSSL 등)와 버전 추출
4단계 판정	Core Asset / Extract & Merge / Rebuild / Deprecate
HTML 리포트	드릴다운 탐색이 가능한 다크 테마 인터랙티브 페이지
모노레포 지원	요약 + 하위 프로젝트 리포트를 포함한 계층형 스캔

분석 깊이 단계

단계	읽는 파일 수	사용 사례
fast	모듈당 1~2개	매우 큰 디렉터리의 빠른 인벤토리
standard	모듈당 2~5개	의존성과 아키텍처 점검을 포함한 기본 감사
deep	모듈당 5~10개	스레드 안전성, 메모리 관리, API 일관성 추가 검토
full	모든 파일	병합 전 종합 리뷰

동작 방식

1. 저장소 표면 분류: 파일을 열거한 뒤 프로젝트 코드, 포함된 서드파티 코드, 빌드 산출물로 태깅합니다.
2. 포함 라이브러리 탐지: 디렉터리 이름, 헤더, 라이선스 파일, 버전 마커를 조사해 번들된 의존성과 가능한 버전을 식별합니다.
3. 모듈별 점수화: 파일을 모듈 또는 서브시스템 단위로 묶고, 소유권, 중복, 유지보수 비용을 기준으로 4단계 판정을 부여합니다.
4. 구조적 리스크 표시: 죽은 산출물, 중복 래퍼, 오래된 벤더 코드, 추출/재구축/폐기해야 할 모듈을 지적합니다.
5. 리포트 생성: 간결한 요약과 모듈별 드릴다운이 가능한 인터랙티브 HTML 결과를 제공합니다.

예시

파일 수 5만 개 규모의 C++ 모노레포에서:

• FFmpeg 2.x(2015년대 버전)가 아직 프로덕션에 있는 것을 발견
• 같은 SDK 래퍼가 3번 중복된 것을 발견
• 커밋된 Debug/ipch/obj 빌드 산출물 636MB 식별
• 분류 결과: 프로젝트 코드 3MB, 서드파티 596MB

모범 사례

• 첫 감사는 standard 깊이로 시작합니다.
• 모듈 100개 이상인 모노레포는 fast로 빠른 인벤토리를 먼저 만듭니다.
• 리팩터링 대상 모듈은 deep으로 점진적으로 파고듭니다.
• 하위 프로젝트 간 중복 탐지를 위해 교차 모듈 분석 결과를 검토합니다.

링크

• GitHub Repository