- 사람과 AI 에이전트가 함께 보는 코드베이스 지도를 자동으로 그려주는 오픈소스 도구
- 정적 분석과 LLM 추론을 결합해 코드베이스의 고수준 아키텍처 다이어그램과 주요 컴포넌트 문서를 자동 생성
- 결과물은
.codeboarding/ 디렉터리에 Markdown 문서와 Mermaid 다이어그램 형태로 저장되어 IDE, CI, PR, 문서에 그대로 임베드 가능
- 증분 업데이트를 지원해 코드베이스 일부만 변경된 경우 해당 부분만 재분석해 대규모 레포지토리에서도 빠르게 동작
- 6개 핵심 컴포넌트로 구성
- Application Orchestrator & Repository Manager: 분석 워크플로우 시작 및 컨텍스트 전달
- LLM Agent Core: 전문화된 도구를 호출해 코드와 분석 데이터를 다룸
- Static Code Analyzer: 코드 세그먼트의 정적 분석 수행
- Agent Tooling Interface: 에이전트가 정적 분석 엔진에 질의하는 인터페이스
- Incremental Analysis Engine: 변경된 코드만 정적 분석 요청 및 결과 캐싱
- Documentation & Diagram Generator: 분석 결과를 문서와 다이어그램으로 변환
- 활용 시나리오
- AI 에이전트가 코드를 작성하는 동안 아키텍처 가시성 유지
- AI 생성 변경사항을 시스템 컨텍스트와 함께 리뷰하여 숨겨진 기술 부채 사전 차단
- 레이어드 다이어그램과 컴포넌트 분해로 대규모 레포지토리 빠른 이해
- 로컬 워크플로우, IDE, PR, 문서에서 동일한 시각 모델 공유
- 8개 언어 지원: Python, TypeScript, JavaScript, Java, Go, PHP, Rust, C#
- 여러 LLM 프로바이더 연동: OpenAI, Anthropic, Google, Vercel AI Gateway, AWS Bedrock, Ollama, OpenRouter 등
- 세 가지 배포 형태로 제공
- CLI: 로컬 분석, 자동화, CI 워크플로우용 (
pipx install codeboarding)
- VS Code 익스텐션: 에디터 내에서 시각적 아키텍처 확인
- GitHub Action: CI에서 다이어그램을 항상 최신 상태로 유지
- 이미 800개 이상의 유명 오픈소스 레포지토리를 시각화한 샘플 디비 제공
- 비전: 인간과 AI 에이전트가 모두 활용 가능한 코드 이해의 오픈 스탠더드 구축
- MIT 라이선스
댓글과 토론