mindwalk
에이전트 세션을 코드베이스 3차원 지도 위에 재생하는 도구
curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh세션 기록은 에이전트가 무엇을 했는지는 남기지만 작업을 어떻게 이해했는지는 남기지 않습니다. 저장소의 어느 부분을 관련 있다고 봤는지, 손대기 전에 어디를 살폈는지, 남긴 발자국이 내가 생각한 범위와 맞았는지는 원본 기록을 한 줄씩 읽어도 나오지 않습니다. 이 도구는 그 기록을 코드베이스의 3차원 지도 위에 다시 재생해 보여 줍니다. 어디를 탐색하고 어디를 고쳤는지가 공간으로 드러나므로 범위가 어긋난 작업을 눈으로 찾습니다. 고로 만들어 단일 실행 파일로 설치됩니다.
판단
이럴 때 씁니다
- 에이전트가 왜 그렇게 움직였는지 알고 싶을 때
- 작업 범위가 어긋났는지 확인할 때
- 긴 세션 기록을 한눈에 보고 싶을 때
이럴 땐 쓰지 마세요
- 세션 기록이 없으면 볼 것이 없습니다
- 작은 저장소에서는 지도가 밋밋합니다
- 코드를 고쳐 주는 도구가 아닙니다
차별점
- 세션을 코드베이스 지도 위에 공간으로 재생합니다.
- 탐색한 곳과 고친 곳을 구분해 보여 줍니다.
- 고 단일 실행 파일로 설치가 간단합니다.
- 원본 기록으로는 안 보이는 이해 범위를 드러냅니다.
워크플로
- 01도구를 설치합니다.
- 02세션 기록을 지정합니다.
- 03코드베이스 지도를 만듭니다.
- 04세션을 재생하며 탐색 경로를 봅니다.
- 05발자국이 의도한 범위와 맞는지 확인합니다.
주요 명령
| 명령 | 설명 |
|---|---|
curl -fsSL https://raw.githubusercontent.com/cosmtrek/mindwalk/master/scripts/install.sh | sh | 설치합니다. |
함정
설치 전에 확인하세요
- 세션 기록이 있어야 재생할 것이 생깁니다. 기록을 안 남기는 설정이면 소용없습니다.
- 지도를 만들 때 저장소 전체를 훑습니다. 큰 저장소는 시간이 걸립니다.
- 판이 0.5 대입니다. 서버 구성 요소 경계가 아직 정리되는 중입니다.
- 브라우저 화면으로 보므로 원격 서버에서는 접근 경로를 따로 열어야 합니다.
비교
세션 기록을 읽는 도구는 무엇을 했는지 목록으로 보여 줍니다. 이쪽은 어디를 관련 있다고 봤는지를 공간으로 드러내 범위 착오를 찾게 합니다. 대신 코드를 고쳐 주지는 않습니다.
최근 변경
서버 구성 요소의 경계를 정리했습니다. 추적 저장소와 어댑터 연결 규격, 보고서 색인이 분리되고 루프백 접근이 단단해졌습니다. 지도 생성에 한계를 둔 적응형 훑기도 들어갔습니다.