@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.
- package/dist/index.js +1 -1
- package/package.json +1 -1
- package/templates/.claude/agents/code-reviewer.md +138 -123
- package/templates/.claude/agents/dependency-manager.md +99 -84
- package/templates/.claude/agents/deployment-validator.md +70 -55
- package/templates/.claude/agents/git-operator.md +78 -63
- package/templates/.claude/agents/implementation-executor.md +109 -94
- package/templates/.claude/agents/ko-to-en-translator.md +74 -0
- package/templates/.claude/agents/lint-fixer.md +93 -78
- package/templates/.claude/agents/refactor-advisor.md +136 -121
- package/templates/.claude/commands/agent-creator.md +199 -184
- package/templates/.claude/commands/bug-fix.md +207 -192
- package/templates/.claude/commands/command-creator.md +69 -53
- package/templates/.claude/commands/docs-creator.md +72 -56
- package/templates/.claude/commands/docs-refactor.md +41 -25
- package/templates/.claude/commands/execute.md +27 -11
- package/templates/.claude/commands/git-all.md +46 -31
- package/templates/.claude/commands/git-session.md +57 -41
- package/templates/.claude/commands/git.md +49 -33
- package/templates/.claude/commands/lint-fix.md +153 -137
- package/templates/.claude/commands/lint-init.md +76 -60
- package/templates/.claude/commands/plan.md +275 -259
- package/templates/.claude/commands/prd.md +39 -23
- package/templates/.claude/commands/pre-deploy.md +124 -108
- package/templates/.claude/commands/refactor.md +162 -146
- package/templates/.claude/commands/version-update.md +32 -16
- package/templates/hono/CLAUDE.md +28 -27
- package/templates/hono/docs/architecture.md +24 -24
- package/templates/hono/docs/deployment/cloudflare.md +18 -18
- package/templates/hono/docs/deployment/docker.md +13 -13
- package/templates/hono/docs/deployment/index.md +19 -19
- package/templates/hono/docs/deployment/railway.md +32 -32
- package/templates/hono/docs/deployment/vercel.md +29 -29
- package/templates/hono/docs/guides/conventions.md +57 -57
- package/templates/hono/docs/guides/env-setup.md +47 -47
- package/templates/hono/docs/guides/getting-started.md +27 -27
- package/templates/hono/docs/library/hono/error-handling.md +11 -11
- package/templates/hono/docs/library/hono/index.md +4 -4
- package/templates/hono/docs/library/hono/middleware.md +18 -18
- package/templates/hono/docs/library/hono/rpc.md +7 -7
- package/templates/hono/docs/library/hono/validation.md +6 -6
- package/templates/hono/docs/library/prisma/cloudflare-d1.md +29 -29
- package/templates/hono/docs/library/prisma/config.md +16 -16
- package/templates/hono/docs/library/prisma/index.md +32 -32
- package/templates/hono/docs/library/t3-env/index.md +22 -22
- package/templates/hono/docs/library/zod/index.md +31 -31
- package/templates/nextjs/CLAUDE.md +54 -51
- package/templates/nextjs/docs/architecture.md +812 -0
- package/templates/nextjs/docs/design.md +183 -183
- package/templates/nextjs/docs/guides/conventions.md +86 -86
- package/templates/nextjs/docs/guides/getting-started.md +28 -28
- package/templates/nextjs/docs/guides/routes.md +32 -32
- package/templates/nextjs/docs/library/better-auth/index.md +70 -70
- package/templates/nextjs/docs/library/nextjs/app-router.md +43 -43
- package/templates/nextjs/docs/library/nextjs/caching.md +73 -73
- package/templates/nextjs/docs/library/nextjs/index.md +51 -51
- package/templates/nextjs/docs/library/nextjs/middleware.md +41 -41
- package/templates/nextjs/docs/library/nextjs/route-handlers.md +31 -31
- package/templates/nextjs/docs/library/nextjs/server-actions.md +34 -34
- package/templates/nextjs/docs/library/prisma/cloudflare-d1.md +20 -20
- package/templates/nextjs/docs/library/prisma/config.md +18 -18
- package/templates/nextjs/docs/library/prisma/crud.md +17 -17
- package/templates/nextjs/docs/library/prisma/index.md +18 -18
- package/templates/nextjs/docs/library/prisma/relations.md +16 -16
- package/templates/nextjs/docs/library/prisma/schema.md +23 -23
- package/templates/nextjs/docs/library/prisma/setup.md +6 -6
- package/templates/nextjs/docs/library/prisma/transactions.md +10 -10
- package/templates/nextjs/docs/library/tanstack-query/index.md +6 -6
- package/templates/nextjs/docs/library/tanstack-query/invalidation.md +20 -20
- package/templates/nextjs/docs/library/tanstack-query/optimistic-updates.md +4 -4
- package/templates/nextjs/docs/library/tanstack-query/use-mutation.md +15 -15
- package/templates/nextjs/docs/library/tanstack-query/use-query.md +22 -22
- package/templates/nextjs/docs/library/zod/complex-types.md +11 -11
- package/templates/nextjs/docs/library/zod/index.md +8 -8
- package/templates/nextjs/docs/library/zod/transforms.md +11 -11
- package/templates/nextjs/docs/library/zod/validation.md +9 -9
- package/templates/npx/CLAUDE.md +38 -37
- package/templates/npx/docs/library/commander/index.md +12 -12
- package/templates/npx/docs/library/fs-extra/index.md +9 -9
- package/templates/npx/docs/library/prompts/index.md +3 -3
- package/templates/npx/docs/references/patterns.md +12 -12
- package/templates/tanstack-start/CLAUDE.md +54 -53
- package/templates/tanstack-start/docs/architecture.md +128 -128
- package/templates/tanstack-start/docs/design.md +169 -169
- package/templates/tanstack-start/docs/guides/conventions.md +43 -43
- package/templates/tanstack-start/docs/guides/env-setup.md +35 -35
- package/templates/tanstack-start/docs/guides/getting-started.md +19 -19
- package/templates/tanstack-start/docs/guides/hooks.md +45 -45
- package/templates/tanstack-start/docs/guides/routes.md +54 -54
- package/templates/tanstack-start/docs/guides/services.md +45 -45
- package/templates/tanstack-start/docs/library/better-auth/index.md +68 -68
- package/templates/tanstack-start/docs/library/prisma/cloudflare-d1.md +19 -19
- package/templates/tanstack-start/docs/library/prisma/config.md +16 -16
- package/templates/tanstack-start/docs/library/prisma/crud.md +17 -17
- package/templates/tanstack-start/docs/library/prisma/index.md +17 -17
- package/templates/tanstack-start/docs/library/prisma/relations.md +16 -16
- package/templates/tanstack-start/docs/library/prisma/schema.md +23 -23
- package/templates/tanstack-start/docs/library/prisma/setup.md +6 -6
- package/templates/tanstack-start/docs/library/prisma/transactions.md +10 -10
- package/templates/tanstack-start/docs/library/t3-env/index.md +21 -160
- package/templates/tanstack-start/docs/library/tanstack-query/index.md +6 -6
- package/templates/tanstack-start/docs/library/tanstack-query/invalidation.md +19 -19
- package/templates/tanstack-start/docs/library/tanstack-query/optimistic-updates.md +4 -4
- package/templates/tanstack-start/docs/library/tanstack-query/use-mutation.md +14 -14
- package/templates/tanstack-start/docs/library/tanstack-query/use-query.md +21 -21
- package/templates/tanstack-start/docs/library/tanstack-router/error-handling.md +9 -9
- package/templates/tanstack-start/docs/library/tanstack-router/hooks.md +11 -11
- package/templates/tanstack-start/docs/library/tanstack-router/index.md +18 -18
- package/templates/tanstack-start/docs/library/tanstack-router/navigation.md +17 -17
- package/templates/tanstack-start/docs/library/tanstack-router/route-context.md +5 -5
- package/templates/tanstack-start/docs/library/tanstack-router/search-params.md +10 -10
- package/templates/tanstack-start/docs/library/tanstack-start/auth-patterns.md +8 -8
- package/templates/tanstack-start/docs/library/tanstack-start/index.md +15 -15
- package/templates/tanstack-start/docs/library/tanstack-start/middleware.md +9 -9
- package/templates/tanstack-start/docs/library/tanstack-start/routing.md +6 -6
- package/templates/tanstack-start/docs/library/tanstack-start/server-functions.md +18 -18
- package/templates/tanstack-start/docs/library/tanstack-start/setup.md +4 -4
- package/templates/tanstack-start/docs/library/zod/complex-types.md +11 -11
- package/templates/tanstack-start/docs/library/zod/index.md +8 -8
- package/templates/tanstack-start/docs/library/zod/transforms.md +11 -11
- 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
|
-
>
|
|
25
|
+
> Review development approach and present 2-3 options with pros/cons.
|
|
10
26
|
|
|
11
|
-
|
|
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 provided → Proceed 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.
|
|
44
|
-
| 2.
|
|
45
|
-
| 3.
|
|
46
|
-
| 4.
|
|
47
|
-
| 5.
|
|
48
|
-
| 6.
|
|
49
|
-
| 7.
|
|
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
|
|
75
|
-
-
|
|
76
|
-
-
|
|
77
|
-
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
-
|
|
81
|
-
-
|
|
82
|
-
-
|
|
83
|
-
-
|
|
84
|
-
-
|
|
85
|
-
-
|
|
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
|
-
###
|
|
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
|
-
|
|
|
126
|
-
|
|
|
127
|
-
|
|
|
139
|
+
| Complexity | Thoughts | Criteria | Pattern |
|
|
140
|
+
|------------|----------|----------|---------|
|
|
141
|
+
| **Simple** | 3 | 1-2 files, clear changes | Judge complexity → current state → derive options |
|
|
142
|
+
| **Medium** | 5 | 3-5 files, logic changes | Judge complexity → current state → explore approaches → compare options → recommendation |
|
|
143
|
+
| **Complex** | 7+ | multiple modules, architecture change | Judge complexity → deep analysis → constraints → approaches → compare → detailed analysis → recommendation |
|
|
128
144
|
|
|
129
|
-
###
|
|
145
|
+
### Medium complexity pattern (5 steps)
|
|
130
146
|
|
|
131
147
|
```
|
|
132
|
-
thought 1:
|
|
133
|
-
thought 2:
|
|
134
|
-
thought 3:
|
|
135
|
-
thought 4:
|
|
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
|
-
###
|
|
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:
|
|
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
|
-
✅
|
|
156
|
-
✅
|
|
157
|
-
✅
|
|
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
|
-
//
|
|
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: '
|
|
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
|
-
###
|
|
249
|
+
### Present 3 options (standard)
|
|
234
250
|
|
|
235
251
|
```markdown
|
|
236
|
-
##
|
|
252
|
+
## Analysis Results
|
|
237
253
|
|
|
238
|
-
###
|
|
254
|
+
### Option 1: [Option name] (Recommended)
|
|
239
255
|
|
|
240
|
-
|
|
241
|
-
-
|
|
242
|
-
-
|
|
256
|
+
**Approach:**
|
|
257
|
+
- Description 1
|
|
258
|
+
- Description 2
|
|
243
259
|
|
|
244
|
-
|
|
|
260
|
+
| Pros | Cons |
|
|
245
261
|
|------|------|
|
|
246
|
-
|
|
|
247
|
-
|
|
|
262
|
+
| Pro 1 | Con 1 |
|
|
263
|
+
| Pro 2 | Con 2 |
|
|
248
264
|
|
|
249
|
-
|
|
250
|
-
-
|
|
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
|
-
###
|
|
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
|
-
###
|
|
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
|
-
|
|
280
|
-
-
|
|
281
|
-
-
|
|
295
|
+
I recommend Option 1.
|
|
296
|
+
- Rationale 1
|
|
297
|
+
- Rationale 2
|
|
282
298
|
|
|
283
|
-
|
|
299
|
+
Which option would you choose? (1/2/3)
|
|
284
300
|
```
|
|
285
301
|
|
|
286
|
-
###
|
|
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
|
-
###
|
|
309
|
+
### Option A: [Option name]
|
|
294
310
|
...
|
|
295
311
|
|
|
296
|
-
###
|
|
312
|
+
### Option B: [Option name]
|
|
297
313
|
...
|
|
298
314
|
|
|
299
|
-
|
|
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
|
-
|
|
329
|
+
You selected Option [N].
|
|
314
330
|
|
|
315
|
-
|
|
316
|
-
- Y: .claude/plans/[
|
|
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
|
-
|
|
335
|
+
Please choose. (Y/N)
|
|
320
336
|
```
|
|
321
337
|
|
|
322
|
-
###
|
|
338
|
+
### Plan document template
|
|
323
339
|
|
|
324
|
-
|
|
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
|
-
|
|
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
|
-
- [ ]
|
|
347
|
-
- [ ]
|
|
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
|
-
- [ ]
|
|
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
|
-
|
|
|
371
|
-
|
|
|
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
|
-
-
|
|
385
|
-
-
|
|
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
|
|
407
|
-
✅ Task (Explore)
|
|
408
|
-
✅
|
|
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
|
-
❌
|
|
417
|
-
❌ Edit
|
|
418
|
-
❌ Sequential Thinking 3
|
|
419
|
-
❌
|
|
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
|
-
###
|
|
449
|
+
### Example 1: Change auth system
|
|
434
450
|
|
|
435
451
|
```bash
|
|
436
|
-
|
|
452
|
+
User: /plan Change user authentication from JWT to session-based
|
|
437
453
|
|
|
438
|
-
1. Sequential Thinking (7
|
|
439
|
-
thought 1: "
|
|
440
|
-
thought 2: "
|
|
441
|
-
thought 3: "
|
|
442
|
-
thought 4: "
|
|
443
|
-
thought 5: "
|
|
444
|
-
thought 6: "
|
|
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): "
|
|
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
|
-
|
|
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
|
-
|
|
457
|
-
-
|
|
458
|
-
-
|
|
472
|
+
Option 2: Full replacement
|
|
473
|
+
- Pro: Clean structure
|
|
474
|
+
- Con: High risk
|
|
459
475
|
|
|
460
|
-
|
|
461
|
-
-
|
|
462
|
-
-
|
|
476
|
+
Option 3: Hybrid approach
|
|
477
|
+
- Pro: Flexibility
|
|
478
|
+
- Con: Increased complexity
|
|
463
479
|
|
|
464
|
-
4.
|
|
480
|
+
4. User choice: 1
|
|
465
481
|
|
|
466
|
-
5.
|
|
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
|
-
###
|
|
487
|
+
### Example 2: Add real-time notifications
|
|
472
488
|
|
|
473
489
|
```bash
|
|
474
|
-
|
|
490
|
+
User: /plan Add real-time notification feature
|
|
475
491
|
|
|
476
|
-
1. Sequential Thinking (5
|
|
477
|
-
thought 1: "
|
|
478
|
-
thought 2: "
|
|
479
|
-
thought 3: "
|
|
480
|
-
thought 4: "WebSocket
|
|
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): "
|
|
499
|
+
2. Task exploration:
|
|
500
|
+
Task (Explore): "Analyze current API structure and client communication"
|
|
485
501
|
|
|
486
|
-
3.
|
|
487
|
-
|
|
488
|
-
|
|
489
|
-
|
|
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
|
-
###
|
|
510
|
+
### Example 3: Simple refactoring
|
|
495
511
|
|
|
496
512
|
```bash
|
|
497
|
-
|
|
513
|
+
User: /plan Convert utils functions to TypeScript
|
|
498
514
|
|
|
499
|
-
1. Sequential Thinking (3
|
|
500
|
-
thought 1: "
|
|
501
|
-
thought 2: "
|
|
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 definition → conversion → test 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
|
-
|
|
510
|
-
|
|
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>
|