AI로 아키텍처 다이어그램 그리기

카테고리

프로그래밍/소프트웨어 개발

서브카테고리

개발 툴

대상자

• 개발자, 팀 리더, 아키텍처 설계자
• 중급 이상의 기술 이해도를 가진 사람 (도구 사용 및 문서화 기술 필요)

핵심 요약

• 문서화는 협업과 프로젝트 지속성의 핵심 (코드만으로는 아이디어의 의도를 공유하기 어려움)
• Mermaid + Markdown으로 간단한 다이어그램 생성 가능 (예: graph TD 구문 활용)
• Draw.io의 .drawio 파일 포맷을 AI에게 직접 지시하여 복잡한 다이어그램 생성 가능 (AWS 아이콘 ID 추출 필수)

섹션별 세부 요약

1. 문서화의 중요성

• 코드만으로는 협업 시 의도 전달이 어려움 (예: "지도 없이 여행" 비유)
• 문서화는 아키텍처 설계 의도와 프로젝트 방향성 명확화에 기여
• 지속 가능한 개발 환경 구축을 위한 필수 요소

2. Mermaid & Markdown 활용

• Mermaid는 간단한 다이어그램 생성 가능 (예: graph TD 구문)
• VS Code의 drawio 확장 기능으로 다이어그램 미리 보기 및 수정 가능
• Mermaid 최신 버전은 AWS 아이콘 기본 지원 (GitHub 지원 미비)

3. Draw.io의 AWS 아이콘 처리

• AI에게 .drawio 파일 생성 시 AWS 아이콘 ID 직접 추출 및 문서화 필요
• CLI 도구로 SVG/PNG 이미지 컨버트 가능 (예: drawio --export image.png)
• GitHub에서 Mermaid의 최신 기능 지원 미비 → 현재 추천 접근법

4. 실무 적용 팁

• Mermaid + Markdown으로 빠른 의사소통 가능
• Draw.io 사용 시 AWS 아이콘 ID 별도 문서화 필수
• CLI 도구 활용하여 이미지 삽입 및 수정 가능

결론

• 문서화는 선택이 아닌 필수 (협업의 질과 프로젝트 지속성에 직접 영향)
• Mermaid + Markdown으로 간단한 다이어그램 생성, 복잡한 경우 Draw.io 사용 (AWS 아이콘 ID 문서화 필수)
• GitHub의 Mermaid 지원 미비 → 현재는 Draw.io 기반 접근법이 실용적