Mindwalk: 전체 코드베이스를 3D 지도로 확인하세요

하이라이트

• 마인드워크(MindWalk)는 클로드 코드와 Codex의 세션 로그를 분석해 전체 코드베이스를 3D 도시 형태의 건물로 시각화하는 Go 언어 기반 단일 바이너리 도구다.

• 3D 공간에서 파일의 탐색 및 수정 단계는 색상으로 구분되며, 훑어보기는 이끼색 녹색, 정독은 파란색, 코드 수정은 호박색으로 표현된다.

• 타임라인에는 하위 에이전트 생성, 컨텍스트 윈도우 압축, 사용자 개입 시점이 기호로 기록되어 실행 과정을 한눈에 추적할 수 있다.

• analyze 명령어를 실행하면 에이전트가 수정 전 충분히 탐색했는지, 지정 범위를 벗어났는지, 작업 검증을 시도했는지 평가하는 리포트와 해당 시점 링크를 제공한다.

• 현재 v0.3 극초기 단계로 클로드 코드와 Codex 로그만 지원하며 Cursor 세션 재생은 지원하지 않는다.

타임라인

1. 00:00 - 01:03

   AI 에이전트 로그의 한계와 3D 시각화의 필요성

   2년 동안 개발자들은 AI 에이전트가 변경한 수많은 코드 줄을 직접 스크롤하며 검토해 왔다. 단순 실행 결과 기록만으로는 에이전트가 코드를 제대로 이해하고 작업했는지 검증하기 어렵다. 에이전트가 어떤 파일을 관련 있다고 판단하고 조사했는지 직관적으로 파악할 수 있는 시각적 접근법이 필요한 이유다.

   • 기존 텍스트 방식의 에이전트 로그는 실행 결과만 보여줄 뿐 문제 해결 과정에서의 추론 경로를 보여주지 못한다.
   • 수정을 진행하기 전 탐색한 범위나 리포지토리 침범 여부 등 에이전트의 실제 사고 과정은 로그 분석만으로 파악하기 어렵다.
   • 마인드워크는 에이전트의 파일 이동 및 탐색 과정을 3D 공간 상에서 가시화하여 이 문제를 해결한다.
2. 01:04 - 02:19

   마인드워크 작동 방식과 색상 기반 이동 경로 추적

   Go 바이너리와 브라우저 내 Three.js 씬을 연동해 클로드 코드 및 Codex가 저장한 세션 로그를 3D로 시각화한다. 차가운 색상은 탐색 상태를, 따뜻한 색상은 수정 상태를 의미하므로 작업 흐름을 한눈에 식별할 수 있다. 타임라인 드래그를 통해 세션 전체의 이동 경로를 세밀하게 추적할 수 있다.

   • 코드베이스의 각 파일은 건물로 렌더링되며 코드 양이 많을수록 건물의 높이가 높아진다.
   • 에이전트의 작업 단계에 따라 건물 조명이 이끼색 녹색(훑어보기), 파란색(정독), 호박색(수정)으로 실시간 변경된다.
   • 타임라인의 전용 기호를 통해 하위 에이전트 생성, 컨텍스트 압축, 사용자 개입 시점을 명확히 나타낸다.
3. 02:20 - 02:58

   AI 코드 리뷰를 위한 analyze 명령어와 map 기능

   단순한 3D 재생을 넘어 에이전트 작업의 타당성을 평가하는 분석 기능을 갖추고 있다. 수정을 시작하기 전 충분한 탐색 과정을 거쳤는지, 설정된 범위를 벗어나 딴길로 새지 않았는지, 수정 후 작업 검증을 시도했는지 세부 항목별로 검토해 단점을 보완하도록 돕는다.

   • analyze 명령어는 로컬 모델을 활용해 전체 세션을 심사하고 에이전트의 탐색 및 검증 동작을 평가한다.
   • 평가 결과 항목은 클릭 시 타임라인의 해당 발생 시점으로 즉시 이동하는 링크를 제공한다.
   • 세션 기록이 없는 리포지토리도 map 명령어를 통해 즉시 3D 도시 형태로 시각화할 수 있다.
4. 02:59 - 05:00

   실용성 논란과 마인드워크의 적합한 사용 환경

   해커뉴스 등 커뮤니티에서는 단순 수정 작업 시 3D 투어보다 git diff가 빠르다는 실용성 지적이 제기되었다. 현재 v0.3 단계로 Cursor 로그 미지원 등 한계가 있으나, 거대한 변경 사항의 전반적인 윤곽과 맥락을 파악할 때는 3D 플라이스루와 평가 리포트가 명확한 맥락을 제공한다.

   • 소규모 단순 수정 작업에는 3D 재생보다 전통적인 git diff를 확인하는 것이 훨씬 효율적이다.
   • 클로드 코드와 Codex 사이에 일어나는 코드 탐색 방식의 차이를 비교하거나 대규모 변경 사항을 검토할 때 유용하다.
   • AI가 코드를 작성하는 속도와 인간이 이를 이해하는 속도 사이의 격차를 줄여주는 도구다.