도메인 이해 (understand-domain)
코드베이스에서 비즈니스 도메인과 업무 흐름을 추출해 인터랙티브 흐름 그래프로 시각화하는 스킬.
개발·코딩중급★ 78,314⑂ 6,578AI 점수 7/10마지막 업데이트: 2026. 7. 30.
무엇을 해주나
/understand-domain은 프로젝트 소스코드를 훑어 비즈니스 도메인, 업무 흐름(flow), 처리 단계(step) 를 뽑아내고 이를 가로형 인터랙티브 그래프로 대시보드에 띄웁니다.
동작 방식은 두 갈래입니다.
- 이미
/understand로 만든 지식 그래프(.ua/knowledge-graph.json)가 있으면 그걸 재활용해 파일 스캔 없이 저렴하게 도메인을 도출합니다. - 지식 그래프가 없으면 파이썬 전처리 스크립트로 파일 트리·엔트리포인트(HTTP 라우트, CLI 명령, 이벤트 핸들러, 크론)·export/import 목록을 뽑아 경량 스캔을 수행합니다.
--full플래그를 주면 기존 그래프가 있어도 새로 스캔합니다.
또한 git worktree 감지 후 메인 저장소로 출력 경로를 되돌리고, 그래프가 오래되었는지(커밋 diff, 스테이징/워킹트리 변경) 미리 점검해 경고하는 등 실무 디테일이 촘촘합니다.
이런 분께 추천
- 처음 보는 대형 레거시 코드베이스에 투입된 신규 합류자
- 코드 구조가 아니라 "이 시스템이 어떤 업무를 처리하는지"를 문서화해야 하는 테크리드
- 기획·QA에게 시스템 흐름을 그림으로 설명해야 하는 개발자
- 모노레포에서 프로젝트별 도메인 경계를 정리하고 싶은 팀
활용 예시
- 신규 입사자 온보딩 — 이커머스 백엔드에서
/understand-domain을 실행해 "주문 생성 → 결제 승인 → 재고 차감 → 배송 생성" 흐름 그래프를 얻고, 온보딩 문서 대신 활용합니다. - 레거시 리팩터링 사전 조사 —
/understand로 지식 그래프를 만든 뒤/understand-domain을 돌려, 어느 도메인이 서로 얽혀 있는지 확인하고 분리 순서를 정합니다. - 대규모 변경 후 갱신 — 기능 추가로 흐름이 바뀌었을 때
/understand-domain --full로 강제 재스캔해 최신 도메인 그래프를 다시 생성합니다.
· · · 설치 가이드 · · ·
Claude 앱에 설치 (터미널 필요 없음)
- 아래 버튼으로 ZIP 파일을 받으세요.
- Claude 설정 → Capabilities에서 '코드 실행 및 파일 생성'을 켭니다. (한 번만)
- Claude에서 Customize → Skills → + → '스킬 업로드'를 누르고 받은 ZIP을 올립니다.
Claude Code에 설치
Claude에게 맡기기 — 아래 문장을 Claude Code에 붙여넣으세요
클로드스킬마트에서 찾은 스킬을 설치해줘. GitHub 저장소 Egonex-AI/Understand-Anything 의 understand-anything-plugin/skills/understand-domain 폴더를 내 ~/.claude/skills/understand-domain/ 에 그대로 복사해줘. 설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.
직접 명령으로 설치하기
git clone https://github.com/Egonex-AI/Understand-Anything.git ~/understand-anything && mkdir -p ~/.claude/skills && cp -r ~/understand-anything/understand-anything-plugin/skills/* ~/.claude/skills/⚠ 제3자가 만든 스킬입니다. 설치 전 원본 저장소를 한 번 확인하세요.
- 터미널을 열고 플러그인 저장소를 홈 디렉터리에 클론합니다:
git clone https://github.com/Egonex-AI/Understand-Anything.git ~/understand-anything - 스킬 디렉터리를 만듭니다:
mkdir -p ~/.claude/skills - 스킬을 복사합니다:
cp -r ~/understand-anything/understand-anything-plugin/skills/* ~/.claude/skills/ - 이 스킬은 플러그인 본체(에이전트 프롬프트, 파이썬 전처리 스크립트)에 의존하므로 클론한 폴더를 지우지 마세요. 필요하면
export CLAUDE_PLUGIN_ROOT=~/understand-anything/understand-anything-plugin을 셸 설정 파일에 추가합니다. python3 --version으로 파이썬이 설치되어 있는지 확인합니다.- 분석하려는 프로젝트 폴더에서 Claude Code를 실행하고
/understand-domain을 입력합니다. 처음이라면/understand를 먼저 돌리면 결과 품질이 더 좋아집니다. - 결과는 프로젝트 안의
.ua/domain-graph.json에 저장되며 대시보드가 자동으로 열립니다.
GitHub에서 원본 보기 ↗라이선스: MIT