구글 Code Wiki 공개: 코드 저장소를 자동 갱신 대화형 문서와 아키텍처 다이어그램으로 변환

구글(Google)이 대규모 소프트웨어 저장소의 구조를 파악하고 문서화 부채를 해소하기 위한 새로운 개발자 도구인 'Code Wiki(codewiki.google)'를 공개 프리뷰로 발표했습니다. 개발자가 분석하려는 공개 저장소(Public Repository) 주소를 입력하면 인공지능이 코드베이스 전반을 해석하여 구조화된 대화형 문서, 아키텍처 다이어그램, 튜토리얼을 자동으로 구축하고, 소스 코드 변경에 맞추어 문서를 지속적으로 최신화하는 플랫폼입니다.

이미지 출처: Google / @sergiorocaa

개발팀이 겪는 가장 고질적인 문제 중 하나는 코드 변경 속도를 문서가 따라가지 못해 발생하는 문서의 노후화와 신규 개발자의 온보딩 비용입니다. 구글은 이 문제를 해결하기 위해 정적 문서 파일 대신 저장소의 생명주기와 함께 호흡하는 동적 위키 시스템을 구축했습니다.

코드 저장소 분석과 아키텍처 다이어그램 자동 생성

Code Wiki는 저장소의 소스 코드와 디렉터리 구조를 정밀 분석하여 프로젝트의 거시적 설계부터 세부 구현까지 단계별로 조망할 수 있는 구조화된 지식 베이스를 생성합니다.

• 아키텍처 및 의존성 시각화: 전체 시스템 구성도, 모듈 간 데이터 흐름, 핵심 클래스 다이어그램 및 시퀀스 다이어그램을 코드를 바탕으로 자동 도출합니다. 복잡하게 얽힌 외부 라이브러리와 내부 컴포넌트 간의 결합도를 시각적으로 한눈에 파악할 수 있습니다.
• 단계별 워크스루와 튜토리얼: 프로젝트에 처음 진입한 엔지니어가 애플리케이션의 엔트리포인트부터 실행 흐름까지 쉽게 따라갈 수 있도록 단계별 가이드를 자동으로 엮어냅니다.
• 코드 직결 하이퍼링크: 모든 문서 섹션과 다이어그램 요소는 실제 저장소의 파일 경로와 함수 정의, 라인 번호로 하이퍼링크 처리되어 있어 문서를 읽는 과정과 실제 코드를 탐색하는 과정이 단일 작업 흐름으로 통합됩니다.

소스 코드 연동 하이퍼링크와 저장소 기반 Gemini 챗봇

문서 열람 기능에 더해, Code Wiki는 코드베이스에 특화된 대화형 어시스턴트를 인터페이스 내에 기본 제공합니다.

구글의 플래그십 파운데이션 모델인 Gemini를 기반으로 구동되는 내장 챗봇은 일반적인 상식만을 학습한 범용 챗봇과 차별화됩니다. 저장소에서 실시간으로 생성되고 유지되는 전체 위키와 코드 색인을 전용 지식 기반(Knowledge Base)으로 활용하기 때문에, 저장소 고유의 설계 원칙과 특수한 도메인 로직을 정확히 인지한 상태에서 개발자의 기술적 질의에 답변합니다.

특정 API 엔드포인트의 호출 경로, 특정 비즈니스 로직이 처리되는 세부 함수 위치, 데이터베이스 트랜잭션의 롤백 정책 등 구체적인 구현 질문을 던지면 관련 코드 위치를 정확한 링크와 함께 제시합니다.

지속적 문서 갱신과 공개 프리뷰 운영 정책

Code Wiki의 가장 핵심적인 가치는 코드가 커밋되고 브랜치가 병합될 때마다 문서가 함께 갱신된다는 점입니다. 개발자가 문서를 수동으로 작성하고 수정하는 별도의 관리 공수를 들이지 않아도 위키가 언제나 최신 코드베이스 상태를 반영합니다.

• 공개 프리뷰 지원 범위: 현재 codewiki.google 웹 서비스를 통해 공개 프리뷰 형태로 제공되며, GitHub 등의 공개 원격 저장소를 등록하여 즉시 인터랙티브 문서를 생성해 볼 수 있습니다.
• 실무 도입 시 유의사항: 자동 생성되는 아키텍처 다이어그램과 요약 품질은 기본 코드베이스의 모듈 분리도와 주석 작성 수준에 영향을 받습니다. 독자적인 프레임워크나 비표준 디렉터리 패턴을 사용하는 특수 프로젝트의 경우 도출된 아키텍처 명세에 대한 개발자의 교차 검증이 권장됩니다.

출처

• Google Developers Blog - Introducing Code Wiki: Accelerating your code understanding
• Google Code Wiki 공식 서비스
• Sergio Roca (@sergiorocaa) X Post