mirror of
https://github.com/affaan-m/everything-claude-code.git
synced 2026-04-01 22:53:27 +08:00
- commands: 18 files (build-fix, checkpoint, code-review, e2e, eval, go-build, go-review, go-test, learn, orchestrate, plan, refactor-clean, setup-pm, tdd, test-coverage, update-codemaps, update-docs, verify) - agents: 12 files (architect, build-error-resolver, code-reviewer, database-reviewer, doc-updater, e2e-runner, go-build-resolver, go-reviewer, planner, refactor-cleaner, security-reviewer, tdd-guide)
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# 코드맵 업데이트
|
|
|
|
코드베이스 구조를 분석하고 토큰 효율적인 아키텍처 문서를 생성합니다.
|
|
|
|
## 1단계: 프로젝트 구조 스캔
|
|
|
|
1. 프로젝트 유형 식별 (모노레포, 단일 앱, 라이브러리, 마이크로서비스)
|
|
2. 모든 소스 디렉토리 찾기 (src/, lib/, app/, packages/)
|
|
3. 엔트리 포인트 매핑 (main.ts, index.ts, app.py, main.go 등)
|
|
|
|
## 2단계: 코드맵 생성
|
|
|
|
`docs/CODEMAPS/`에 코드맵 생성 또는 업데이트:
|
|
|
|
| 파일 | 내용 |
|
|
|------|------|
|
|
| `architecture.md` | 상위 시스템 다이어그램, 서비스 경계, 데이터 흐름 |
|
|
| `backend.md` | API 라우트, 미들웨어 체인, 서비스 → 리포지토리 매핑 |
|
|
| `frontend.md` | 페이지 트리, 컴포넌트 계층, 상태 관리 흐름 |
|
|
| `data.md` | 데이터베이스 테이블, 관계, 마이그레이션 히스토리 |
|
|
| `dependencies.md` | 외부 서비스, 서드파티 통합, 공유 라이브러리 |
|
|
|
|
## 팁
|
|
|
|
- **구현 세부사항이 아닌 상위 구조**에 집중
|
|
- 전체 코드 블록 대신 **파일 경로와 함수 시그니처** 사용
|
|
- 효율적인 컨텍스트 로딩을 위해 각 코드맵을 **1000 토큰 미만**으로 유지
|
|
- 장황한 설명 대신 데이터 흐름에 ASCII 다이어그램 사용
|
|
- 주요 기능 추가 또는 리팩토링 세션 후 실행
|