지난 글에서 Understand-Anything으로 코드베이스를 지식 그래프로 만드는 걸 소개했다. 그런데 한 가지 짚고 넘어갈 게 있다. “모듈 의존성 그래프? 그건 그냥 디렉토리 열면 보이잖아.” 맞는 말이다. 폴더 구조와 import 관계는 와 만 봐도 대충 안다. 그래서 이번엔 도구의 진짜 값어치, 즉 “이 코드가 실제로 무슨 일을 하는가“를 끌어내는 데 집중했다. 대상은 모두가 아는 Redux 코어다. 디렉토리 뷰 vs 로직 뷰 Redux 코어()는 17개 파일, 핵심은 10개 남짓이다. 디렉토리를 열면 이렇게 보인다. 여기서 알 수 있는 건 **“파일이 있다”**는 것뿐이다. 가 를 쓴다는 것까지는 import로 보이지만 — **“미들웨어가 대체 어떻게 dispatch를 가로채는가”**는 0% 안 보인다. 그게 로직이다. 로 분석하면 각 노드에 plain-English 요약과 관계가 붙는다. 예를 들어 노드를 누르면 이런 설명이 나온다. “함수 우→좌 합성. 로 생성…

지난 글에서 Understand-Anything으로 코드베이스를 지식 그래프로 시각화하는 방법을 다뤘다. 그런데 이 도구에는 코드 분석 말고도 흥미로운 기능이 하나 더 있다. 바로 다. 이 명령어는 마크다운 위키(지식 베이스)를 분석한다. 그리고 그 감지 조건이 사실상 Obsidian 볼트 구조와 동일하다. 즉, 내가 몇 년간 쌓아온 Obsidian 노트를 그대로 지식 그래프로 만들 수 있다는 뜻이다. Obsidian 그래프 뷰의 한계 Obsidian에는 이미 그래프 뷰가 있다. 노트들이 점으로 표시되고 로 연결된다. 처음 보면 멋있다. 그런데 노트가 수백 개 쌓이면 이렇게 된다. 점이 너무 많아 **그냥 털뭉치(hairball)**가 된다 노드를 클릭해도 보이는 건 파일명뿐 명시적으로 를 건 연결만 보인다 — 내용상 관련 있지만 링크를 안 단 노트는 따로 논다 “이 주제 노트들이 실제로 어떤 흐름으로 연결되는가”는 알 수 없다 결국 그래프 뷰는 “예쁜 시각화”에 머무는 경우가 많…

Claude가 단순한 챗봇이 아니라 도메인 전문가처럼 동작하게 만들 수 있다. Claude Skills를 사용하면 된다. Claude Skills란? Claude Skills는 Anthropic의 Claude AI에 특정 능력을 부여하는 확장 모듈이다. 각 스킬은 폴더 단위로 구성되며, 내부에는 다음이 포함된다: - 스킬 설명 및 트리거 조건 관련 코드 및 스크립트 참조 문서 및 예시 핵심은 **지연 로드(Lazy Loading)**다. 수백 개의 스킬을 등록해도 필요한 스킬만 불러오기 때문에 토큰 낭비가 없다. 왜 Skills인가? 기존 프롬프트 엔지니어링의 한계: 기존 방식 Claude Skills 매번 긴 시스템 프롬프트 작성 스킬 이름만 호출 컨텍스트 윈도우 낭비 필요한 스킬만 로드 재사용 어려움 폴더 복사로 공유 일관성 유지 힘듦 버전 관리 가능 실제 사용 예시: Awesome Claude Skills 저장소 VoltAgent/awesome-claude-skills는 A…

레거시 코드 파악, 왜 어려운가 대규모 코드베이스에 새로 투입되면 흔히 겪는 상황이 있다. README는 몇 년 전 업데이트가 마지막 아키텍처 다이어그램이 현재 코드와 맞지 않음 작성자가 퇴사해서 물어볼 사람이 없음 기존 방식으로는 한계가 있다: → 수백 개 파일 매칭, 어디서 시작해야 할지 모름 IDE의 Go to Definition → 10번 점프하면 원래 뭘 찾던 건지 잊음 선배에게 질문 → “그건 레거시라 나도 잘 몰라” Understand Anything은 이 문제를 해결하는 Claude Code 플러그인이다. 코드베이스 전체를 분석해서 인터랙티브한 지식 그래프로 변환한다. 실제 대시보드 코드베이스가 클릭 가능한 그래프로 변환된다: 각 노드 = 파일, 함수, 클래스 색상 = 아키텍처 레이어 (API, Service, Data, UI, Utility) 연결선 = 의존성 관계 노드 클릭 시 = 코드 + AI 생성 설명 표시 기존 방식과 비교 기존 방식 Understand …