AI 코딩 도구로 복잡한 코드베이스를 탐색 가능한 아키텍처 맵으로 변환하는 저장소
요약
이 저장소는 AI 코딩 도구를 활용하여 복잡한 코드베이스를 구조적이고 탐색 가능한 아키텍처 맵으로 자동 변환하는 방법을 제시합니다. 'oh-my-mermaid (omm)'라는 스킬을 통해 시스템의 구조, 데이터 흐름, 외부 통합 등을 Mermaid 다이어그램으로 분해하고 시각화할 수 있습니다.
핵심 포인트
- AI 코딩 도구로 코드베이스를 아키텍처 맵으로 변환
- oh-my-mermaid (omm)는 /omm-scan 스킬을 통해 작동
- 시스템 구조, 데이터 흐름 등 관점별 다이어그램 생성
- 재귀적(recursive) 분석으로 복잡한 부분까지 깊이 탐색 가능
🚨 이 저장소는 어떤 지저분한(messy) 코드베이스든 AI 코딩 도구가 생성한 탐색 가능한 아키텍처 맵으로 변환합니다. GitHub에서 2.3k 스타를 기록하며 트렌드입니다.
아무도 이야기하지 않는 문제가 있습니다. AI가 몇 초 만에 코드를 작성합니다. 당신은 그것을 이해하는 데 몇 시간을 소비합니다. 그 이해 과정을 건너뛰면, 당신 자신의 코드베이스는 블랙박스가 됩니다.
oh-my-mermaid (omm)가 이 간극을 메웁니다. AI가 생성하고 인간을 위해 구축된 아키텍처 문서입니다.
작동 방식:
» 저장소를 가리킨 후, 사용 중인 AI 도구 내에서 하나의 스킬을 실행합니다: /omm-scan
» 당신의 AI는 시스템을 관점별로 분해합니다. 구조(Structure), 데이터 흐름(data flow), 외부 통합(external integrations) 등 각각을 자체 Mermaid 다이어그램으로 만듭니다.
» 재귀적(recursive)으로 작동합니다. 복잡한 부분은 자체 중첩된 다이어그램으로 확장됩니다. 단순한 부분은 단일 노드로 유지됩니다. 필요한 만큼 깊이 파고들 수 있습니다.
» omm view를 실행하여 전체 내용을 인터랙티브 뷰어에서 탐색합니다.
확인할 가치가 있는 이유:
» 이미 사용하고 있는 도구 내에서 작동합니다. Claude Code, Codex, Cursor, OpenClaw, Antigravity 등.
» 설치는 하나의 명령으로, 실행은 하나의 스킬로 끝납니다. 수동 다이어그램 작업이 필요 없습니다.
» 무료이며 MIT 라이선스를 따릅니다. 팀과 맵을 공유하고 싶다면 선택적으로 클라우드를 사용할 수 있으며, 기본값은 비공개입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 X AI 사용법/팁의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기