/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줄 미만 유지.