sync-claude-mdlisted

# CLAUDE.md 동기화 워크플로우 3개 소스(프로젝트 스캔 → 대화 컨텍스트 → git delta)를 종합하여 프로젝트 CLAUDE.md를 생성/업데이트한다. --- ## 메모리 계층 이해 이 스킬은 **프로젝트 루트 `CLAUDE.md`** (단일 파일)만 관리한다. | 타입 | 위치 | 로딩 | 이 스킬 관리 | |------|------|------|:----------:| | Project memory | `./CLAUDE.md` | 세션 시작 시 전체 로드 | **O** | | Project local | `./CLAUDE.local.md` | 세션 시작 시 전체 로드 (gitignore) | X | | Project rules | `./.claude/rules/*.md` | 세션 시작 시 전체 로드 | X | | User memory | `~/.claude/CLAUDE.md` | 세션 시작 시 전체 로드 | X | | Auto memory | `~/.claude/projects/.../memory/` | MEMORY.md 200줄만 로드 | X | **CLAUDE.md에 넣을 것:** 빌드 명령어, 기술 스택, 프로젝트 구조, 코딩 컨벤션, 아키텍처 결정, 제약/주의사항, 워크플로우 **넣지 말 것:** 개인 선호 (`CLAUDE.local.md` 사��), API 키/시크릿, 임시 메모, 미검증 추측 > 참고: `@path/to/file` 문법으로 다른 파일을 import 가능 (최대 5단계). 300줄 초과 시 별도 .md로 분리 후 import하는 방법도 고려. --- ## Phase 1: 프로젝트 스캔 (뼈대) 코드베이스에서 **검증 가능한 사실**을 수집한다. 아래를 **병렬로** 실행. ### 1-1. 기술 스택 추출 ``` Read: package.json → dependencies, devDependencies, scripts Read: tsconfig.json → target, strict, paths Read: next.config.ts (또는 .js/.mjs) → 주요 설정 Read: tailwind.config.* → 테마 커스터마이즈 여부 Read: eslint.config.* → 주요 플러그인, 커스텀 규칙 ``` 추출 항목: - 프레임워크 + 버전 (package.json의 dependencies) - 빌드/개발/테스트 스크립트 (package.json의 scripts) - TypeScript 설정 핵심 (strict, paths, target) - ESLint 커스텀 규칙 (기본 preset과 다른 것만) ### 1-2. 프로젝트 구조 파악 ```bash # 1단계 디렉토리 ls src/ # 주요 하위 디렉토리 (존재하는 것만) ls src/app/ src/components/ src/lib/ 2>/dev/null ``` Glob으로 패턴 파악: ``` Glob: src/app/**/route.ts → API 라우트 수 Glob: src/app/**/page.ts