최근 대규모 언어모델(LLM)은 복잡한 시스템의 아키텍처 다이어그램을 텍스트 대신 시각적으로 생성하는 데 활용되고 있습니다. 하지만 이렇게 AI가 그린 다이어그램은 시각적으로 그럴듯해 보여도 실제 코드와는 다른 경우가 많아 개발자들의 혼란을 야기할 수 있습니다. 이러한 문제를 해결하기 위해 '애로우프루프(Arrowproof)'라는 새로운 도구가 등장했습니다. 애로우프루프는 LLM이 생성한 아키텍처 다이어그램이 실제 코드의 임포트(import) 관계와 일치하는지 자동으로 검증해주는 에이전트 스킬(agent skill)입니다.
애로우프루프는 Excalidraw 형식의 다이어그램을 입력받아, 다이어그램 내의 모든 상자(box)와 화살표(arrow)를 코드 저장소의 실제 임포트 그래프와 비교합니다. 예를 들어, 다이어그램에서 'A' 상자가 'B' 상자를 가리키는 화살표가 있다면, 애로우프루프는 'A'에 해당하는 코드에서 'B'에 해당하는 코드를 실제로 임포트하는지 확인합니다. 검증 결과는 '✓ 확인됨', '↝ 간접적', '⇄ 역방향', '✗ 코드에 없음' 등으로 상세하게 표시되며, 각 화살표 뒤에 숨겨진 실제 임포트 라인까지 HTML 보고서로 제공합니다. 또한, 다이어그램에 누락된 코드 간의 임포트 관계도 찾아내고, CI/CD 파이프라인에 통합하여 문서와 코드의 불일치를 지속적으로 감지할 수 있습니다. 현재 파이썬(Python)과 자바스크립트/타입스크립트(JavaScript/TypeScript)를 지원하며, 별도 설치 없이 에이전트 스킬이나 스크립트 실행을 통해 사용할 수 있습니다.
이 도구는 LLM이 생성한 아키텍처 다이어그램의 신뢰성을 크게 높여준다는 점에서 중요합니다. 개발자들은 AI가 제시하는 시각적 정보가 실제 코드 베이스를 정확하게 반영하는지 즉시 확인할 수 있게 되어, 잘못된 정보로 인한 설계 오류나 개발 혼란을 줄일 수 있습니다. 특히, 복잡한 프로젝트에서 코드와 문서의 동기화를 유지하는 것은 항상 어려운 과제였는데, 애로우프루프는 이를 자동화하여 개발 생산성을 향상시키고 문서의 정확성을 보장하는 데 기여할 것입니다. 이는 AI 기반 개발 도구의 실용성을 한 단계 끌어올리는 중요한 진전으로 평가됩니다.