Whiteboard: 에이전트 기반 소프트웨어 설계를 위한 오픈 소스 IDE

Whiteboard는 인간과 AI 에이전트 간의 협업 소프트웨어 아키텍처를 지원합니다

Whiteboard는 텍스트 기반 프롬프트와 단순한 diff를 넘어 소프트웨어 설계를 발전시키기 위해 설계된 오픈 소스 데스크톱 애플리케이션입니다. 이 도구는 인간과 AI 에이전트가 시각적 캔버스를 사용하여 시스템 레이아웃, 흐름, 로직을 설명하며 함께 소프트웨어를 설계할 수 있는 공통 작업 공간을 제공합니다. Claude Code나 Codex와 같은 기존 코딩 에이전트와 연동되는 Whiteboard는 에이전트가 앱 내 캔버스에 직접 그릴 수 있는 SDK를 제공하여, 구현 전이나 구현 중에 제안된 변경 사항을 시각화할 수 있도록 합니다.

주요 기술적 특징

코드와 연결된 다이어그램

Whiteboard는 아키텍처 사양과 실제 구현 사이의 단절 문제를 해결합니다. 이 작업 공간에서는 시퀀스 다이어그램이나 개체 관계 다이어그램과 같은 시각화 요소가 기본 코드베이스와 의미론적으로 연결됩니다. 사용자는 시각화 요소나 에이전트 추적의 인용문을 클릭하여 해당 코드로 직접 이동할 수 있습니다. 고품질 편집 경험을 유지하기 위해 Whiteboard는 Code OSS를 기반으로 하며, VS Code의 키 바인딩과 LSP 지원을 기본적으로 제공합니다.

AST 인식 의미론적 Diff 뷰어

기존의 줄 단위 diff와 관련된 노이즈를 줄이기 위해, Whiteboard는 Rust로 작성된 의미론적 diff 뷰어를 구현했습니다. 이 뷰어는 AST(추상 구문 트리)를 인식하므로 단순히 텍스트가 아닌 코드의 구조를 이해합니다. 기본적으로 이 도구는 대규모로 추가된 함수를 의사 코드로 요약하고 문서화나 단위 테스트와 같은 비필수적인 변경 사항을 축소하여, 검토자가 중요한 로직에 집중할 수 있도록 돕습니다.

에이전트 의사결정 로그

Whiteboard에는 에이전트가 자신의 추적을 쿼리하고 연결할 수 있는 도구가 포함되어 있습니다. 이는 인간이 설정한 요구 사항을 시각화하고 구현 과정에서 에이전트가 내린 자율적인 결정을 이해할 수 있게 하는 의사결정 로그를 생성하여, 에이전트 코딩의 '블랙박스' 특성을 줄여줍니다.

운영 세부 정보 및 제한 사항

로컬 우선 아키텍처 및 개인정보 보호

Whiteboard는 MIT 라이선스를 따르며 로컬에 체크아웃된 코드에서 작동합니다. 프로젝트의 개인정보 보호 정책에 따라 익명 텔레메트리에는 코드, diff, Whiteboard 텍스트, 프롬프트 또는 모델 출력이 포함되지 않습니다.

현재 제한 사항

• 파일 편집 불가: 현재 사용자는 Whiteboard 내에서 직접 파일을 편집할 수 없으며, 주로 검토 및 설계 도구로 기능합니다.
• 단일 저장소 중심: 단일 검토에서 여러 저장소의 파일을 탐색하는 기능은 현재 지원되지 않습니다.
• 정적 공유 검토: 검토 내용을 기기 간에 공유할 수는 있지만, 초기 공유 이후에 이루어진 업데이트는 자동으로 동기화되지 않습니다.

커뮤니티 피드백 및 분석

Hacker News의 커뮤니티 토론에서는 인지 부하를 줄일 수 있는 잠재력과 개발 수명 주기 내에서 이 도구가 차지하는 위치에 대한 우려가 동시에 제기되었습니다.

가치 제안

많은 사용자가 복잡한 시스템을 이해하는 데 긴 추적이나 계획을 읽는 것보다 시각적 기억이 더 효율적이라고 언급했습니다. 한 사용자는 기업 환경에서의 유용성을 강조했습니다:

"저는 코딩 에이전트를 사용하고 있고, 이것은 시각화를 위한 '플러그인'입니다... 저에게는 시도하지 않을 이유가 없습니다!" — @handle

비판적 반론

• "IDE" 정의: 여러 사용자가 현재 파일 편집 기능이 없다는 점을 들어 "IDE"라는 용어 사용에 의문을 제기했습니다.
• 진실의 원천 분기: 프로젝트가 발전함에 따라 다이어그램이 실제 코드와 달라지는 "N+1번째 진실의 원천"이 될 수 있다는 우려가 일반적입니다.
• 플랫폼 가용성: 현재 릴리스는 macOS에 집중되어 있어 Windows 및 Linux 버전에 대한 요구가 상당합니다.
• 정확성 우려: 일부 사용자는 LLM이 생성한 다이어그램의 정확성에 대해 회의적인 반응을 보였으며, 시각적 흐름에서의 환각(hallucination)이 개발 시간을 낭비하게 만들 수 있다고 지적했습니다.

기존 워크플로우와의 통합

일부 개발자들은 이 도구의 범위가 좁다고 주장하며, 독립형 제품보다는 (GUI가 포함된 MCP와 같은) 기능으로 존재하거나, 이미 Markdown 파일 내의 Mermaid.js와 같은 기존 도구들이 에이전트 생성 다이어그램에 대한 요구를 충족하고 있다고 제안했습니다.