/update-codemaps (코드맵)

다운로드 후 ~/.claude/commands/ 폴더에 복사하여 사용하세요

코드베이스 구조를 분석하고 아키텍처 문서 업데이트.

🗺️

doc-updater 에이전트를 호출하여 코드맵을 업데이트합니다.

이 커맨드가 하는 일

모든 소스 파일의 임포트, 익스포트, 의존성 스캔
다음 형식으로 토큰 효율적인 코드맵 생성:
- codemaps/architecture.md - 전체 아키텍처
- codemaps/backend.md - 백엔드 구조
- codemaps/frontend.md - 프론트엔드 구조
- codemaps/data.md - 데이터 모델 및 스키마
이전 버전과의 차이 비율 계산
변경이 30% 초과 시 업데이트 전 사용자 승인 요청
각 코드맵에 최신 타임스탬프 추가
.reports/codemap-diff.txt에 리포트 저장

코드맵 구조


codemaps/
├── architecture.md    # 전체 시스템 아키텍처
├── backend.md         # 백엔드 구조
├── frontend.md        # 프론트엔드 구조
└── data.md           # 데이터 모델

코드맵 형식


# [영역] 코드맵
 
**마지막 업데이트:** 2025-01-21
**진입점:** src/app/page.tsx
 
## 아키텍처
 
┌─────────────┐     ┌─────────────┐
│   Frontend  │────▶│   Backend   │
└─────────────┘     └─────────────┘
                           │
                    ┌──────▼──────┐
                    │   Database  │
                    └─────────────┘
 
## 주요 모듈
 
| 모듈 | 목적 | 의존성 |
|------|------|--------|
| api/ | API 라우트 | supabase |
| components/ | UI 컴포넌트 | react |
 
## 데이터 흐름
 
1. 사용자 요청 → API 라우트
2. API → 데이터베이스 쿼리
3. 응답 → 클라이언트

사용 예시


# 코드맵 업데이트
/update-codemaps
 
# 출력 예시
## 코드맵 업데이트
 
### 분석 결과
- 스캔된 파일: 150
- 모듈: 25
- 의존성: 45
 
### 변경 사항
- architecture.md: 15% 변경
- backend.md: 8% 변경
- frontend.md: 22% 변경
- data.md: 5% 변경
 
### 생성된 파일
- codemaps/architecture.md ✅
- codemaps/backend.md ✅
- codemaps/frontend.md ✅
- codemaps/data.md ✅
 
최신 타임스탬프 추가됨.

분석 도구


# 의존성 그래프 생성
npx madge --image graph.svg src/
 
# TypeScript 구조 분석
npx ts-morph

💡

원칙: 구현 세부사항이 아닌 고수준 구조에 집중. 각 코드맵은 500줄 미만 유지.