@kood/claude-code 0.2.5 → 0.3.1

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.
Files changed (130) hide show
  1. package/dist/index.js +13 -8
  2. package/package.json +1 -1
  3. package/templates/.claude/agents/code-reviewer.md +371 -19
  4. package/templates/.claude/agents/dependency-manager.md +197 -0
  5. package/templates/.claude/agents/deployment-validator.md +136 -0
  6. package/templates/.claude/agents/git-operator.md +147 -0
  7. package/templates/.claude/agents/implementation-executor.md +202 -0
  8. package/templates/.claude/agents/lint-fixer.md +155 -0
  9. package/templates/.claude/agents/refactor-advisor.md +339 -29
  10. package/templates/.claude/commands/agent-creator.md +355 -0
  11. package/templates/.claude/commands/docs-creator.md +404 -163
  12. package/templates/.claude/commands/docs-refactor.md +400 -113
  13. package/templates/.claude/commands/execute.md +357 -185
  14. package/templates/.claude/commands/git-all.md +65 -71
  15. package/templates/.claude/commands/git-session.md +80 -64
  16. package/templates/.claude/commands/git.md +68 -72
  17. package/templates/.claude/commands/lint-fix.md +224 -109
  18. package/templates/.claude/commands/lint-init.md +142 -168
  19. package/templates/.claude/commands/plan.md +300 -84
  20. package/templates/.claude/commands/prd.md +497 -214
  21. package/templates/.claude/commands/pre-deploy.md +242 -0
  22. package/templates/.claude/commands/subagent-creator.md +118 -0
  23. package/templates/.claude/commands/version-update.md +45 -57
  24. package/templates/hono/CLAUDE.md +99 -54
  25. package/templates/hono/docs/guides/conventions.md +352 -0
  26. package/templates/hono/docs/guides/env-setup.md +347 -0
  27. package/templates/hono/docs/guides/getting-started.md +239 -0
  28. package/templates/hono/docs/library/hono/error-handling.md +20 -29
  29. package/templates/hono/docs/library/hono/index.md +25 -52
  30. package/templates/hono/docs/library/hono/middleware.md +16 -75
  31. package/templates/hono/docs/library/hono/rpc.md +7 -35
  32. package/templates/hono/docs/library/hono/validation.md +25 -45
  33. package/templates/hono/docs/library/t3-env/index.md +374 -0
  34. package/templates/npx/CLAUDE.md +165 -65
  35. package/templates/npx/docs/library/commander/index.md +10 -73
  36. package/templates/npx/docs/library/fs-extra/index.md +21 -113
  37. package/templates/npx/docs/library/prompts/index.md +30 -176
  38. package/templates/npx/docs/references/patterns.md +75 -48
  39. package/templates/tanstack-start/CLAUDE.md +101 -77
  40. package/templates/tanstack-start/docs/architecture.md +427 -0
  41. package/templates/tanstack-start/docs/design.md +558 -0
  42. package/templates/tanstack-start/docs/guides/conventions.md +132 -32
  43. package/templates/tanstack-start/docs/guides/env-setup.md +127 -62
  44. package/templates/tanstack-start/docs/guides/getting-started.md +81 -20
  45. package/templates/tanstack-start/docs/guides/hooks.md +241 -36
  46. package/templates/tanstack-start/docs/guides/routes.md +213 -61
  47. package/templates/tanstack-start/docs/guides/services.md +260 -24
  48. package/templates/tanstack-start/docs/library/better-auth/index.md +469 -16
  49. package/templates/tanstack-start/docs/library/t3-env/index.md +307 -0
  50. package/templates/tanstack-start/docs/library/tanstack-query/index.md +12 -21
  51. package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md +22 -35
  52. package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md +7 -24
  53. package/templates/tanstack-start/docs/library/tanstack-query/use-mutation.md +26 -39
  54. package/templates/tanstack-start/docs/library/tanstack-query/use-query.md +23 -26
  55. package/templates/tanstack-start/docs/library/tanstack-router/error-handling.md +32 -147
  56. package/templates/tanstack-start/docs/library/tanstack-router/hooks.md +25 -167
  57. package/templates/tanstack-start/docs/library/tanstack-router/index.md +39 -74
  58. package/templates/tanstack-start/docs/library/tanstack-router/navigation.md +46 -116
  59. package/templates/tanstack-start/docs/library/tanstack-router/route-context.md +35 -154
  60. package/templates/tanstack-start/docs/library/tanstack-router/search-params.md +32 -171
  61. package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md +7 -15
  62. package/templates/tanstack-start/docs/library/tanstack-start/routing.md +16 -23
  63. package/templates/tanstack-start/docs/library/zod/complex-types.md +12 -31
  64. package/templates/tanstack-start/docs/library/zod/index.md +18 -35
  65. package/templates/tanstack-start/docs/library/zod/transforms.md +11 -25
  66. package/templates/tanstack-start/docs/library/zod/validation.md +12 -34
  67. package/templates/.claude/agents/debug-detective.md +0 -37
  68. package/templates/.claude/agents/test-writer.md +0 -41
  69. package/templates/.claude/commands/feedback.md +0 -199
  70. package/templates/.claude/commands/ts-fix.md +0 -176
  71. package/templates/.claude/skills/command-creator/LICENSE.txt +0 -202
  72. package/templates/.claude/skills/command-creator/SKILL.md +0 -245
  73. package/templates/.claude/skills/command-creator/scripts/init_command.py +0 -244
  74. package/templates/.claude/skills/command-creator/scripts/package_command.py +0 -125
  75. package/templates/.claude/skills/command-creator/scripts/quick_validate.py +0 -143
  76. package/templates/.claude/skills/frontend-design/SKILL.md +0 -310
  77. package/templates/.claude/skills/frontend-design/references/animation-patterns.md +0 -446
  78. package/templates/.claude/skills/frontend-design/references/colors-2026.md +0 -244
  79. package/templates/.claude/skills/frontend-design/references/typography-2026.md +0 -302
  80. package/templates/.claude/skills/gemini-review/SKILL.md +0 -118
  81. package/templates/.claude/skills/gemini-review/references/checklists.md +0 -129
  82. package/templates/.claude/skills/gemini-review/references/prompt-templates.md +0 -274
  83. package/templates/.claude/skills/skill-creator/LICENSE.txt +0 -202
  84. package/templates/.claude/skills/skill-creator/SKILL.md +0 -184
  85. package/templates/.claude/skills/skill-creator/scripts/init_skill.py +0 -303
  86. package/templates/.claude/skills/skill-creator/scripts/package_skill.py +0 -110
  87. package/templates/.claude/skills/skill-creator/scripts/quick_validate.py +0 -65
  88. package/templates/hono/docs/library/ai-sdk/index.md +0 -190
  89. package/templates/hono/docs/library/ai-sdk/openrouter.md +0 -111
  90. package/templates/hono/docs/library/ai-sdk/providers.md +0 -102
  91. package/templates/hono/docs/library/ai-sdk/streaming.md +0 -146
  92. package/templates/hono/docs/library/ai-sdk/structured-output.md +0 -161
  93. package/templates/hono/docs/library/ai-sdk/tools.md +0 -144
  94. package/templates/hono/docs/library/drizzle/cloudflare-d1.md +0 -247
  95. package/templates/hono/docs/library/drizzle/config.md +0 -167
  96. package/templates/hono/docs/library/drizzle/index.md +0 -259
  97. package/templates/hono/docs/library/hono/env-setup.md +0 -169
  98. package/templates/hono/docs/library/pino/index.md +0 -146
  99. package/templates/tanstack-start/docs/architecture/architecture.md +0 -243
  100. package/templates/tanstack-start/docs/deployment/cloudflare.md +0 -132
  101. package/templates/tanstack-start/docs/deployment/index.md +0 -163
  102. package/templates/tanstack-start/docs/deployment/nitro.md +0 -110
  103. package/templates/tanstack-start/docs/deployment/railway.md +0 -147
  104. package/templates/tanstack-start/docs/deployment/vercel.md +0 -135
  105. package/templates/tanstack-start/docs/design/components.md +0 -175
  106. package/templates/tanstack-start/docs/design/index.md +0 -151
  107. package/templates/tanstack-start/docs/design/safe-area.md +0 -118
  108. package/templates/tanstack-start/docs/design/tailwind-setup.md +0 -156
  109. package/templates/tanstack-start/docs/library/ai-sdk/hooks.md +0 -472
  110. package/templates/tanstack-start/docs/library/ai-sdk/index.md +0 -264
  111. package/templates/tanstack-start/docs/library/ai-sdk/openrouter.md +0 -371
  112. package/templates/tanstack-start/docs/library/ai-sdk/providers.md +0 -403
  113. package/templates/tanstack-start/docs/library/ai-sdk/streaming.md +0 -320
  114. package/templates/tanstack-start/docs/library/ai-sdk/structured-output.md +0 -454
  115. package/templates/tanstack-start/docs/library/ai-sdk/tools.md +0 -473
  116. package/templates/tanstack-start/docs/library/better-auth/2fa.md +0 -48
  117. package/templates/tanstack-start/docs/library/better-auth/advanced.md +0 -55
  118. package/templates/tanstack-start/docs/library/better-auth/plugins.md +0 -34
  119. package/templates/tanstack-start/docs/library/better-auth/session.md +0 -47
  120. package/templates/tanstack-start/docs/library/better-auth/setup.md +0 -41
  121. package/templates/tanstack-start/docs/library/drizzle/cloudflare-d1.md +0 -147
  122. package/templates/tanstack-start/docs/library/drizzle/config.md +0 -118
  123. package/templates/tanstack-start/docs/library/drizzle/crud.md +0 -205
  124. package/templates/tanstack-start/docs/library/drizzle/index.md +0 -79
  125. package/templates/tanstack-start/docs/library/drizzle/relations.md +0 -202
  126. package/templates/tanstack-start/docs/library/drizzle/schema.md +0 -154
  127. package/templates/tanstack-start/docs/library/drizzle/setup.md +0 -96
  128. package/templates/tanstack-start/docs/library/drizzle/transactions.md +0 -127
  129. package/templates/tanstack-start/docs/library/pino/index.md +0 -320
  130. /package/templates/hono/docs/{architecture/architecture.md → architecture.md} +0 -0
@@ -1,83 +1,77 @@
1
1
  ---
2
2
  description: 모든 변경사항 커밋 후 푸시
3
- allowed-tools: Bash(git:*)
4
3
  ---
5
4
 
6
- 모든 변경사항을 논리적 단위로 분리하여 전부 커밋 후 푸시.
5
+ # Git All Command
7
6
 
8
- ## 실행 흐름
7
+ > @git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
9
8
 
10
- ```
11
- 1. git status + git diff (병렬 실행)
12
- 2. 논리적 단위로 분리하여 git add + git commit (반복)
13
- 3. git status (완료 확인 - 남은 변경 없어야 함)
14
- 4. git push
15
- ```
9
+ ---
16
10
 
17
- ## 병렬 실행
11
+ <critical_requirements>
18
12
 
19
- **초기 분석 단계에서 병렬 실행 필수:**
13
+ ## ⚠️ CRITICAL: 작업 시작 전 필수 확인
20
14
 
21
- ```bash
22
- # 동시에 실행 (두 Bash 호출을 하나의 응답에서)
23
- git status
24
- git diff
15
+ **이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
16
+
17
+ ### MANDATORY: Task 도구로 @git-operator 호출
18
+
19
+ ```typescript
20
+ Task({
21
+ subagent_type: 'git-operator',
22
+ description: '모든 변경사항 커밋 후 푸시',
23
+ prompt: `
24
+ 전체 커밋 모드:
25
+ - 모든 변경사항을 논리적 단위로 분리하여 전부 커밋
26
+ - 반드시 푸시 (git push)
27
+ - clean working directory 확인 필수
28
+ `
29
+ })
25
30
  ```
26
31
 
27
- ## CRITICAL: 절대 금지
28
-
29
- | 금지 항목 |
30
- |----------|
31
- | "Generated with Claude Code" 포함 |
32
- | "🤖" 또는 AI 관련 이모지 |
33
- | "Co-Authored-By:" 헤더 |
34
- | AI/봇 작성 표시 일체 |
35
- | 여러 커밋 메시지 |
36
- | 커밋 메시지에 마침표(.) |
37
- | 여러 작업 하나로 퉁치기 |
38
- | 변경사항 남겨두기 |
39
-
40
- ## 커밋 규칙
41
-
42
- **형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
43
-
44
- **핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
45
-
46
- ### Prefix
47
-
48
- | Prefix | 용도 |
49
- |--------|------|
50
- | feat | 새 기능 |
51
- | fix | 버그 수정 |
52
- | refactor | 리팩토링 |
53
- | style | 코드 스타일 |
54
- | docs | 문서 수정 |
55
- | test | 테스트 |
56
- | chore | 빌드/설정 |
57
- | perf | 성능 개선 |
58
- | ci | CI/CD |
59
-
60
- ### 분리 기준
61
-
62
- | 분리 필요 | 묶어도 됨 |
63
- |----------|----------|
64
- | 서로 다른 기능 | 동일 기능의 관련 파일들 |
65
- | 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
66
- | 코드 변경 + 문서 변경 | |
67
- | 리팩토링 + 기능 추가 | |
68
-
69
- ## 예시
70
-
71
- ```bash
72
- # ✅ 올바른
73
- feat: 사용자 로그인 기능 추가
74
- fix: 세션 만료 오류 수정
75
- refactor: 서비스 클래스 구조 개선
76
-
77
- # ❌ 잘못된
78
- 사용자 인증 기능 추가함 # prefix 없음
79
- feat: 사용자 인증 추가. # 마침표
80
- FEAT: 사용자 인증 추가 # 대문자
81
- feat(auth): 인증 추가 # scope 불필요
82
- feat: 로그인, 회원가입, 프로필 # 여러 작업 퉁침
32
+ **❌ 절대 금지:**
33
+ - Bash 도구로 git 명령 직접 실행
34
+ - @git-operator 없이 커밋/푸시 수행
35
+ - 커맨드 내에서 직접 파일 분석
36
+
37
+ **✅ 필수:**
38
+ - Task 도구로 @git-operator 에이전트 호출
39
+ - 모든 git 작업을 에이전트에 위임
40
+ - 완료 clean working directory 확인
41
+
42
+ ---
43
+
44
+ **진행 전 자가 점검:**
45
+ ```text
46
+ □ Task 도구 사용 준비?
47
+ @git-operator 에이전트로 작업 위임?
48
+ □ Bash로 git 직접 실행 안 함?
83
49
  ```
50
+
51
+ **⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
52
+
53
+ </critical_requirements>
54
+
55
+ ---
56
+
57
+ <mode>
58
+
59
+ **전체 커밋 모드**
60
+
61
+ - **모든 변경사항**을 논리적 단위로 분리하여 **전부 커밋**
62
+ - **반드시 푸시** (git push)
63
+ - **남은 변경사항 없음** (clean working directory) 확인 필수
64
+
65
+ </mode>
66
+
67
+ ---
68
+
69
+ <workflow>
70
+
71
+ 1. 모든 변경사항 분석
72
+ 2. 논리적 단위로 그룹핑
73
+ 3. 각 그룹별 커밋 (반복)
74
+ 4. clean working directory 확인
75
+ 5. git push 실행
76
+
77
+ </workflow>
@@ -1,91 +1,107 @@
1
1
  ---
2
2
  description: 현재 세션에서 수정한 파일만 커밋 후 푸시
3
- allowed-tools: Bash(git:*)
4
3
  ---
5
4
 
6
- 세션에서 수정한 파일만 논리적 단위로 분리하여 커밋 후 푸시.
5
+ # Git Session Command
7
6
 
8
- ## 실행 흐름
7
+ > @git-operator 에이전트를 사용하여 현재 세션 파일만 선택적으로 커밋하고 푸시.
9
8
 
9
+ ---
10
+
11
+ <critical_requirements>
12
+
13
+ ## ⚠️ CRITICAL: 작업 시작 전 필수 확인
14
+
15
+ **이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
16
+
17
+ ### MANDATORY: Task 도구로 @git-operator 호출
18
+
19
+ ```typescript
20
+ Task({
21
+ subagent_type: 'git-operator',
22
+ description: '세션 파일만 커밋 후 푸시',
23
+ prompt: `
24
+ 세션 커밋 모드:
25
+ - 현재 세션 관련 파일만 선택적 커밋
26
+ - 반드시 푸시 (git push)
27
+ - 이전 세션의 미완성 작업은 제외
28
+ `
29
+ })
10
30
  ```
11
- 1. git status + git diff (병렬 실행)
12
- 2. 대화 맥락에서 이 세션에 수정한 파일 목록 파악
13
- 3. 해당 파일만 논리적 단위로 git add + git commit (반복)
14
- 4. git status (완료 확인)
15
- 5. git push
31
+
32
+ **❌ 절대 금지:**
33
+ - Bash 도구로 git 명령 직접 실행
34
+ - @git-operator 없이 커밋/푸시 수행
35
+ - 커맨드 내에서 직접 파일 분석
36
+
37
+ **✅ 필수:**
38
+ - Task 도구로 @git-operator 에이전트 호출
39
+ - 모든 git 작업을 에이전트에 위임
40
+ - 현재 세션 파일만 선택
41
+
42
+ ---
43
+
44
+ **진행 전 자가 점검:**
45
+ ```text
46
+ □ Task 도구 사용 준비?
47
+ □ @git-operator 에이전트로 작업 위임?
48
+ □ Bash로 git 직접 실행 안 함?
16
49
  ```
17
50
 
18
- ## 세션 파일 판별
51
+ **⚠️ 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
19
52
 
20
- **대화 맥락에서 Edit/Write 도구로 수정한 파일만 대상**
53
+ </critical_requirements>
21
54
 
22
- - 이 세션에서 직접 수정하지 않은 파일은 절대 stage하지 않음
23
- - 다른 변경사항은 unstaged 상태로 유지
55
+ ---
24
56
 
25
- ## 병렬 실행
57
+ <mode>
26
58
 
27
- **초기 분석 단계에서 병렬 실행 필수:**
59
+ **세션 커밋 모드**
28
60
 
29
- ```bash
30
- # 동시에 실행 ( Bash 호출을 하나의 응답에서)
31
- git status
32
- git diff
33
- ```
61
+ - **현재 세션 관련 파일만** 선택적 커밋
62
+ - **반드시 푸시** (git push)
34
63
 
35
- ## CRITICAL: 절대 금지
64
+ </mode>
36
65
 
37
- | 금지 항목 |
38
- |----------|
39
- | "Generated with Claude Code" 포함 |
40
- | "🤖" 또는 AI 관련 이모지 |
41
- | "Co-Authored-By:" 헤더 |
42
- | AI/봇 작성 표시 일체 |
43
- | 여러 줄 커밋 메시지 |
44
- | 커밋 메시지에 마침표(.) |
45
- | 여러 작업 하나로 퉁치기 |
46
- | 세션에서 수정하지 않은 파일 커밋 |
66
+ ---
47
67
 
48
- ## 커밋 규칙
68
+ <selection_criteria>
49
69
 
50
- **형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
70
+ | 포함 | 제외 |
71
+ |------|------|
72
+ | 현재 세션 관련 파일 | 이전 세션의 미완성 작업 |
73
+ | 방금 전 작업한 파일 | 자동 생성 파일 (lock, cache) |
74
+ | 관련 기능의 파일들 | 무관한 변경사항 |
51
75
 
52
- **핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
76
+ </selection_criteria>
53
77
 
54
- ### Prefix
78
+ ---
55
79
 
56
- | Prefix | 용도 |
57
- |--------|------|
58
- | feat | 새 기능 |
59
- | fix | 버그 수정 |
60
- | refactor | 리팩토링 |
61
- | style | 코드 스타일 |
62
- | docs | 문서 수정 |
63
- | test | 테스트 |
64
- | chore | 빌드/설정 |
65
- | perf | 성능 개선 |
66
- | ci | CI/CD |
80
+ <workflow>
67
81
 
68
- ### 분리 기준
82
+ 1. 모든 변경사항 분석
83
+ 2. **현재 세션 관련 파일만 선택**
84
+ 3. 논리적 단위로 그룹핑
85
+ 4. 각 그룹별 커밋
86
+ 5. git push 실행
69
87
 
70
- | 분리 필요 | 묶어도 됨 |
71
- |----------|----------|
72
- | 서로 다른 기능 | 동일 기능의 관련 파일들 |
73
- | 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
74
- | 코드 변경 + 문서 변경 | |
75
- | 리팩토링 + 기능 추가 | |
88
+ </workflow>
76
89
 
77
- ## 예시
90
+ ---
91
+
92
+ <example>
78
93
 
79
94
  ```bash
80
- # 올바른
81
- feat: 사용자 로그인 기능 추가
82
- fix: 세션 만료 오류 수정
83
- refactor: 서비스 클래스 구조 개선
84
-
85
- # 잘못된
86
- 사용자 인증 기능 추가함 # prefix 없음
87
- feat: 사용자 인증 추가. # 마침표
88
- FEAT: 사용자 인증 추가 # 대문자
89
- feat(auth): 인증 추가 # scope 불필요
90
- feat: 로그인, 회원가입, 프로필 # 여러 작업 퉁침
95
+ # 상황: 로그인 기능 작업 중, 이전 프로필 기능은 미완성
96
+
97
+ git status
98
+ # modified: src/auth/login.ts (현재 세션)
99
+ # modified: src/auth/logout.ts (현재 세션)
100
+ # modified: src/profile/edit.ts (이전 세션)
101
+
102
+ # 로그인 관련만 커밋
103
+ git add src/auth/login.ts src/auth/logout.ts && git commit -m "feat: 로그인/로그아웃 기능 추가"
104
+ git push
91
105
  ```
106
+
107
+ </example>
@@ -1,86 +1,82 @@
1
1
  ---
2
2
  description: Git 상태 확인 및 커밋 작업
3
- allowed-tools: Bash(git:*)
4
3
  argument-hint: [push|pull|커밋 지시사항...]
5
4
  ---
6
5
 
7
- Git 상태 확인 후 아래 규칙에 따라 작업 진행.
6
+ # Git Command
8
7
 
9
- **지시사항**: $ARGUMENTS
8
+ > @git-operator 에이전트를 사용하여 Git 작업 수행.
10
9
 
11
- ## 실행 흐름
10
+ ---
12
11
 
13
- ```
14
- $ARGUMENTS 있음 → 해당 지시 우선 수행
15
- $ARGUMENTS 없음 → 기본 동작:
16
- 1. git status + git diff (병렬 실행)
17
- 2. 논리적 단위로 분리하여 git add + git commit
18
- 3. git status (완료 확인)
19
- ```
12
+ <critical_requirements>
20
13
 
21
- ## 병렬 실행
14
+ ## ⚠️ CRITICAL: 작업 시작 전 필수 확인
22
15
 
23
- **초기 분석 단계에서 병렬 실행 필수:**
16
+ **이 커맨드는 반드시 @git-operator 에이전트를 사용해야 합니다.**
24
17
 
25
- ```bash
26
- # 동시에 실행 (두 Bash 호출을 하나의 응답에서)
27
- git status
28
- git diff
18
+ ### MANDATORY: Task 도구로 @git-operator 호출
19
+
20
+ ```typescript
21
+ Task({
22
+ subagent_type: 'git-operator',
23
+ description: 'Git 커밋 작업',
24
+ prompt: `
25
+ $ARGUMENTS 처리:
26
+ [사용자 인수 또는 기본 동작 설명]
27
+ `
28
+ })
29
29
  ```
30
30
 
31
- ## CRITICAL: 절대 금지
32
-
33
- | 금지 항목 |
34
- |----------|
35
- | "Generated with Claude Code" 포함 |
36
- | "🤖" 또는 AI 관련 이모지 |
37
- | "Co-Authored-By:" 헤더 |
38
- | AI/봇 작성 표시 일체 |
39
- | 여러 줄 커밋 메시지 |
40
- | 커밋 메시지에 마침표(.) |
41
- | 여러 작업 하나로 퉁치기 |
42
-
43
- ## 커밋 규칙
44
-
45
- **형식**: `<prefix>: <설명>` (한 줄, 본문/푸터 없음)
46
-
47
- **핵심 원칙**: 하나의 커밋 = 하나의 논리적 변경
48
-
49
- ### Prefix
50
-
51
- | Prefix | 용도 |
52
- |--------|------|
53
- | feat | 새 기능 |
54
- | fix | 버그 수정 |
55
- | refactor | 리팩토링 |
56
- | style | 코드 스타일 |
57
- | docs | 문서 수정 |
58
- | test | 테스트 |
59
- | chore | 빌드/설정 |
60
- | perf | 성능 개선 |
61
- | ci | CI/CD |
62
-
63
- ### 분리 기준
64
-
65
- | 분리 필요 | 묶어도 됨 |
66
- |----------|----------|
67
- | 서로 다른 기능 | 동일 기능의 관련 파일들 |
68
- | 버그 수정 + 새 기능 | 동일 기능의 타입 + 구현 |
69
- | 코드 변경 + 문서 변경 | |
70
- | 리팩토링 + 기능 추가 | |
71
-
72
- ## 예시
73
-
74
- ```bash
75
- # ✅ 올바른
76
- feat: 사용자 로그인 기능 추가
77
- fix: 세션 만료 오류 수정
78
- refactor: 서비스 클래스 구조 개선
79
-
80
- # ❌ 잘못된
81
- 사용자 인증 기능 추가함 # prefix 없음
82
- feat: 사용자 인증 추가. # 마침표
83
- FEAT: 사용자 인증 추가 # 대문자
84
- feat(auth): 인증 추가 # scope 불필요
85
- feat: 로그인, 회원가입, 프로필 # 여러 작업 퉁침
31
+ **❌ 절대 금지:**
32
+ - Bash 도구로 git 명령 직접 실행
33
+ - @git-operator 없이 커밋/푸시 수행
34
+ - 커맨드 내에서 직접 파일 분석
35
+
36
+ **✅ 필수:**
37
+ - Task 도구로 @git-operator 에이전트 호출
38
+ - 모든 git 작업을 에이전트에 위임
39
+
40
+ ---
41
+
42
+ **진행 전 자가 점검:**
43
+ ```text
44
+ □ Task 도구 사용 준비?
45
+ @git-operator 에이전트로 작업 위임?
46
+ □ Bash로 git 직접 실행 안 함?
86
47
  ```
48
+
49
+ **⚠️ 위 체크리스트를 통과하지 않으면 작업을 시작하지 마세요.**
50
+
51
+ </critical_requirements>
52
+
53
+ ---
54
+
55
+ <mode>
56
+
57
+ **기본 모드**: 선택적 커밋
58
+
59
+ - 일부 변경사항만 커밋 가능
60
+ - 푸시는 선택적 (명시 시에만)
61
+
62
+ </mode>
63
+
64
+ ---
65
+
66
+ <arguments>
67
+
68
+ **$ARGUMENTS 있음**: 해당 지시사항 우선 수행
69
+
70
+ | 예시 | 동작 |
71
+ |------|------|
72
+ | `push` | 커밋 후 푸시 |
73
+ | `pull` | git pull 먼저 실행 |
74
+ | `로그인 기능만` | 해당 파일만 커밋 |
75
+
76
+ **$ARGUMENTS 없음**: 기본 동작
77
+
78
+ 1. git status, git diff 분석
79
+ 2. 논리적 단위로 그룹핑
80
+ 3. 선택적 커밋
81
+
82
+ </arguments>