CodeBoarding - 코드베이스용 인터랙티브 아키텍처 다이어그램

• 사람과 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 라이선스

댓글과 토론