codebase-md: 도구가 git hook 유지 관리와 함께 CLAUDE.md를 자동 생성합니다

도구 개요

codebase-md는 Claude Code를 사용하는 프로젝트를 위해 CLAUDE.md 파일을 자동으로 생성하고 유지하는 Python 도구입니다. 버전 0.1.0은 알파 단계이며 MIT 라이선스를 따릅니다.

설치 및 기본 사용법

AST 지원과 함께 설치: pip install "codebase-md[ast]"

스캔 및 생성: codebase scan . 다음에 codebase generate .

생성된 내용

이 도구는 다음을 포함하는 CLAUDE.md를 생성합니다:

• 아키텍처 패턴 감지 (모놀리식, 모노레포, 마이크로서비스, CLI 등)
• 네이밍 스타일, 임포트 패턴 및 tree-sitter AST를 통한 디자인 패턴을 포함한 자동 감지된 컨벤션
• PyPI/npm 레지스트리 대비 의존성 건강 점검
• 기여자 분석 및 파일 핫스팟이 포함된 Git 인사이트
• Claude가 관련 코드베이스 부분을 쿼리할 수 있도록 하는 스마트 컨텍스트 라우팅

추가 기능

다른 도구를 위한 구성 파일 생성: 동일한 스캔에서 .cursorrules, AGENTS.md, codex.md 및 .windsurfrules.

Git 훅 설치: codebase hooks install .은 생성된 파일을 자동으로 최신 상태로 유지합니다.

의존성 인텔리전스

의존성 관리를 위한 deps 명령어 포함:

• codebase deps . - 전체 건강 대시보드
• codebase deps . --offline - 로컬 점수만, 레지스트리 호출 건너뜀
• codebase deps . --upgrade fastapi - 특정 패키지에 대한 업그레이드 계획

의존성 시스템은 레지스트리 대비 고정 버전을 확인하고 오래된 패키지, 관리가 잘 되지 않는 패키지 및 업그레이드 경로의 호환성 문제를 표시합니다.

개발 세부사항

이 도구는 아키텍처 결정을 위해 Claude Code, tree-sitter AST 통합, TF-IDF 컨텍스트 순위 시스템 및 354개의 테스트 스위트를 사용하여 구축되었습니다. 프로젝트 자체의 CLAUDE.md는 codebase-md에 의해 생성되었습니다.