@kood/claude-code 0.3.7 → 0.3.9

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 (121) hide show
  1. package/dist/index.js +1 -1
  2. package/package.json +1 -1
  3. package/templates/.claude/agents/code-reviewer.md +138 -123
  4. package/templates/.claude/agents/dependency-manager.md +99 -84
  5. package/templates/.claude/agents/deployment-validator.md +70 -55
  6. package/templates/.claude/agents/git-operator.md +78 -63
  7. package/templates/.claude/agents/implementation-executor.md +109 -94
  8. package/templates/.claude/agents/ko-to-en-translator.md +74 -0
  9. package/templates/.claude/agents/lint-fixer.md +93 -78
  10. package/templates/.claude/agents/refactor-advisor.md +136 -121
  11. package/templates/.claude/commands/agent-creator.md +199 -184
  12. package/templates/.claude/commands/bug-fix.md +207 -192
  13. package/templates/.claude/commands/command-creator.md +69 -53
  14. package/templates/.claude/commands/docs-creator.md +72 -56
  15. package/templates/.claude/commands/docs-refactor.md +41 -25
  16. package/templates/.claude/commands/execute.md +27 -11
  17. package/templates/.claude/commands/git-all.md +46 -31
  18. package/templates/.claude/commands/git-session.md +57 -41
  19. package/templates/.claude/commands/git.md +49 -33
  20. package/templates/.claude/commands/lint-fix.md +153 -137
  21. package/templates/.claude/commands/lint-init.md +76 -60
  22. package/templates/.claude/commands/plan.md +275 -259
  23. package/templates/.claude/commands/prd.md +39 -23
  24. package/templates/.claude/commands/pre-deploy.md +124 -108
  25. package/templates/.claude/commands/refactor.md +162 -146
  26. package/templates/.claude/commands/version-update.md +32 -16
  27. package/templates/hono/CLAUDE.md +28 -27
  28. package/templates/hono/docs/architecture.md +24 -24
  29. package/templates/hono/docs/deployment/cloudflare.md +18 -18
  30. package/templates/hono/docs/deployment/docker.md +13 -13
  31. package/templates/hono/docs/deployment/index.md +19 -19
  32. package/templates/hono/docs/deployment/railway.md +32 -32
  33. package/templates/hono/docs/deployment/vercel.md +29 -29
  34. package/templates/hono/docs/guides/conventions.md +57 -57
  35. package/templates/hono/docs/guides/env-setup.md +47 -47
  36. package/templates/hono/docs/guides/getting-started.md +27 -27
  37. package/templates/hono/docs/library/hono/error-handling.md +11 -11
  38. package/templates/hono/docs/library/hono/index.md +4 -4
  39. package/templates/hono/docs/library/hono/middleware.md +18 -18
  40. package/templates/hono/docs/library/hono/rpc.md +7 -7
  41. package/templates/hono/docs/library/hono/validation.md +6 -6
  42. package/templates/hono/docs/library/prisma/cloudflare-d1.md +29 -29
  43. package/templates/hono/docs/library/prisma/config.md +16 -16
  44. package/templates/hono/docs/library/prisma/index.md +32 -32
  45. package/templates/hono/docs/library/t3-env/index.md +22 -22
  46. package/templates/hono/docs/library/zod/index.md +31 -31
  47. package/templates/nextjs/CLAUDE.md +54 -51
  48. package/templates/nextjs/docs/architecture.md +812 -0
  49. package/templates/nextjs/docs/design.md +183 -183
  50. package/templates/nextjs/docs/guides/conventions.md +86 -86
  51. package/templates/nextjs/docs/guides/getting-started.md +28 -28
  52. package/templates/nextjs/docs/guides/routes.md +32 -32
  53. package/templates/nextjs/docs/library/better-auth/index.md +70 -70
  54. package/templates/nextjs/docs/library/nextjs/app-router.md +43 -43
  55. package/templates/nextjs/docs/library/nextjs/caching.md +73 -73
  56. package/templates/nextjs/docs/library/nextjs/index.md +51 -51
  57. package/templates/nextjs/docs/library/nextjs/middleware.md +41 -41
  58. package/templates/nextjs/docs/library/nextjs/route-handlers.md +31 -31
  59. package/templates/nextjs/docs/library/nextjs/server-actions.md +34 -34
  60. package/templates/nextjs/docs/library/prisma/cloudflare-d1.md +20 -20
  61. package/templates/nextjs/docs/library/prisma/config.md +18 -18
  62. package/templates/nextjs/docs/library/prisma/crud.md +17 -17
  63. package/templates/nextjs/docs/library/prisma/index.md +18 -18
  64. package/templates/nextjs/docs/library/prisma/relations.md +16 -16
  65. package/templates/nextjs/docs/library/prisma/schema.md +23 -23
  66. package/templates/nextjs/docs/library/prisma/setup.md +6 -6
  67. package/templates/nextjs/docs/library/prisma/transactions.md +10 -10
  68. package/templates/nextjs/docs/library/tanstack-query/index.md +6 -6
  69. package/templates/nextjs/docs/library/tanstack-query/invalidation.md +20 -20
  70. package/templates/nextjs/docs/library/tanstack-query/optimistic-updates.md +4 -4
  71. package/templates/nextjs/docs/library/tanstack-query/use-mutation.md +15 -15
  72. package/templates/nextjs/docs/library/tanstack-query/use-query.md +22 -22
  73. package/templates/nextjs/docs/library/zod/complex-types.md +11 -11
  74. package/templates/nextjs/docs/library/zod/index.md +8 -8
  75. package/templates/nextjs/docs/library/zod/transforms.md +11 -11
  76. package/templates/nextjs/docs/library/zod/validation.md +9 -9
  77. package/templates/npx/CLAUDE.md +38 -37
  78. package/templates/npx/docs/library/commander/index.md +12 -12
  79. package/templates/npx/docs/library/fs-extra/index.md +9 -9
  80. package/templates/npx/docs/library/prompts/index.md +3 -3
  81. package/templates/npx/docs/references/patterns.md +12 -12
  82. package/templates/tanstack-start/CLAUDE.md +54 -53
  83. package/templates/tanstack-start/docs/architecture.md +128 -128
  84. package/templates/tanstack-start/docs/design.md +169 -169
  85. package/templates/tanstack-start/docs/guides/conventions.md +43 -43
  86. package/templates/tanstack-start/docs/guides/env-setup.md +35 -35
  87. package/templates/tanstack-start/docs/guides/getting-started.md +19 -19
  88. package/templates/tanstack-start/docs/guides/hooks.md +45 -45
  89. package/templates/tanstack-start/docs/guides/routes.md +54 -54
  90. package/templates/tanstack-start/docs/guides/services.md +45 -45
  91. package/templates/tanstack-start/docs/library/better-auth/index.md +68 -68
  92. package/templates/tanstack-start/docs/library/prisma/cloudflare-d1.md +19 -19
  93. package/templates/tanstack-start/docs/library/prisma/config.md +16 -16
  94. package/templates/tanstack-start/docs/library/prisma/crud.md +17 -17
  95. package/templates/tanstack-start/docs/library/prisma/index.md +17 -17
  96. package/templates/tanstack-start/docs/library/prisma/relations.md +16 -16
  97. package/templates/tanstack-start/docs/library/prisma/schema.md +23 -23
  98. package/templates/tanstack-start/docs/library/prisma/setup.md +6 -6
  99. package/templates/tanstack-start/docs/library/prisma/transactions.md +10 -10
  100. package/templates/tanstack-start/docs/library/t3-env/index.md +21 -160
  101. package/templates/tanstack-start/docs/library/tanstack-query/index.md +6 -6
  102. package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md +19 -19
  103. package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md +4 -4
  104. package/templates/tanstack-start/docs/library/tanstack-query/use-mutation.md +14 -14
  105. package/templates/tanstack-start/docs/library/tanstack-query/use-query.md +21 -21
  106. package/templates/tanstack-start/docs/library/tanstack-router/error-handling.md +9 -9
  107. package/templates/tanstack-start/docs/library/tanstack-router/hooks.md +11 -11
  108. package/templates/tanstack-start/docs/library/tanstack-router/index.md +18 -18
  109. package/templates/tanstack-start/docs/library/tanstack-router/navigation.md +17 -17
  110. package/templates/tanstack-start/docs/library/tanstack-router/route-context.md +5 -5
  111. package/templates/tanstack-start/docs/library/tanstack-router/search-params.md +10 -10
  112. package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md +8 -8
  113. package/templates/tanstack-start/docs/library/tanstack-start/index.md +15 -15
  114. package/templates/tanstack-start/docs/library/tanstack-start/middleware.md +9 -9
  115. package/templates/tanstack-start/docs/library/tanstack-start/routing.md +6 -6
  116. package/templates/tanstack-start/docs/library/tanstack-start/server-functions.md +18 -18
  117. package/templates/tanstack-start/docs/library/tanstack-start/setup.md +4 -4
  118. package/templates/tanstack-start/docs/library/zod/complex-types.md +11 -11
  119. package/templates/tanstack-start/docs/library/zod/index.md +8 -8
  120. package/templates/tanstack-start/docs/library/zod/transforms.md +11 -11
  121. package/templates/tanstack-start/docs/library/zod/validation.md +9 -9
@@ -1,33 +1,49 @@
1
1
  ---
2
2
  description: 개발 진행 방법 검토 및 옵션 제시. ultrathink + sequential thinking 3-7 필수. 코드 수정 없이 계획만.
3
3
  allowed-tools: Read, Glob, Grep, Bash(git:*, ast-grep:*), Task, Write, mcp__sequential-thinking__sequentialthinking
4
- argument-hint: <개발할 기능 또는 해결할 문제>
4
+ argument-hint: <feature to develop or problem to solve>
5
5
  ---
6
6
 
7
+ <critical_instruction>
8
+
9
+ **CRITICAL: 사용자와의 모든 커뮤니케이션은 반드시 한국어로 작성하세요.**
10
+
11
+ - 내부 사고와 분석은 영어로 해도 됨
12
+ - 설명, 요약, 보고서, 피드백 등 사용자에게 전달하는 모든 내용은 반드시 한국어
13
+ - 사용자가 영어로 말하더라도 답변은 한국어로
14
+ - 진행 상황 업데이트와 상태 보고는 반드시 한국어
15
+
16
+ 이 규칙은 절대적이며 예외가 없습니다.
17
+
18
+ </critical_instruction>
19
+
20
+ ---
21
+
22
+
7
23
  # Plan Command
8
24
 
9
- > 개발 진행 방법을 검토하고 2-3 옵션과 장단점을 제시하는 커맨드.
25
+ > Review development approach and present 2-3 options with pros/cons.
10
26
 
11
- **계획 대상**: $ARGUMENTS
27
+ **Planning target**: $ARGUMENTS
12
28
 
13
29
  ---
14
30
 
15
31
  <argument_validation>
16
32
 
17
- ## ARGUMENT 필수 확인
33
+ ## Verify ARGUMENT is provided
18
34
 
19
35
  ```
20
- $ARGUMENTS 없음 즉시 질문:
36
+ No $ARGUMENTS → Ask immediately:
21
37
 
22
- "무엇을 계획해야 하나요? 구체적으로 알려주세요.
38
+ "What should we plan? Please be specific.
23
39
 
24
- 예시:
25
- - 기능 추가
26
- - 버그 수정
27
- - 리팩토링
28
- - 아키텍처 변경"
40
+ Examples:
41
+ - Add new feature
42
+ - Fix bug
43
+ - Refactor
44
+ - Change architecture"
29
45
 
30
- $ARGUMENTS 있음다음 단계 진행
46
+ $ARGUMENTS providedProceed to next step
31
47
  ```
32
48
 
33
49
  </argument_validation>
@@ -36,17 +52,17 @@ $ARGUMENTS 있음 → 다음 단계 진행
36
52
 
37
53
  <workflow>
38
54
 
39
- ## 실행 흐름
55
+ ## Execution Flow
40
56
 
41
- | 단계 | 작업 | 도구 |
57
+ | Step | Task | Tool |
42
58
  |------|------|------|
43
- | 1. 입력 확인 | ARGUMENT 검증, 없으면 질문 | - |
44
- | 2. 복잡도 판단 | Sequential Thinking으로 분석 범위 결정 | sequentialthinking (1단계) |
45
- | 3. 코드베이스 탐색 | 현재 상태 파악, 관련 파일 탐색 | Task (Explore) + Read/Grep |
46
- | 4. 옵션 도출 | 가능한 접근 4-5주요 2-3 선정 | sequentialthinking (2-6단계) |
47
- | 5. 옵션 제시 | 장단점, 영향 범위, 추천안 제시 | - |
48
- | 6. 사용자 선택 | 옵션 선택 대기 | - |
49
- | 7. 문서 작성 | 선택 계획 문서 생성 | Write |
59
+ | 1. Validate input | Verify ARGUMENT, ask if missing | - |
60
+ | 2. Judge complexity | Determine analysis scope with Sequential Thinking | sequentialthinking (step 1) |
61
+ | 3. Explore codebase | Understand current state, explore related files | Task (Explore) + Read/Grep |
62
+ | 4. Derive options | Generate 4-5 possible approaches select 2-3 main | sequentialthinking (steps 2-6) |
63
+ | 5. Present options | Present pros/cons, impact scope, recommendation | - |
64
+ | 6. User selection | Wait for option selection | - |
65
+ | 7. Document generation | Generate plan document when selected | Write |
50
66
 
51
67
  </workflow>
52
68
 
@@ -54,49 +70,49 @@ $ARGUMENTS 있음 → 다음 단계 진행
54
70
 
55
71
  <agent_usage>
56
72
 
57
- ## @refactor-advisor Agent 활용
73
+ ## @refactor-advisor Agent Usage
58
74
 
59
- **언제 사용:**
60
- - 리팩토링 계획 수립
61
- - 코드 품질 개선 필요
62
- - 복잡도 감소, 중복 제거
75
+ **When to use:**
76
+ - Establish refactoring plan
77
+ - Code quality improvement needed
78
+ - Reduce complexity, remove duplication
63
79
 
64
- **호출 방법:**
80
+ **How to call:**
65
81
  ```bash
66
82
  @refactor-advisor
67
- # 또는 자연어
68
- " 코드 리팩토링 계획 세워줘"
69
- "코드 개선점 분석해줘"
83
+ # or natural language
84
+ "Create refactoring plan for this code"
85
+ "Analyze code improvements"
70
86
  ```
71
87
 
72
- **장점:**
73
- - 복잡도, 중복, 패턴 자동 분석
74
- - Sequential Thinking으로 개선점 도출 (3-5단계)
75
- - 우선순위별 리팩토링 계획 (High/Medium/Low)
76
- - 구체적 Before/After 코드 예시
77
- - 점진적 변경 단계 제안
78
-
79
- **분석 영역:**
80
- - 복잡도 (함수 길이, 중첩 깊이)
81
- - 중복 (동일/유사 코드)
82
- - 명명 (변수/함수명)
83
- - 구조 (파일/모듈)
84
- - 패턴 (안티패턴)
85
- - 타입 (any 제거)
86
-
87
- **plan command와의 차이:**
88
- - plan: 기능/아키텍처 변경 계획
89
- - @refactor-advisor: 기존 코드 개선 계획 (기능 변경 없음)
90
-
91
- **리팩토링 실행:**
88
+ **Benefits:**
89
+ - Auto-analyze complexity, duplication, patterns
90
+ - Derive improvements with Sequential Thinking (3-5 steps)
91
+ - Prioritized refactoring plan (High/Medium/Low)
92
+ - Concrete Before/After code examples
93
+ - Propose incremental change stages
94
+
95
+ **Analysis areas:**
96
+ - Complexity (function length, nesting depth)
97
+ - Duplication (identical/similar code)
98
+ - Naming (variable/function names)
99
+ - Structure (files/modules)
100
+ - Patterns (anti-patterns)
101
+ - Types (remove any)
102
+
103
+ **Difference from plan command:**
104
+ - plan: New feature/architecture change planning
105
+ - @refactor-advisor: Existing code improvement planning (no feature change)
106
+
107
+ **After refactoring execution:**
92
108
  ```bash
93
- # 1. 리팩토링 계획
109
+ # 1. Refactoring plan
94
110
  @refactor-advisor
95
111
 
96
- # 2. 계획 승인 구현
112
+ # 2. After plan approval, implement
97
113
  @implementation-executor
98
114
 
99
- # 3. 검증
115
+ # 3. Validation
100
116
  @deployment-validator
101
117
  ```
102
118
 
@@ -106,55 +122,55 @@ $ARGUMENTS 있음 → 다음 단계 진행
106
122
 
107
123
  <thinking_strategy>
108
124
 
109
- ## Sequential Thinking 가이드
125
+ ## Sequential Thinking Guide
110
126
 
111
- ### 복잡도 판단 (thought 1)
127
+ ### Judge complexity (thought 1)
112
128
 
113
129
  ```
114
- thought 1: 복잡도 판단
115
- - 영향 범위: 파일 수, 모듈
116
- - 의존성: 외부 라이브러리, 다른 시스템 연동
117
- - 리스크: 기존 기능 영향, 롤백 가능성
118
- - 기술적 난이도: 새로운 패턴, 미지의 영역
130
+ thought 1: Judge complexity
131
+ - Impact scope: number of files, modules
132
+ - Dependencies: external libraries, system integration
133
+ - Risk: impact on existing features, rollback possibility
134
+ - Technical difficulty: new patterns, unknown areas
119
135
  ```
120
136
 
121
- ### 복잡도별 전략
137
+ ### Strategy by complexity
122
138
 
123
- | 복잡도 | 사고 횟수 | 판단 기준 | 사고 패턴 |
124
- |--------|----------|----------|----------|
125
- | **간단** | 3 | 1-2 파일, 명확한 변경 | 복잡도 판단현재 상태옵션 도출 |
126
- | **보통** | 5 | 3-5 파일, 로직 변경 | 복잡도 판단현재 상태접근 방식 탐색 옵션 비교추천안 |
127
- | **복잡** | 7+ | 다중 모듈, 아키텍처 변경 | 복잡도 판단심층 분석제약사항접근 방식 비교상세 분석추천안 |
139
+ | Complexity | Thoughts | Criteria | Pattern |
140
+ |------------|----------|----------|---------|
141
+ | **Simple** | 3 | 1-2 files, clear changes | Judge complexitycurrent statederive options |
142
+ | **Medium** | 5 | 3-5 files, logic changes | Judge complexitycurrent stateexplore approachescompare optionsrecommendation |
143
+ | **Complex** | 7+ | multiple modules, architecture change | Judge complexitydeep analysisconstraintsapproachescomparedetailed analysisrecommendation |
128
144
 
129
- ### 보통 복잡도 패턴 (5단계)
145
+ ### Medium complexity pattern (5 steps)
130
146
 
131
147
  ```
132
- thought 1: 복잡도 판단 분석 범위 결정
133
- thought 2: 현재 상태 분석 (코드, 아키텍처, 제약)
134
- thought 3: 가능한 접근 방식 열거 (4-5)
135
- thought 4: 주요 옵션 3 선정 장단점 분석
136
- thought 5: 최종 옵션 정리 추천안 도출
148
+ thought 1: Judge complexity and determine analysis scope
149
+ thought 2: Analyze current state (code, architecture, constraints)
150
+ thought 3: Enumerate possible approaches (4-5)
151
+ thought 4: Select 3 main options and analyze pros/cons
152
+ thought 5: Finalize options and derive recommendation
137
153
  ```
138
154
 
139
- ### 복잡한 경우 패턴 (7단계)
155
+ ### Complex case pattern (7 steps)
140
156
 
141
157
  ```
142
- thought 1: 복잡도 판단
143
- thought 2: 현재 상태 심층 분석
144
- thought 3: 기술적 제약 요구사항 정리
145
- thought 4: 가능한 접근 방식 탐색
146
- thought 5: 접근 방식 비교 분석
147
- thought 6: 옵션 3 선정 상세 장단점
148
- thought 7: 추천안 근거
158
+ thought 1: Judge complexity
159
+ thought 2: Deep analysis of current state
160
+ thought 3: Summarize technical constraints and requirements
161
+ thought 4: Explore possible approaches
162
+ thought 5: Comparative analysis of each approach
163
+ thought 6: Select 3 options and detailed pros/cons
164
+ thought 7: Recommendation and rationale
149
165
  ```
150
166
 
151
- ### 핵심 원칙
167
+ ### Key principles
152
168
 
153
169
  ```text
154
- 사고 과정을 출력해야 실제로 생각이 일어남
155
- 복잡도가 불확실하면 높게 책정 (5→7로 확장 가능)
156
- thought에서 구체적 분석 필요 (추상적 설명 금지)
157
- 필요 isRevision으로 이전 사고 수정
170
+ Output thinking process to actually think
171
+ Estimate high if complexity uncertain (can expand 5→7)
172
+ Concrete analysis needed per thought (no abstract descriptions)
173
+ Revise previous thoughts with isRevision if needed
158
174
  ```
159
175
 
160
176
  </thinking_strategy>
@@ -163,63 +179,63 @@ thought 7: 추천안 및 근거
163
179
 
164
180
  <codebase_exploration>
165
181
 
166
- ## Task Subagent 활용
182
+ ## Task Subagent Usage
167
183
 
168
- ### Subagent 선택
184
+ ### Subagent selection
169
185
 
170
- | subagent_type | 용도 | 예시 |
171
- |---------------|------|------|
172
- | **Explore** | 코드베이스 구조 파악, 관련 파일 탐색 | "현재 인증 구조 분석" |
173
- | **Plan** | 구현 전략 수립, 단계별 계획 | "마이그레이션 계획 수립" |
174
- | **general-purpose** | 복잡한 분석, 다중 시스템 연관 | "여러 모듈 의존성 분석" |
186
+ | subagent_type | Purpose | Example |
187
+ |---------------|---------|---------|
188
+ | **Explore** | Understand codebase structure, explore related files | "Analyze current auth structure" |
189
+ | **Plan** | Establish implementation strategy, step-by-step planning | "Create migration plan" |
190
+ | **general-purpose** | Complex analysis, multi-system correlation | "Analyze dependencies between modules" |
175
191
 
176
- ### Task 호출 패턴
192
+ ### Task call patterns
177
193
 
178
- **단일 탐색:**
194
+ **Single exploration:**
179
195
 
180
196
  ```typescript
181
197
  Task({
182
198
  subagent_type: 'Explore',
183
- description: '현재 인증 구조 분석',
199
+ description: 'Analyze current auth structure',
184
200
  prompt: `
185
- 현재 인증 관련 코드 구조 파악.
186
- - 사용 중인 라이브러리
187
- - 세션 관리 방식
188
- - 수정이 필요한 파일 목록
201
+ Understand current authentication-related code structure.
202
+ - Libraries in use
203
+ - Session management approach
204
+ - Files needing modification
189
205
  `
190
206
  })
191
207
  ```
192
208
 
193
- **병렬 탐색 (복잡한 경우):**
209
+ **Parallel exploration (complex cases):**
194
210
 
195
211
  ```typescript
196
- // 단일 메시지에 다중 Task 호출
212
+ // Multiple Task calls in single message
197
213
  Task({
198
214
  subagent_type: 'Explore',
199
- prompt: '프론트엔드 인증 구조 분석'
215
+ prompt: 'Analyze frontend auth structure'
200
216
  })
201
217
 
202
218
  Task({
203
219
  subagent_type: 'Explore',
204
- prompt: '백엔드 API 인증 엔드포인트 분석'
220
+ prompt: 'Analyze backend API auth endpoints'
205
221
  })
206
222
 
207
223
  Task({
208
224
  subagent_type: 'Explore',
209
- prompt: '데이터베이스 세션 스키마 분석'
225
+ prompt: 'Analyze database session schema'
210
226
  })
211
227
 
212
- // → 결과 취합 옵션 정리
228
+ // → Combine results then organize options
213
229
  ```
214
230
 
215
- ### 탐색 체크리스트
231
+ ### Exploration checklist
216
232
 
217
233
  ```text
218
- 현재 구현 방식 파악
219
- 사용 중인 라이브러리/프레임워크 버전
220
- 관련 파일 디렉토리 위치
221
- 의존성 연관 모듈
222
- 기존 제약사항 (보안, 성능, 호환성)
234
+ Understand current implementation approach
235
+ Libraries/framework versions in use
236
+ Related file and directory locations
237
+ Dependencies and related modules
238
+ Existing constraints (security, performance, compatibility)
223
239
  ```
224
240
 
225
241
  </codebase_exploration>
@@ -228,75 +244,75 @@ Task({
228
244
 
229
245
  <option_presentation>
230
246
 
231
- ## 옵션 제시 형식
247
+ ## Option presentation format
232
248
 
233
- ### 옵션 3 제시 (표준)
249
+ ### Present 3 options (standard)
234
250
 
235
251
  ```markdown
236
- ## 분석 결과
252
+ ## Analysis Results
237
253
 
238
- ### 옵션 1: [옵션 이름] (추천)
254
+ ### Option 1: [Option name] (Recommended)
239
255
 
240
- **접근 방식:**
241
- - 설명 1
242
- - 설명 2
256
+ **Approach:**
257
+ - Description 1
258
+ - Description 2
243
259
 
244
- | 장점 | 단점 |
260
+ | Pros | Cons |
245
261
  |------|------|
246
- | 장점 1 | 단점 1 |
247
- | 장점 2 | 단점 2 |
262
+ | Pro 1 | Con 1 |
263
+ | Pro 2 | Con 2 |
248
264
 
249
- **영향 범위:**
250
- - 파일: `src/auth/`, `src/api/`
251
- - 예상 변경 규모: 중간
252
- - 리스크: 낮음
265
+ **Impact scope:**
266
+ - Files: `src/auth/`, `src/api/`
267
+ - Expected change size: Medium
268
+ - Risk: Low
253
269
 
254
270
  ---
255
271
 
256
- ### 옵션 2: [옵션 이름]
272
+ ### Option 2: [Option name]
257
273
 
258
- **접근 방식:**
274
+ **Approach:**
259
275
  ...
260
276
 
261
- | 장점 | 단점 |
277
+ | Pros | Cons |
262
278
  |------|------|
263
279
  | ... | ... |
264
280
 
265
- **영향 범위:**
281
+ **Impact scope:**
266
282
  ...
267
283
 
268
284
  ---
269
285
 
270
- ### 옵션 3: [옵션 이름]
286
+ ### Option 3: [Option name]
271
287
 
272
- **접근 방식:**
288
+ **Approach:**
273
289
  ...
274
290
 
275
291
  ---
276
292
 
277
- ## 추천 근거
293
+ ## Recommendation and rationale
278
294
 
279
- 옵션 1을 추천합니다.
280
- - 근거 1
281
- - 근거 2
295
+ I recommend Option 1.
296
+ - Rationale 1
297
+ - Rationale 2
282
298
 
283
- 어떤 옵션을 선택하시겠습니까? (1/2/3)
299
+ Which option would you choose? (1/2/3)
284
300
  ```
285
301
 
286
- ### 옵션 2 제시 (선택지가 명확한 경우)
302
+ ### Present 2 options (when choices are clear)
287
303
 
288
304
  ```markdown
289
- ## 분석 결과
305
+ ## Analysis Results
290
306
 
291
- 가지 접근 방식이 있습니다:
307
+ There are two approaches:
292
308
 
293
- ### 옵션 A: [옵션 이름]
309
+ ### Option A: [Option name]
294
310
  ...
295
311
 
296
- ### 옵션 B: [옵션 이름]
312
+ ### Option B: [Option name]
297
313
  ...
298
314
 
299
- 어떤 옵션을 선택하시겠습니까? (A/B)
315
+ Which option would you choose? (A/B)
300
316
  ```
301
317
 
302
318
  </option_presentation>
@@ -305,90 +321,90 @@ Task({
305
321
 
306
322
  <document_generation>
307
323
 
308
- ## 문서 작성
324
+ ## Document generation
309
325
 
310
- ### 문서 작성 질문
326
+ ### Document creation question
311
327
 
312
328
  ```
313
- 옵션 [N]을 선택하셨습니다.
329
+ You selected Option [N].
314
330
 
315
- 계획 문서를 작성할까요?
316
- - Y: .claude/plans/[기능명].md 생성
317
- - N: 바로 구현 시작
331
+ Would you like to create a plan document?
332
+ - Y: Create .claude/plans/[feature-name].md
333
+ - N: Start implementation directly
318
334
 
319
- 선택해주세요. (Y/N)
335
+ Please choose. (Y/N)
320
336
  ```
321
337
 
322
- ### 계획 문서 템플릿
338
+ ### Plan document template
323
339
 
324
- **파일 위치:** `.claude/plans/[기능명].md`
340
+ **File location:** `.claude/plans/[feature-name].md`
325
341
 
326
342
  ```markdown
327
- # [기능명] 구현 계획
343
+ # [Feature name] Implementation Plan
328
344
 
329
- ## 개요
345
+ ## Overview
330
346
 
331
- **목표:** [무엇을 달성할 것인가]
332
- **선택된 접근 방식:** [옵션 N]
333
- **예상 영향 범위:** [파일/모듈 목록]
347
+ **Goal:** [What will be achieved]
348
+ **Selected approach:** [Option N]
349
+ **Expected impact scope:** [Files/modules list]
334
350
 
335
- ## 현재 상태
351
+ ## Current state
336
352
 
337
- - 현재 구조 설명
338
- - 관련 코드 위치
339
- - 기존 제약사항
353
+ - Current structure description
354
+ - Related code location
355
+ - Existing constraints
340
356
 
341
- ## 구현 단계
357
+ ## Implementation stages
342
358
 
343
- ### 1단계: [단계 이름]
359
+ ### Stage 1: [Stage name]
344
360
 
345
- **작업:**
346
- - [ ] 작업 1
347
- - [ ] 작업 2
361
+ **Tasks:**
362
+ - [ ] Task 1
363
+ - [ ] Task 2
348
364
 
349
- **변경 파일:**
365
+ **Changed files:**
350
366
  - `src/file1.ts`
351
367
  - `src/file2.ts`
352
368
 
353
- ### 2단계: [단계 이름]
369
+ ### Stage 2: [Stage name]
354
370
 
355
- **작업:**
356
- - [ ] 작업 3
371
+ **Tasks:**
372
+ - [ ] Task 3
357
373
 
358
- **변경 파일:**
374
+ **Changed files:**
359
375
  - `src/file3.ts`
360
376
 
361
- ### 3단계: [단계 이름]
377
+ ### Stage 3: [Stage name]
362
378
  ...
363
379
 
364
- ## 고려사항
380
+ ## Considerations
365
381
 
366
- ### 리스크
382
+ ### Risks
367
383
 
368
- | 리스크 | 완화 방안 |
369
- |--------|----------|
370
- | 리스크 1 | 방안 1 |
371
- | 리스크 2 | 방안 2 |
384
+ | Risk | Mitigation |
385
+ |------|-----------|
386
+ | Risk 1 | Plan 1 |
387
+ | Risk 2 | Plan 2 |
372
388
 
373
- ### 의존성
389
+ ### Dependencies
374
390
 
375
- - 외부 라이브러리: [목록]
376
- - 다른 시스템: [목록]
391
+ - External libraries: [List]
392
+ - Other systems: [List]
377
393
 
378
- ### 롤백 계획
394
+ ### Rollback plan
379
395
 
380
- 문제 발생 롤백 방법.
396
+ How to rollback if issues occur.
381
397
 
382
- ## 검증 방법
398
+ ## Validation methods
383
399
 
384
- - 테스트 항목 1
385
- - 테스트 항목 2
386
- - 통합 테스트
400
+ - Test item 1
401
+ - Test item 2
402
+ - Integration test
387
403
 
388
- ## 참조
404
+ ## References
389
405
 
390
- - 관련 문서 링크
391
- - 참고 자료
406
+ - Related document links
407
+ - Reference materials
392
408
  ```
393
409
 
394
410
  </document_generation>
@@ -397,29 +413,29 @@ Task({
397
413
 
398
414
  <validation>
399
415
 
400
- ## 검증 체크리스트
416
+ ## Validation checklist
401
417
 
402
- 실행 전 확인:
418
+ Before execution:
403
419
 
404
420
  ```text
405
- ✅ ARGUMENT 확인 (없으면 질문)
406
- ✅ Sequential Thinking 최소 3단계
407
- ✅ Task (Explore)로 코드베이스 탐색
408
- 옵션 최소 2개, 권장 3
409
- 옵션에 장단점 명시
410
- 영향 범위 예상 작업량 제시
421
+ Verify ARGUMENT (ask if missing)
422
+ ✅ Sequential Thinking minimum 3 steps
423
+ Explore codebase with Task (Explore)
424
+ Minimum 2 options, recommended 3
425
+ List pros/cons for each option
426
+ Present impact scope and estimated work
411
427
  ```
412
428
 
413
- 절대 금지:
429
+ Absolutely forbidden:
414
430
 
415
431
  ```text
416
- ARGUMENT 없이 분석 시작
417
- ❌ Edit 도구 사용 (코드 수정 금지)
418
- ❌ Sequential Thinking 3단계 미만
419
- 옵션 1개만 제시
420
- 코드 탐색 없이 추측으로 옵션 제시
421
- 사용자 선택 없이 구현 시작
422
- 장단점 없이 옵션만 나열
432
+ Start analysis without ARGUMENT
433
+ Use Edit tool (code modification forbidden)
434
+ ❌ Sequential Thinking less than 3 steps
435
+ Present only 1 option
436
+ Suggest options by guessing without code exploration
437
+ Start implementation without user choice
438
+ List options without pros/cons
423
439
  ```
424
440
 
425
441
  </validation>
@@ -428,88 +444,88 @@ Task({
428
444
 
429
445
  <examples>
430
446
 
431
- ## 실전 예시
447
+ ## Real-world examples
432
448
 
433
- ### 예시 1: 인증 시스템 변경
449
+ ### Example 1: Change auth system
434
450
 
435
451
  ```bash
436
- 사용자: /plan 사용자 인증을 JWT에서 세션 기반으로 변경
452
+ User: /plan Change user authentication from JWT to session-based
437
453
 
438
- 1. Sequential Thinking (7단계):
439
- thought 1: "인증 시스템 변경 - 복잡도 높음, 다중 모듈 영향"
440
- thought 2: "현재 JWT 구현 분석: src/auth/jwt.ts, 토큰 검증 미들웨어"
441
- thought 3: "제약사항: 기존 사용자 세션 유지, Redis/DB 선택"
442
- thought 4: "접근 방식: 점진적 마이그레이션, 완전 대체, 하이브리드"
443
- thought 5: "점진적이 리스크 낮음, 하이브리드는 복잡도 높음"
444
- thought 6: "옵션 3 선정 장단점 분석"
445
- thought 7: "점진적 마이그레이션 추천 - 롤백 용이, 단계적 검증"
454
+ 1. Sequential Thinking (7 steps):
455
+ thought 1: "Auth system change - high complexity, multiple module impact"
456
+ thought 2: "Current JWT implementation analysis: src/auth/jwt.ts, token validation middleware"
457
+ thought 3: "Constraints: maintain existing user sessions, Redis/DB choice"
458
+ thought 4: "Approaches: incremental migration, full replacement, hybrid"
459
+ thought 5: "Incremental has low risk, hybrid high complexity"
460
+ thought 6: "Select 3 options and analyze pros/cons"
461
+ thought 7: "Recommend incremental migration - easy rollback, step-by-step validation"
446
462
 
447
- 2. Task 탐색:
448
- Task (Explore): "현재 JWT 인증 구현 분석"
449
- → src/auth/, src/middleware/, API 엔드포인트 파악
463
+ 2. Task exploration:
464
+ Task (Explore): "Analyze current JWT auth implementation"
465
+ Understand src/auth/, src/middleware/, API endpoints
450
466
 
451
- 3. 옵션 제시:
452
- 옵션 1: 점진적 마이그레이션 (추천)
453
- - 장점: 롤백 용이, 리스크 낮음
454
- - 단점: 구현 시간 길어짐
467
+ 3. Present options:
468
+ Option 1: Incremental migration (Recommended)
469
+ - Pro: Easy rollback, low risk
470
+ - Con: Longer implementation time
455
471
 
456
- 옵션 2: 완전 대체
457
- - 장점: 깔끔한 구조
458
- - 단점: 높은 리스크
472
+ Option 2: Full replacement
473
+ - Pro: Clean structure
474
+ - Con: High risk
459
475
 
460
- 옵션 3: 하이브리드 방식
461
- - 장점: 유연성
462
- - 단점: 복잡도 증가
476
+ Option 3: Hybrid approach
477
+ - Pro: Flexibility
478
+ - Con: Increased complexity
463
479
 
464
- 4. 사용자 선택: 1
480
+ 4. User choice: 1
465
481
 
466
- 5. 문서 작성 질문: Y
482
+ 5. Create document question: Y
467
483
 
468
- 6. .claude/plans/session-auth.md 생성
484
+ 6. Create .claude/plans/session-auth.md
469
485
  ```
470
486
 
471
- ### 예시 2: 실시간 알림 기능
487
+ ### Example 2: Add real-time notifications
472
488
 
473
489
  ```bash
474
- 사용자: /plan 실시간 알림 기능 추가
490
+ User: /plan Add real-time notification feature
475
491
 
476
- 1. Sequential Thinking (5단계):
477
- thought 1: "실시간 알림 - 보통 복잡도, 기능 추가"
478
- thought 2: "현재 통신 구조: REST API, 폴링 없음"
479
- thought 3: "접근 방식: WebSocket, SSE, Long Polling, Firebase"
480
- thought 4: "WebSocket 양방향, SSE 단방향이지만 간단"
481
- thought 5: "WebSocket 추천, 폴링은 비효율적"
492
+ 1. Sequential Thinking (5 steps):
493
+ thought 1: "Real-time notifications - medium complexity, new feature"
494
+ thought 2: "Current communication: REST API, no polling"
495
+ thought 3: "Approaches: WebSocket, SSE, Long Polling, Firebase"
496
+ thought 4: "WebSocket bidirectional, SSE unidirectional but simpler"
497
+ thought 5: "Recommend WebSocket, polling inefficient"
482
498
 
483
- 2. Task 탐색:
484
- Task (Explore): "현재 API 구조 클라이언트 통신 방식"
499
+ 2. Task exploration:
500
+ Task (Explore): "Analyze current API structure and client communication"
485
501
 
486
- 3. 옵션:
487
- 옵션 1: WebSocket (추천)
488
- 옵션 2: Server-Sent Events
489
- 옵션 3: Short Polling
502
+ 3. Options:
503
+ Option 1: WebSocket (Recommended)
504
+ Option 2: Server-Sent Events
505
+ Option 3: Short Polling
490
506
 
491
- 4. 선택 계획 문서 생성
507
+ 4. After selection, create plan document
492
508
  ```
493
509
 
494
- ### 예시 3: 간단한 리팩토링
510
+ ### Example 3: Simple refactoring
495
511
 
496
512
  ```bash
497
- 사용자: /plan utils 함수를 TypeScript로 전환
513
+ User: /plan Convert utils functions to TypeScript
498
514
 
499
- 1. Sequential Thinking (3단계):
500
- thought 1: "단순 리팩토링 - 간단, 1-2 파일"
501
- thought 2: "현재 utils.js 분석 필요"
502
- thought 3: "타입 정의전환테스트 검증"
515
+ 1. Sequential Thinking (3 steps):
516
+ thought 1: "Simple refactoring - simple, 1-2 files"
517
+ thought 2: "Need to analyze current utils.js"
518
+ thought 3: "Type definitionconversiontest validation"
503
519
 
504
- 2. Task 탐색:
520
+ 2. Task exploration:
505
521
  Read: src/utils.js
506
- Grep: utils 사용처 검색
522
+ Grep: search utils usages
507
523
 
508
- 3. 옵션:
509
- 옵션 A: 점진적 전환 (파일별)
510
- 옵션 B: 일괄 전환
524
+ 3. Options:
525
+ Option A: Incremental conversion (per file)
526
+ Option B: Batch conversion
511
527
 
512
- 4. 선택구현 (문서 작성 생략 가능)
528
+ 4. After choice implement (skip document creation if possible)
513
529
  ```
514
530
 
515
531
  </examples>