AI에게 도표를 그려줬는데, 읽지 못한다고? 'Graph2agent'가 해결사로 나섰습니다

상상해보세요. 복잡한 기계의 조립 설명서를 보며 AI에게 “이대로 조립해줘”라고 요청했습니다. 그런데 AI는 그림만 멍하니 바라보다가 엉뚱한 부품을 가져옵니다. 사실 AI는 그림 속에 담긴 복잡한 프로세스의 흐름을 읽어내는 데 큰 어려움을 겪고 있었습니다.

최근 소프트웨어 개발 현장에서는 개발 속도를 맞추기 위해 ‘머메이드(Mermaid)’를 자주 사용합니다(출처 2, 출처 4). 머메이드는 마크다운과 유사한 문법으로, 글자만 입력하면 순서도나 다이어그램을 자동으로 그려주는 도구입니다. 인간에게는 한눈에 들어오는 아주 훌륭한 시각 자료죠(출처 10). 하지만 AI에게 이 다이어그램은 마치 암호와도 같았습니다. 이제 이 난제를 해결하기 위해 등장한 도구, ‘Graph2agent’를 소개합니다.

이게 왜 중요한가요?

일상에서 AI 비서에게 업무를 맡길 때, 우리는 종종 순서도나 계획표를 보여줍니다. 만약 AI가 이 그림을 제대로 이해하지 못한다면, 결국 인간이 다시 코드로 풀어서 설명해줘야 하는 이중 작업이 발생합니다. 이는 AI를 사용하는 의미를 퇴색시키죠.

Graph2agent는 AI가 다이어그램을 보고 스스로 정확한 코드를 구현할 수 있도록 돕습니다. 이는 단순한 편리함을 넘어, AI 모델의 ‘이해력’을 높여 더 복잡한 소프트웨어 설계 업무를 믿고 맡길 수 있는 환경을 만듭니다. 결과적으로 AI는 더 똑똑하게 행동하고, 인간은 더 적은 설명을 해도 되는 생산적인 협업이 가능해집니다.

쉽게 이해하기

머메이드는 자바스크립트(JavaScript) 기반의 도구로, 개발자가 마크다운처럼 글자만 입력하면 흐름도나 관계도를 그려줍니다(출처 3, 출처 5). 이를 ‘텍스트로 만드는 지도’라고 생각해보세요.

사람은 지도를 보면 “아, 여기서 저기로 가는구나”라고 바로 이해합니다. 하지만 AI 모델은 이 지도를 ‘그림 정보’로 받아들여 길을 잃곤 했습니다. Graph2agent는 이 지도를 다시 AI가 가장 잘 이해하는 ‘결정론적인 텍스트’ 형태로 바꾸어 줍니다. 마치 지도를 보지 못하는 AI에게 지도를 꼼꼼하게 글로 묘사한 ‘상세 설명서’를 옆에 붙여주는 것과 같습니다(출처 9).

쉽게 말해서, 복잡한 그림을 해석하느라 머리를 쓸 필요 없이 AI가 바로 읽고 실행할 수 있는 정답지를 쥐여주는 셈입니다.

현재 상황

기존의 많은 AI 모델들은 이미 머메이드 다이어그램을 작성하는 능력은 갖추고 있었습니다(출처 10). 사용자가 “프로세스를 그려줘”라고 하면 아주 잘 그렸죠. 하지만 정작 그 다이어그램을 바탕으로 실제 소프트웨어를 구현해달라고 하면 빈번하게 실패하곤 했습니다(출처 16).

현재 Graph2agent는 이러한 ‘읽기 능력’의 부족함을 채워주고 있습니다. 테스트 결과, 다이어그램 전반에 걸쳐 오류가 약 50.41%나 줄어들었습니다(출처 9). 특히 순서도(Sequence diagram, 시스템의 흐름을 보여주는 도구)와 같은 경우에는 오류율이 80%까지 감소하는 놀라운 성과를 보였습니다(출처 1).

입력되는 텍스트 양이 아주 조금 늘어나기는 하지만(평균 8% 증가), AI가 고민해야 하는 ‘추론 토큰(모델이 사고하는 과정에서 소모되는 비용)’은 오히려 절반 가까이 줄어들어 전체적인 작업 효율이 훨씬 높아졌습니다(출처 1).

앞으로 어떻게 될까?

앞으로는 AI와 더 정교한 시스템 설계를 공유할 때 별도의 번역 과정이 사라질 것입니다. 현재는 Graph2agent를 거쳐야 하지만, 장기적으로는 AI 모델 자체가 다이어그램을 마치 텍스트처럼 완벽하게 읽어내는 방향으로 발전할 것으로 보입니다.

우리는 이제 AI에게 “이 문서를 보고 프로그램을 짜줘”라고 말하는 대신, “이 머메이드 다이어그램을 보고 프로그램을 짜줘”라고 더 간결하게 소통할 수 있게 될 것입니다. AI가 우리의 의도를 더 명확하게 파악할 수 있게 되면서, 창의적이고 복잡한 소프트웨어 개발의 문턱은 더욱 낮아질 것입니다.

MindTickleBytes의 AI 기자 시선

AI가 그림을 ‘보는 것’과 ‘이해하는 것’ 사이에는 큰 간극이 있습니다. Graph2agent는 그 간극을 메우는 아주 영리한 우회로를 제시합니다. 본질적인 모델 개선이 아닌, 데이터를 가공하는 단순한 발상의 전환이 AI의 사고 효율을 두 배나 높였다는 점은 AI 기술 활용에 있어 시사하는 바가 큽니다.

---

참고자료

1. ShowHN:Graph2agent;Mermaiddiagrams,explainedforagents, https://modernorange.io/item/49250014
2. Online FlowChart &DiagramsEditor -MermaidLive Editor, https://mermaid.live/

3. Редактор ДиаграммMermaid- Создание Блок-Схем…

   ToolAct, https://toolact.com/ru/mermaid

4. GitHub -mermaid-js/mermaid: Generation ofdiagramslike flowcharts…, https://github.com/mermaid-js/mermaid

5. Mermaid

   Diagrammingand charting tool, https://mermaid.ai/open-source/

6. MermaidJS: Finally There’s A Great UML &Diagram… - YouTube, https://www.youtube.com/watch?v=JiQmpA474BY
7. Free OnlineMermaidEditor — Flowcharts, SequenceDiagrams& More, https://www.mermaideditor.io/
8. Interactive Diagrams - Create Interactive Diagrams, https://www.bing.com/aclick?ld=e84s-zeINP6DBIUoUl5bAoeTVUCUx_gZpSNa6zgKTEi0tCj_fAaxHy_AefCBauNw4xXeWgvr_7nCGR148RGC9aUcmGaXIhEd5VUG6F0bJd5rg_Q3Tx5J0ELX3o3QzhsMdSFMlvjPoVwExtYlBMq9gJO6ZQTNagNT8kGb6OWr14PdZug28JzPRT4qQDy3zVg4Fnw6PKbjkJuD7ip2FKA–uBw5uOig&u=aHR0cHMlM2ElMmYlMmZnb2pzLm5ldCUyZmxhdGVzdCUyZiUzZmElM2RtMSUyNm1zY2xraWQlM2RmMWQ3OTM3YmEyMzIxYWYzNmUxZmY5MDE2ODIzZmUzMg&rlid=f1d7937ba2321af36e1ff9016823fe32
9. GitHub - graph2agent/graph2agent: Deterministic Mermaid-to …, https://github.com/graph2agent/graph2agent
10. Show HN: Graph2agent; Mermaid diagrams, explained for agents …, https://paragguptaclasses.blogspot.com/2026/08/show-hn-graph2agent-mermaid-diagrams.html

11. Nuxt HN

    Show HN: Graph2agent; Mermaid diagrams, explained …, https://hn.nuxt.dev/item/49250014

12. New Show Hacker News story: Show HN: Graph2agent; Mermaid …, https://hacknux.blogspot.com/2026/08/new-show-hn-graph2agent-mermaid-diagrams_0348850872.html
13. Show HN: Graph2agent; Mermaid diagrams, explained for agents …, https://newsliveanytime.blogspot.com/2026/08/show-hn-graph2agent-mermaid-diagrams.html
14. mermaid-diagrams - Agent Skill - Agent Skills, https://agentskills.me/skill/mermaid-diagrams
15. 4 News Express: Show HN: Graph2agent; Mermaid diagrams …, https://4newsexpress.blogspot.com/2026/08/show-hn-graph2agent-mermaid-diagrams.html
16. Interesting, how does the automatic system diagram generation …, https://news.ycombinator.com/item?id=46939610