리팩토링문서화데이터·SQLby affaan-m

코드맵 업데이트하기

프로젝트 구조를 스캔하고 토큰-_Lean 아키텍처 코드맵을 생성합니다.

한 줄 평가 — 다음 사람 도와주세요

언제 쓰나

프로젝트 구조가 변경되었거나 코드맵을 최신 상태로 유지할 때 사용합니다.

SKILL.md

Lattice 한국어 번역 · 원본 affaan-m/everything-claude-code (841beea). 복사 → 저장하면 Claude Code가 인식합니다.

--- description: 프로젝트 구조를 스캔하고 토큰 효율적인 아키텍처 코드맵을 생성합니다. --- # 코드맵 업데이트 코드베이스 구조를 분석하고 토큰 효율적인 아키텍처 문서를 생성합니다. ## 단계 1: 프로젝트 구조 스캔 1. 프로젝트 유형을 식별합니다 (모노레포, 단일 앱, 라이브러리, 마이크로서비스). 2. 모든 소스 디렉토리를 찾습니다 (src/, lib/, app/, packages/). 3. 진입점을 매핑합니다 (main.ts, index.ts, app.py, main.go 등). ## 단계 2: 코드맵 생성 `docs/CODEMAPS/` (또는 `.reports/codemaps/`)에 코드맵을 생성하거나 업데이트합니다: | 파일 | 내용 | |------|----------| | `architecture.md` | 최상위 시스템 다이어그램, 서비스 경계, 데이터 흐름 | | `backend.md` | API 라우트, 미들웨어 체인, 서비스 → 리포지토리 매핑 | | `frontend.md` | 페이지 트리, 컴포넌트 계층 구조, 상태 관리 흐름 | | `data.md` | 데이터베이스 테이블, 관계, 마이그레이션 기록 | | `dependencies.md` | 외부 서비스, 서드파티 통합, 공유 라이브러리 | ### 코드맵 형식 각 코드맵은 토큰 효율적이어야 합니다 — AI 컨텍스트 소비에 최적화됩니다: ```markdown # Backend Architecture ## Routes POST /api/users → UserController.create → UserService.create → UserRepo.insert GET /api/users/:id → UserController.get → UserService.findById → UserRepo.findById ## Key Files src/services/user.ts (business logic, 120 lines) src/repos/user.ts (database access, 80 lines) ## Dependencies - PostgreSQL (primary data store) - Redis (session cache, rate limiting) - Stripe (payment processing) ``` ## 단계 3: 차이 감지 1. 이전 코드맵이 존재하면, 차이 비율을 계산합니다. 2. 변경 사항이 30%를 초과하면, 덮어쓰기 전에 변경 사항을 표시하고 사용자 승인을 요청합니다. 3. 변경 사항이 30% 이하이면, 해당 위치에 업데이트합니다. ## 단계 4: 메타데이터 추가 각 코드맵에 신선도 헤더를 추가합니다: ```markdown  ``` ## 단계 5: 분석 보고서 저장 `.reports/codemap-diff.txt`에 요약을 작성합니다: - 마지막 스캔 이후 추가/제거/수정된 파일 - 새로 감지된 종속성 - 아키텍처 변경 사항 (새 라우트, 새 서비스 등) - 90일 이상 업데이트되지 않은 문서에 대한 최신성 경고 ## 팁 - 구현 세부 사항이 아닌, **최상위 구조**에 집중합니다. - 전체 코드 블록 대신 **파일 경로와 함수 서명**을 우선합니다. - 효율적인 컨텍스트 로딩을 위해 각 코드맵을 **1000 토큰 미만**으로 유지합니다. - 설명이 장황한 대신 데이터 흐름에 ASCII 다이어그램을 사용합니다. - 주요 기능 추가 또는 리팩토링 세션 후에 실행합니다.

코드맵 업데이트하기

언제 쓰나

SKILL.md

필요한 도구

설치 + 호출 (2단계)

SKILL.md 저장

호출