@kood/claude-code 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,277 +0,0 @@
1
- # Git 워크플로우
2
-
3
- > TanStack Start + React 프로젝트 Git 컨벤션
4
-
5
- ---
6
-
7
- ## ⛔ NEVER (절대 금지)
8
-
9
- ```
10
- ❌ 커밋에 "Generated with Claude Code" 포함
11
- ❌ 커밋에 "🤖" 또는 AI 관련 이모지 포함
12
- ❌ 커밋에 "Co-Authored-By:" 헤더 포함
13
- ❌ 커밋에 AI/봇이 작성했다는 어떤 표시도 포함
14
- ❌ 커밋 메시지 여러 줄 작성
15
- ❌ 커밋 메시지에 이모지 사용
16
- ❌ 커밋 메시지에 마침표(.) 사용
17
- ❌ 여러 작업을 하나의 커밋으로 퉁치기
18
- ```
19
-
20
- ---
21
-
22
- ## ✅ ALWAYS (필수)
23
-
24
- ### 작업 완료 후 반드시 실행
25
-
26
- ```bash
27
- git add <관련 파일들>
28
- git commit -m "<prefix>: <설명>"
29
- ```
30
-
31
- ### ⭐ 커밋 분리 원칙
32
-
33
- **하나의 커밋 = 하나의 논리적 변경 단위**
34
-
35
- ```bash
36
- # ❌ 잘못된 방식: 모든 작업을 하나로 퉁침
37
- git add .
38
- git commit -m "feat: 여러 기능 추가"
39
-
40
- # ✅ 올바른 방식: 논리적 단위로 분리
41
- git add src/routes/auth.tsx src/functions/auth.ts
42
- git commit -m "feat: 사용자 로그인 기능 추가"
43
-
44
- git add src/routes/profile.tsx src/functions/user.ts
45
- git commit -m "feat: 프로필 조회 기능 추가"
46
-
47
- git add docs/
48
- git commit -m "docs: API 문서 업데이트"
49
- ```
50
-
51
- ---
52
-
53
- ## 📝 커밋 형식
54
-
55
- ```
56
- <prefix>: <설명>
57
- ```
58
-
59
- **한 줄로 간결하게** 작성합니다. 본문이나 푸터는 작성하지 않습니다.
60
-
61
- ---
62
-
63
- ## 🏷 Prefix 목록
64
-
65
- | Prefix | 용도 | 예시 |
66
- |--------|------|------|
67
- | `feat` | 새로운 기능 | `feat: 사용자 로그인 기능 추가` |
68
- | `fix` | 버그 수정 | `fix: 세션 만료 오류 수정` |
69
- | `refactor` | 리팩토링 | `refactor: 인증 로직 분리` |
70
- | `style` | 코드 스타일 | `style: eslint 규칙 적용` |
71
- | `docs` | 문서 수정 | `docs: API 문서 업데이트` |
72
- | `test` | 테스트 | `test: 로그인 테스트 추가` |
73
- | `chore` | 빌드/설정 | `chore: vite 설정 업데이트` |
74
- | `perf` | 성능 개선 | `perf: 이미지 로딩 최적화` |
75
- | `ci` | CI/CD | `ci: GitHub Actions 추가` |
76
-
77
- ---
78
-
79
- ## ✅ 올바른 예시
80
-
81
- ```bash
82
- feat: 회원가입 폼 유효성 검사 추가
83
- fix: 비밀번호 재설정 이메일 발송 오류 수정
84
- refactor: UserService 클래스 구조 개선
85
- docs: README 설치 가이드 추가
86
- chore: Prisma 7.x 버전 업그레이드
87
- ```
88
-
89
- ---
90
-
91
- ## ❌ 잘못된 예시
92
-
93
- ```bash
94
- # prefix 없음
95
- 회원가입 기능 추가함
96
-
97
- # 마침표 불필요
98
- feat: 회원가입 기능 추가.
99
-
100
- # 대문자 사용
101
- FEAT: 회원가입 기능 추가
102
-
103
- # scope 불필요
104
- feat(auth): 회원가입 추가
105
-
106
- # AI 작성 표시 (절대 금지!)
107
- feat: 로그인 기능 추가
108
-
109
- 🤖 Generated with Claude Code
110
-
111
- # Co-Author 표시 (절대 금지!)
112
- feat: 로그인 기능 추가
113
-
114
- Co-Authored-By: Claude <noreply@anthropic.com>
115
-
116
- # 여러 줄 본문 (금지)
117
- feat: 로그인 기능 추가
118
-
119
- - 이메일 인증 추가
120
- - 세션 관리 구현
121
-
122
- # 여러 작업을 하나로 퉁침 (금지)
123
- feat: 로그인, 회원가입, 프로필 기능 추가
124
- ```
125
-
126
- ---
127
-
128
- ## 🔄 작업 흐름
129
-
130
- ```bash
131
- # 1. 작업 전 최신 코드 동기화
132
- git pull origin main
133
-
134
- # 2. 기능 A 작업 완료 → 커밋
135
- git add src/routes/feature-a.tsx src/functions/feature-a.ts
136
- git commit -m "feat: 기능 A 구현"
137
-
138
- # 3. 기능 B 작업 완료 → 커밋
139
- git add src/routes/feature-b.tsx src/functions/feature-b.ts
140
- git commit -m "feat: 기능 B 구현"
141
-
142
- # 4. 문서 작업 완료 → 커밋
143
- git add docs/
144
- git commit -m "docs: 기능 A, B 문서 추가"
145
-
146
- # 5. 푸시
147
- git push origin main
148
- ```
149
-
150
- ---
151
-
152
- ## 📦 커밋 분리 가이드
153
-
154
- ### 언제 커밋을 분리해야 하나요?
155
-
156
- | 상황 | 커밋 분리 |
157
- |------|----------|
158
- | 서로 다른 기능 구현 | ✅ 분리 |
159
- | 버그 수정 + 새 기능 | ✅ 분리 |
160
- | 코드 변경 + 문서 변경 | ✅ 분리 |
161
- | 리팩토링 + 기능 추가 | ✅ 분리 |
162
- | 동일 기능의 라우트 + 함수 | 🔄 묶어도 됨 |
163
- | 동일 기능의 스키마 + 서비스 | 🔄 묶어도 됨 |
164
-
165
- ### 예시: 사용자 관리 기능 개발
166
-
167
- ```bash
168
- # 1. 인증 기능 커밋
169
- git add src/routes/auth/ src/functions/auth.ts src/middleware/auth.ts
170
- git commit -m "feat: 사용자 인증 기능 추가"
171
-
172
- # 2. 프로필 기능 커밋
173
- git add src/routes/profile/ src/functions/user.ts
174
- git commit -m "feat: 프로필 조회 및 수정 기능 추가"
175
-
176
- # 3. 유효성 검사 커밋
177
- git add src/validators/
178
- git commit -m "feat: 사용자 입력 유효성 검사 추가"
179
-
180
- # 4. 테스트 커밋
181
- git add tests/
182
- git commit -m "test: 사용자 관리 기능 테스트 추가"
183
-
184
- # 5. 문서 커밋
185
- git add docs/
186
- git commit -m "docs: 사용자 API 문서 추가"
187
- ```
188
-
189
- ---
190
-
191
- ## 🌿 브랜치 전략
192
-
193
- ### 간단한 프로젝트
194
- ```
195
- main ← 모든 작업 직접 커밋
196
- ```
197
-
198
- ### 팀 프로젝트
199
- ```
200
- main
201
- └── feature/기능명
202
- └── fix/버그명
203
- └── hotfix/긴급수정
204
- ```
205
-
206
- ### 브랜치 명명
207
- ```bash
208
- feature/user-authentication
209
- feature/payment-integration
210
- fix/login-session-error
211
- hotfix/security-patch
212
- ```
213
-
214
- ---
215
-
216
- ## 📋 자주 사용하는 명령어
217
-
218
- ```bash
219
- # 상태 확인
220
- git status
221
-
222
- # 변경 내용 확인
223
- git diff
224
-
225
- # 최근 커밋 로그
226
- git log --oneline -10
227
-
228
- # 커밋 취소 (작업 내용 유지)
229
- git reset --soft HEAD~1
230
-
231
- # 스테이징 취소
232
- git restore --staged .
233
-
234
- # 변경사항 임시 저장
235
- git stash
236
- git stash pop
237
-
238
- # 특정 파일만 스테이징
239
- git add <파일경로>
240
-
241
- # 대화형 스테이징 (부분 커밋용)
242
- git add -p
243
- ```
244
-
245
- ---
246
-
247
- ## 📚 .gitignore
248
-
249
- ```gitignore
250
- # Dependencies
251
- node_modules/
252
-
253
- # Build
254
- .output/
255
- dist/
256
- build/
257
-
258
- # Environment
259
- .env
260
- .env.local
261
- .env.*.local
262
-
263
- # IDE
264
- .idea/
265
- .vscode/
266
- *.swp
267
-
268
- # OS
269
- .DS_Store
270
-
271
- # Prisma
272
- prisma/generated/
273
-
274
- # Cache
275
- .cache/
276
- .turbo/
277
- ```