프로젝트의 의존관계를 분석하고 아키텍처 건전성을 평가합니다.
Analyzes project dependencies and evaluates architecture health for violations.
/plugin marketplace add wasabeef/claude-code-cookbook/plugin install cook-ko@claude-code-cookbook프로젝트의 의존관계를 분석하고 아키텍처 건전성을 평가합니다.
/dependency-analysis [옵션]
--visual : 의존관계를 시각적으로 표시--circular : 순환 의존만 감지--depth <숫자> : 분석 깊이 지정(기본값: 3)--focus <경로> : 특정 모듈/디렉토리에 집중# 프로젝트 전체 의존관계 분석
/dependency-analysis
# 순환 의존 감지
/dependency-analysis --circular
# 특정 모듈의 상세 분석
/dependency-analysis --focus src/core --depth 5
모듈 간 의존관계를 수치화해서 표시:
의존관계 분석 리포트
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📊 지표 개요
├─ 총 모듈 수: 42
├─ 평균 의존 수: 3.2
├─ 최대 의존 깊이: 5
└─ 순환 의존: 2 건 감지
⚠️ 아키텍처 위반
├─ [HIGH] src/domain/user.js → src/infra/database.js
│ └─ 도메인 층이 인프라 층에 직접 의존
├─ [MED] src/api/auth.js ⟲ src/services/user.js
│ └─ 순환 의존 감지됨
└─ [LOW] src/utils/helper.js → 12 modules
└─ 과도한 팬아웃
✅ 권장 액션
1. UserRepository 인터페이스 도입
2. 인증 서비스의 책임 재설계
3. 헬퍼 함수를 기능별로 분할
📈 의존관계 그래프
[시각적 의존관계 다이어그램을 ASCII 아트로 표시]
# CI/CD 파이프라인에서 자동 체크
/dependency-analysis --circular --fail-on-violation
# 아키텍처 규칙 정의와 검증
/dependency-analysis --rules .architecture-rules.yml
# 시계열로 의존관계 변화 추적
/dependency-analysis --compare HEAD~10
rules:
- name: "Domain Independence"
source: "src/domain/**"
forbidden: ["src/infra/**", "src/api/**"]
- name: "API Layer Dependencies"
source: "src/api/**"
allowed: ["src/domain/**", "src/application/**"]
forbidden: ["src/infra/**"]
thresholds:
max_dependencies: 8
max_depth: 4
coupling_threshold: 0.7
ignore:
- "**/test/**"
- "**/mocks/**"
madge : JavaScript/TypeScript 의존관계 시각화dep-cruiser : 의존관계 규칙 검증nx : 모노레포 의존관계 관리plato : 복잡도와 의존관계 통합 분석# package.json 을 포함한 분석
cat package.json
/analyze-dependencies
"이 프로젝트의 의존관계 문제점을 분석해줘"
# 특정 모듈의 소스 코드와 조합
ls -la src/core/
/analyze-dependencies --focus src/core
"코어 모듈의 의존관계를 상세히 평가해줘"
# 아키텍처 문서와의 비교
cat docs/architecture.md
/analyze-dependencies --visual
"설계 문서와 구현의 차이를 확인해줘"