Analyze Dependencies

---
description: "프로젝트 의존성을 분석하고 아키텍처 건전성을 평가한다. 「의존성 분석해줘」「순환 의존 검출해줘」「아키텍처 문제는?」「모듈 결합도 확인」「레이어 위반 찾아줘」등으로 기동."
allowed-tools:
  - Read
  - Grep
  - Glob
---

# 프로젝트 의존성을 분석하고 아키텍처 건전성을 평가한다

프로젝트의 의존관계를 분석하고 아키텍처 건전성을 평가합니다.

## 사용법

```bash
/dependency-analysis [옵션]
```

## 옵션

- `--visual` : 의존관계를 시각적으로 표시
- `--circular` : 순환 의존만 감지
- `--depth <숫자>` : 분석 깊이 지정(기본값: 3)
- `--focus <경로>` : 특정 모듈/디렉토리에 집중

## 기본 예제

```bash
# 프로젝트 전체 의존관계 분석
/dependency-analysis

# 순환 의존 감지
/dependency-analysis --circular

# 특정 모듈의 상세 분석
/dependency-analysis --focus src/core --depth 5
```

## 분석 항목

### 1. 의존관계 매트릭스

모듈 간 의존관계를 수치화해서 표시：

- 직접 의존
- 간접 의존
- 의존 깊이
- 팬인/팬아웃

### 2. 아키텍처 위반 감지

- 레이어 위반(하위층이 상위층에 의존)
- 순환 의존
- 과도한 결합(높은 의존도)
- 고립된 모듈

### 3. Clean Architecture 준수 체크

- 도메인 층의 독립성
- 인프라 층의 적절한 분리
- 유스케이스 층의 의존 방향
- 인터페이스 적용 상황

## 출력 예시

```text
의존관계 분석 리포트
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📊 지표 개요
├─ 총 모듈 수: 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 아트로 표시]
```

## 고급 사용 예시

```bash
# CI/CD 파이프라인에서 자동 체크
/dependency-analysis --circular --fail-on-violation

# 아키텍처 규칙 정의와 검증
/dependency-analysis --rules .architecture-rules.yml

# 시계열로 의존관계 변화 추적
/dependency-analysis --compare HEAD~10
```

## 설정 파일 예시 (.dependency-analysis.yml)

```yaml
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` : 복잡도와 의존관계 통합 분석

## Claude 와의 연계

```bash
# package.json 을 포함한 분석
cat package.json
/analyze-dependencies
"이 프로젝트의 의존관계 문제점을 분석해줘"

# 특정 모듈의 소스 코드와 조합
ls -la src/core/
/analyze-dependencies --focus src/core
"코어 모듈의 의존관계를 상세히 평가해줘"

# 아키텍처 문서와의 비교
cat docs/architecture.md
/analyze-dependencies --visual
"설계 문서와 구현의 차이를 확인해줘"
```

## 주의사항

- **전제조건**: 프로젝트 루트에서 실행 필요
- **제한사항**: 대규모 프로젝트는 분석에 시간이 걸릴 수 있습니다
- **권장사항**: 순환 의존이 발견되면 즉시 대처를 검토하세요

## 베스트 프랙티스

1. **정기적 분석**: 주간 단위로 의존관계 건전성 체크
2. **규칙 명문화**: 아키텍처 규칙을 설정 파일로 관리
3. **단계적 개선**: 대규모 리팩터링을 피하고 점진적으로 개선
4. **지표 추적**: 의존관계 복잡도를 시계열로 모니터링