diffmap — 에이전트 코드 리뷰, 라인 diff 대신 설계 다이어그램으로 보는 문서 형식
공개 내용
diffmap은 에이전트 코드를 계획하고 리뷰하기 위한 새 문서 형식이자 스킬입니다. 에이전트에게 브랜치 변경 사항에 대한 diffmap 스펙 작성을 지시하면, 대규모 라인 diff 대신 중요한 설계 결정을 인터랙티브 다이어그램과 위젯으로 정리해 보여줍니다.
작성자 Tanishq Kancharla는 2개월 넘게 이터레이션하며 큰 기능과 리팩터링 작업에 매일 써 왔다고 밝혔습니다. 2026-10-30에 공개됐으며, MIT 라이선스 오픈소스입니다. GitHub 저장소는 2026-09-10에 생성됐고 TypeScript로 작성됐으며, 공개 당일 기준 스타 71개를 기록했습니다.
| 항목 | 내용 |
|---|---|
| 형태 | 문서 형식 + 스킬 |
| 대상 | 에이전트 코드 계획·리뷰 |
| 라이선스 | MIT |
| 언어 | TypeScript |
| 저장소 생성 | 2026-09-10 |
| 공개 당일 스타 | 71개 |
리뷰 단위의 전환
기존 코드 리뷰의 단위는 라인 diff입니다. 파일이 많아지고 변경이 커질수록, 라인을 하나씩 읽는 방식으로는 설계가 어떻게 바뀌었는지 파악하기가 어려워집니다. diffmap은 이 단위 자체를 설계 변경으로 바꿉니다.
제공되는 다이어그램은 세 가지입니다. 관련 서비스와 상태 변화, 시간에 따른 데이터 흐름을 보여주는 서비스 다이어그램, mermaid 다이어그램의 변경을 보여주는 mermaid 다이어그램 diff, 그리고 콜스택 diff입니다. 스킬 안에는 다이어그램별 사용 시점 가이던스가 들어 있어, 어떤 상황에서 어떤 다이어그램을 봐야 하는지 안내합니다.
계획·커밋·코멘트 흐름
계획은 phase 단위로 작성되며, phase 하나가 커밋 하나에 대응합니다. 에이전트가 phase를 마치면 중요도 순으로 파일을 정렬한 커밋 위젯을 보여주고, 파일을 클릭하면 Pierre 기반 diff 패널이 열립니다.
협업 루프도 문서 안에 있습니다. diffmap에 직접 코멘트를 달 수 있고, 그 내용을 복사해 에이전트에게 전달하는 방식입니다. 리뷰 도구를 따로 열지 않고, 정리된 설계 문서 안에서 지적하고 전달하는 흐름입니다.
공개 반응 수치
공개 글의 반응은 조회보다 저장 쪽이 강했습니다. 2026-10-30 확인 기준으로 X 공개 글 조회는 약 1.49만, 좋아요 323건, 북마크 430건입니다. 북마크가 좋아요를 웃도는 저장형 반응이 두드러집니다.
다만 이 수치는 공개 당일 기준이라 확산 여부를 판단하기에는 이릅니다. 저장형 반응이 많다는 점은 관심의 성격에 대한 단서일 뿐, 채택 규모를 보여주는 지표는 아닙니다.
실무 시사점
이 형식이 가장 잘 맞는 경우는 큰 기능과 리팩터링처럼 변경 범위가 넓은 작업입니다. 라인 diff만으로는 설계 의도를 읽기 어려운 규모의 변경에서, 다이어그램 diff가 변경의 요지를 먼저 보여주는 역할을 합니다.
에이전트와 함께 일하는 팀이라면, 계획 단계에서 phase와 커밋을 1대1로 맞추는 규칙부터 적용해 보시기 바랍니다. 리뷰할 때 파일 목록을 중요도 순으로 정렬해 보여주는 것만으로도, 큰 브랜치의 검토 순서를 정하는 데 도움이 됩니다.
diffmap을 도입하기 전에, 먼저 스킬의 다이어그램별 사용 시점 가이던스를 확인하시기 바랍니다. 서비스 다이어그램과 mermaid diff, 콜스택 diff는 각각 다른 질문에 답하므로, 상황에 맞지 않는 다이어그램을 고르면 라인 diff를 보는 것보다 나아지지 않습니다.
이 글은 ax-trend 이슈 #3664와 공개 당일 확인된 내용만을 정리한 것이며, 실제 사용 경험이나 성능 수치는 확인되지 않았습니다. 도입 전에 저장소와 공식 사이트에서 최신 내용을 직접 확인하시기 바랍니다.