@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,285 +0,0 @@
1
- # Git 워크플로우
2
-
3
- > Hono 서버 프레임워크 프로젝트 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.ts src/middleware/auth.ts
42
- git commit -m "feat: 사용자 인증 API 추가"
43
-
44
- git add src/routes/users.ts src/services/user.ts
45
- git commit -m "feat: 사용자 CRUD API 추가"
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: 사용자 인증 API 추가` |
68
- | `fix` | 버그 수정 | `fix: JWT 토큰 검증 오류 수정` |
69
- | `refactor` | 리팩토링 | `refactor: 인증 미들웨어 분리` |
70
- | `style` | 코드 스타일 | `style: prettier 적용` |
71
- | `docs` | 문서 수정 | `docs: API 문서 업데이트` |
72
- | `test` | 테스트 | `test: 인증 미들웨어 테스트 추가` |
73
- | `chore` | 빌드/설정 | `chore: wrangler 설정 업데이트` |
74
- | `perf` | 성능 개선 | `perf: 쿼리 최적화` |
75
- | `ci` | CI/CD | `ci: GitHub Actions 추가` |
76
-
77
- ---
78
-
79
- ## ✅ 올바른 예시
80
-
81
- ```bash
82
- feat: 사용자 로그인 API 추가
83
- fix: 세션 만료 오류 수정
84
- refactor: 인증 미들웨어 분리
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
- - JWT 인증 구현
120
- - 세션 관리 추가
121
-
122
- # 여러 작업을 하나로 퉁침 (금지)
123
- feat: 로그인, 회원가입, 사용자 API 추가
124
- ```
125
-
126
- ---
127
-
128
- ## 🔄 작업 흐름
129
-
130
- ```bash
131
- # 1. 작업 전 최신 코드 동기화
132
- git pull origin main
133
-
134
- # 2. 라우트 작업 완료 → 커밋
135
- git add src/routes/users.ts src/validators/user.ts
136
- git commit -m "feat: 사용자 CRUD API 구현"
137
-
138
- # 3. 미들웨어 작업 완료 → 커밋
139
- git add src/middleware/auth.ts src/middleware/logger.ts
140
- git commit -m "feat: 인증 및 로깅 미들웨어 추가"
141
-
142
- # 4. 문서 작업 완료 → 커밋
143
- git add docs/
144
- git commit -m "docs: API 엔드포인트 문서 추가"
145
-
146
- # 5. 푸시
147
- git push origin main
148
- ```
149
-
150
- ---
151
-
152
- ## 📦 커밋 분리 가이드
153
-
154
- ### 언제 커밋을 분리해야 하나요?
155
-
156
- | 상황 | 커밋 분리 |
157
- |------|----------|
158
- | 서로 다른 API 엔드포인트 | ✅ 분리 |
159
- | 버그 수정 + 새 기능 | ✅ 분리 |
160
- | 코드 변경 + 문서 변경 | ✅ 분리 |
161
- | 리팩토링 + 기능 추가 | ✅ 분리 |
162
- | 동일 기능의 라우트 + 밸리데이터 | 🔄 묶어도 됨 |
163
- | 동일 기능의 서비스 + 타입 | 🔄 묶어도 됨 |
164
-
165
- ### 예시: 사용자 관리 API 개발
166
-
167
- ```bash
168
- # 1. 인증 API 커밋
169
- git add src/routes/auth.ts src/middleware/auth.ts src/validators/auth.ts
170
- git commit -m "feat: 사용자 인증 API 추가"
171
-
172
- # 2. 사용자 API 커밋
173
- git add src/routes/users.ts src/services/user.ts src/validators/user.ts
174
- git commit -m "feat: 사용자 CRUD API 추가"
175
-
176
- # 3. 에러 핸들링 커밋
177
- git add src/lib/errors.ts src/index.ts
178
- git commit -m "feat: 글로벌 에러 핸들러 추가"
179
-
180
- # 4. 테스트 커밋
181
- git add tests/
182
- git commit -m "test: 사용자 API 테스트 추가"
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-auth-api
209
- feature/payment-webhook
210
- fix/jwt-validation-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
- dist/
255
- .output/
256
-
257
- # Environment
258
- .env
259
- .env.local
260
- .dev.vars
261
-
262
- # IDE
263
- .idea/
264
- .vscode/
265
- *.swp
266
-
267
- # OS
268
- .DS_Store
269
-
270
- # Prisma
271
- prisma/generated/
272
-
273
- # Wrangler
274
- .wrangler/
275
-
276
- # Cache
277
- .cache/
278
- ```
279
-
280
- ---
281
-
282
- ## 🔗 관련 문서
283
-
284
- - [CLAUDE.md](../../CLAUDE.md)
285
- - [아키텍처](../architecture/architecture.md)
@@ -1,307 +0,0 @@
1
- # Git 워크플로우
2
-
3
- > NPX CLI 프로젝트 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/commands/init.ts src/utils/copy.ts
42
- git commit -m "feat: 템플릿 복사 기능 추가"
43
-
44
- git add src/commands/list.ts
45
- git commit -m "feat: 템플릿 목록 조회 기능 추가"
46
-
47
- git add docs/
48
- git commit -m "docs: CLI 사용법 문서 추가"
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: copy 유틸 분리` |
70
- | `style` | 코드 스타일 | `style: prettier 적용` |
71
- | `docs` | 문서 수정 | `docs: README 업데이트` |
72
- | `test` | 테스트 | `test: copy 유틸 테스트 추가` |
73
- | `chore` | 빌드/설정 | `chore: 버전 업데이트` |
74
- | `perf` | 성능 개선 | `perf: 파일 복사 최적화` |
75
- | `ci` | CI/CD | `ci: GitHub Actions 추가` |
76
-
77
- ---
78
-
79
- ## ✅ 올바른 예시
80
-
81
- ```bash
82
- feat: CLI 옵션 추가
83
- fix: 템플릿 경로 오류 수정
84
- docs: 사용법 문서 추가
85
- refactor: logger 유틸 분리
86
- chore: 의존성 업데이트
87
- ```
88
-
89
- ---
90
-
91
- ## ❌ 잘못된 예시
92
-
93
- ```bash
94
- # prefix 없음
95
- 템플릿 기능 추가함
96
-
97
- # 마침표 불필요
98
- feat: 새 기능 추가.
99
-
100
- # 대문자 사용
101
- FEAT: 새 기능 추가
102
-
103
- # scope 불필요
104
- feat(cli): 옵션 추가
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
- - 옵션 A 추가
120
- - 옵션 B 추가
121
-
122
- # 여러 작업을 하나로 퉁침 (금지)
123
- feat: init, list, copy 명령어 추가
124
- ```
125
-
126
- ---
127
-
128
- ## 🔄 작업 흐름
129
-
130
- ```bash
131
- # 1. 작업 전 최신 코드 동기화
132
- git pull origin main
133
-
134
- # 2. 명령어 작업 완료 → 커밋
135
- git add src/commands/init.ts src/utils/copy.ts
136
- git commit -m "feat: 템플릿 초기화 명령어 추가"
137
-
138
- # 3. 유틸리티 작업 완료 → 커밋
139
- git add src/utils/logger.ts src/utils/spinner.ts
140
- git commit -m "feat: 로깅 및 스피너 유틸 추가"
141
-
142
- # 4. 문서 작업 완료 → 커밋
143
- git add docs/
144
- git commit -m "docs: CLI 사용법 문서 추가"
145
-
146
- # 5. 푸시
147
- git push origin main
148
- ```
149
-
150
- ---
151
-
152
- ## 📦 커밋 분리 가이드
153
-
154
- ### 언제 커밋을 분리해야 하나요?
155
-
156
- | 상황 | 커밋 분리 |
157
- |------|----------|
158
- | 서로 다른 CLI 명령어 | ✅ 분리 |
159
- | 버그 수정 + 새 기능 | ✅ 분리 |
160
- | 코드 변경 + 문서 변경 | ✅ 분리 |
161
- | 리팩토링 + 기능 추가 | ✅ 분리 |
162
- | 동일 명령어의 핸들러 + 유틸 | 🔄 묶어도 됨 |
163
- | 동일 기능의 타입 + 구현 | 🔄 묶어도 됨 |
164
-
165
- ### 예시: CLI 도구 개발
166
-
167
- ```bash
168
- # 1. init 명령어 커밋
169
- git add src/commands/init.ts src/utils/copy.ts
170
- git commit -m "feat: 템플릿 초기화 명령어 추가"
171
-
172
- # 2. list 명령어 커밋
173
- git add src/commands/list.ts
174
- git commit -m "feat: 템플릿 목록 조회 명령어 추가"
175
-
176
- # 3. 공통 유틸 커밋
177
- git add src/utils/logger.ts src/utils/spinner.ts
178
- git commit -m "feat: CLI 유틸리티 함수 추가"
179
-
180
- # 4. 테스트 커밋
181
- git add tests/
182
- git commit -m "test: CLI 명령어 테스트 추가"
183
-
184
- # 5. 문서 커밋
185
- git add docs/ README.md
186
- git commit -m "docs: CLI 사용법 및 README 추가"
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/multi-template
209
- feature/interactive-mode
210
- fix/path-resolution
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
- ## 🏷 버전 관리
248
-
249
- ### 버전 업데이트
250
-
251
- ```bash
252
- # 패치 버전 (0.1.0 → 0.1.1)
253
- npm version patch
254
-
255
- # 마이너 버전 (0.1.0 → 0.2.0)
256
- npm version minor
257
-
258
- # 메이저 버전 (0.1.0 → 1.0.0)
259
- npm version major
260
- ```
261
-
262
- ### 배포 전 체크리스트
263
-
264
- ```
265
- □ 버전 업데이트 완료
266
- □ CHANGELOG 작성 완료
267
- □ 테스트 통과 확인
268
- □ 빌드 성공 확인
269
- ```
270
-
271
- ---
272
-
273
- ## 📚 .gitignore
274
-
275
- ```gitignore
276
- # Dependencies
277
- node_modules/
278
-
279
- # Build
280
- dist/
281
- lib/
282
-
283
- # Environment
284
- .env
285
- .env.local
286
-
287
- # IDE
288
- .idea/
289
- .vscode/
290
- *.swp
291
-
292
- # OS
293
- .DS_Store
294
-
295
- # Logs
296
- *.log
297
- npm-debug.log*
298
-
299
- # Cache
300
- .cache/
301
- ```
302
-
303
- ---
304
-
305
- ## 🔗 관련 문서
306
-
307
- - [CLAUDE.md](../../CLAUDE.md)