diff --git a/CLAUDE.md b/CLAUDE.md index 63e6268d..97043e03 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -1,38 +1,57 @@ # Claude Code 프로젝트 설정 -## Git 커밋 규칙 (필수) +## Git 커밋 규칙 (최우선 필수 규칙) -**중요: 모든 코드 작업 완료 후 반드시 Git 커밋을 수행해야 합니다.** +> **경고: 이 규칙은 절대 누락되어서는 안 됩니다!** -### 커밋 절차 -1. 작업 완료 후 `git add` 로 수정된 파일 스테이징 -2. 적절한 커밋 메시지로 `git commit` 실행 +### 적용 범위 +`/home/aweso/sam/` 하위의 모든 폴더에 적용: +- `/home/aweso/sam/mng` - 관리자 웹 (Laravel) +- `/home/aweso/sam/api` - API 서버 (Laravel) +- 기타 sam 하위 폴더 -### 커밋 메시지 형식 -- `feat:` - 새로운 파일/기능 생성 시 - - 예: `feat:재무 대시보드 페이지 추가` -- `fix:` - 기존 코드 수정/버그 수정 시 - - 예: `fix:HTMX 리다이렉트 처리 개선` -- `refactor:` - 코드 리팩토링 시 -- `docs:` - 문서 수정 시 -- `chore:` - 설정 파일, 빌드 관련 수정 시 +**각 폴더는 독립적인 Git 저장소입니다. 해당 폴더에서 git 명령을 실행해야 합니다.** + +### 필수 수행 절차 + +**모든 코드 작업 완료 후 반드시 다음을 수행:** + +1. 변경된 파일이 있는 폴더로 이동 +2. `git status`로 변경사항 확인 +3. `git add <파일들>` 로 스테이징 +4. `git commit -m "type:메시지"` 로 커밋 + +### 커밋 메시지 형식 (필수) + +| Prefix | 사용 시점 | 예시 | +|--------|----------|------| +| `feat:` | 새로운 파일/기능 생성 | `feat:재무 대시보드 추가` | +| `fix:` | 버그 수정, 코드 수정 | `fix:HTMX 리다이렉트 오류 수정` | +| `refactor:` | 코드 리팩토링 | `refactor:서비스 클래스 구조 개선` | +| `docs:` | 문서 수정 | `docs:README 업데이트` | +| `chore:` | 설정, 빌드 관련 | `chore:CLAUDE.md 설정 추가` | ### 커밋 예시 -```bash -git add app/Http/Controllers/Finance/FinanceDashboardController.php -git add resources/views/finance/dashboard.blade.php -git commit -m "feat:재무 대시보드 페이지 추가" -``` ```bash -git add app/Http/Controllers/DailyLogController.php -git commit -m "fix:DailyLogController HTMX 리다이렉트 처리 추가" +# mng 폴더 작업 후 +cd /home/aweso/sam/mng +git add app/Http/Controllers/SomeController.php +git add resources/views/some-view.blade.php +git commit -m "feat:새로운 기능 추가" + +# api 폴더 작업 후 +cd /home/aweso/sam/api +git add app/Http/Controllers/Api/SomeApiController.php +git commit -m "fix:API 응답 오류 수정" ``` -### 주의사항 -- 커밋 메시지는 한글로 작성 -- 여러 파일 수정 시 관련 파일들을 함께 커밋 -- 작업 단위별로 커밋 분리 (하나의 기능/수정 = 하나의 커밋) +### 체크리스트 (작업 완료 시 확인) + +- [ ] mng 폴더 변경사항 확인 → git add → git commit +- [ ] api 폴더 변경사항 확인 → git add → git commit +- [ ] 커밋 메시지에 적절한 prefix 사용 (feat:/fix:/refactor:/docs:/chore:) +- [ ] 한글로 명확한 커밋 메시지 작성 ---