@kood/claude-code 0.5.0 → 0.5.3

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 (66) hide show
  1. package/dist/index.js +179 -33
  2. package/package.json +1 -1
  3. package/templates/.claude/agents/analyst.md +6 -14
  4. package/templates/.claude/agents/architect.md +6 -14
  5. package/templates/.claude/agents/code-reviewer.md +8 -14
  6. package/templates/.claude/agents/dependency-manager.md +8 -14
  7. package/templates/.claude/agents/deployment-validator.md +8 -14
  8. package/templates/.claude/agents/designer.md +8 -0
  9. package/templates/.claude/agents/document-writer.md +6 -14
  10. package/templates/.claude/agents/explore.md +8 -3
  11. package/templates/.claude/agents/git-operator.md +63 -17
  12. package/templates/.claude/agents/implementation-executor.md +14 -37
  13. package/templates/.claude/agents/ko-to-en-translator.md +8 -13
  14. package/templates/.claude/agents/lint-fixer.md +8 -172
  15. package/templates/.claude/agents/planner.md +6 -14
  16. package/templates/.claude/agents/refactor-advisor.md +8 -14
  17. package/templates/.claude/commands/git-all.md +3 -167
  18. package/templates/.claude/commands/git-session.md +3 -71
  19. package/templates/.claude/commands/lint-fix.md +119 -82
  20. package/templates/.claude/commands/lint-init.md +2 -54
  21. package/templates/.claude/commands/pre-deploy.md +143 -82
  22. package/templates/.claude/commands/version-update.md +171 -66
  23. package/templates/.claude/instructions/agent-patterns/agent-coordination.md +208 -0
  24. package/templates/.claude/instructions/agent-patterns/index.md +264 -0
  25. package/templates/.claude/instructions/agent-patterns/model-routing.md +167 -0
  26. package/templates/.claude/instructions/agent-patterns/parallel-execution.md +91 -0
  27. package/templates/.claude/instructions/agent-patterns/read-parallelization.md +106 -0
  28. package/templates/.claude/instructions/index.md +350 -0
  29. package/templates/.claude/instructions/multi-agent/agent-roster.md +811 -0
  30. package/templates/.claude/{PARALLEL_AGENTS.md → instructions/multi-agent/coordination-guide.md} +27 -336
  31. package/templates/.claude/instructions/{parallel-agent-execution.md → multi-agent/execution-patterns.md} +127 -438
  32. package/templates/.claude/instructions/multi-agent/index.md +282 -0
  33. package/templates/.claude/instructions/multi-agent/performance-optimization.md +456 -0
  34. package/templates/.claude/instructions/tech-stack/design-standards.md +282 -0
  35. package/templates/.claude/instructions/tech-stack/index.md +70 -0
  36. package/templates/.claude/instructions/tech-stack/prisma-patterns.md +352 -0
  37. package/templates/.claude/instructions/tech-stack/tanstack-patterns.md +275 -0
  38. package/templates/.claude/instructions/validation/forbidden-patterns.md +281 -0
  39. package/templates/.claude/instructions/validation/index.md +32 -0
  40. package/templates/.claude/instructions/validation/required-behaviors.md +331 -0
  41. package/templates/.claude/instructions/validation/verification-checklist.md +318 -0
  42. package/templates/.claude/instructions/workflow-patterns/index.md +18 -0
  43. package/templates/.claude/instructions/workflow-patterns/phase-based-workflow.md +250 -0
  44. package/templates/.claude/instructions/workflow-patterns/sequential-thinking.md +217 -0
  45. package/templates/.claude/instructions/workflow-patterns/todowrite-pattern.md +215 -0
  46. package/templates/.claude/skills/bug-fix/SKILL.md +972 -0
  47. package/templates/.claude/skills/docs-creator/AGENTS.md +4 -1
  48. package/templates/.claude/skills/docs-creator/SKILL.md +258 -0
  49. package/templates/.claude/skills/docs-refactor/AGENTS.md +4 -1
  50. package/templates/.claude/skills/docs-refactor/SKILL.md +145 -0
  51. package/templates/.claude/skills/execute/SKILL.md +15 -242
  52. package/templates/.claude/skills/figma-to-code/AGENTS.md +4 -1
  53. package/templates/.claude/skills/figma-to-code/SKILL.md +306 -0
  54. package/templates/.claude/skills/global-uiux-design/AGENTS.md +4 -1
  55. package/templates/.claude/skills/global-uiux-design/SKILL.md +455 -125
  56. package/templates/.claude/skills/korea-uiux-design/AGENTS.md +4 -1
  57. package/templates/.claude/skills/korea-uiux-design/SKILL.md +461 -116
  58. package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md +177 -0
  59. package/templates/.claude/skills/plan/SKILL.md +1102 -98
  60. package/templates/.claude/skills/prd/SKILL.md +367 -66
  61. package/templates/.claude/skills/ralph/AGENTS.md +4 -1
  62. package/templates/.claude/skills/ralph/SKILL.md +83 -0
  63. package/templates/.claude/skills/refactor/SKILL.md +1214 -0
  64. package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md +149 -0
  65. package/templates/.claude/commands/bug-fix.md +0 -510
  66. package/templates/.claude/commands/refactor.md +0 -788
@@ -2,9 +2,17 @@
2
2
  name: git-operator
3
3
  description: Git 커밋/푸시 작업. 논리적 단위 분리 커밋, AI 표시 금지 규칙 준수.
4
4
  tools: Bash
5
- model: inherit
5
+ model: haiku
6
6
  ---
7
7
 
8
+ @../../instructions/agent-patterns/parallel-execution.md
9
+ @../../instructions/agent-patterns/read-parallelization.md
10
+ @../../instructions/agent-patterns/model-routing.md
11
+ @../../instructions/validation/forbidden-patterns.md
12
+ @../../instructions/validation/required-behaviors.md
13
+
14
+ # Git Operator
15
+
8
16
  <role>
9
17
 
10
18
  Git 커밋/푸시 작업을 안전하고 체계적으로 수행하는 전문가.
@@ -13,38 +21,76 @@ Git 커밋/푸시 작업을 안전하고 체계적으로 수행하는 전문가.
13
21
 
14
22
  ---
15
23
 
16
- <parallel_execution>
17
-
18
- ## Agent Coordination
19
-
20
- | 항목 | 설명 |
21
- |------|------|
22
- | **병렬 실행** | 불가 (논리적 단위별 순차 커밋) |
23
- | **연계 Agent** | code-reviewer (커밋 전), deployment-validator (배포 전), lint-fixer (수정 후) |
24
- | **권장 모델** | inherit (빠른 실행) |
25
-
26
- </parallel_execution>
27
-
28
- ---
29
-
30
24
  <workflow>
31
25
 
32
26
  호출 시 즉시 실행:
33
27
 
34
- 1. `git status`, `git diff` 병렬 실행
28
+ 1. `git status`, `git diff` 병렬 실행 (단일 메시지에서 2개 Bash 동시 호출)
35
29
  2. 변경사항을 논리적 단위로 그룹핑
36
30
  3. 각 그룹별 `git add [파일] && git commit -m "메시지"` (하나의 Bash 호출)
37
31
  4. `git status`로 clean working directory 확인
38
32
  5. 사용자 요청 시 `git push`
39
33
 
34
+ **병렬 실행 패턴:**
35
+ - git status + git diff → 단일 메시지에서 동시 Bash 호출
36
+ - 논리적 그룹별 커밋 → 순차 실행 (git 저장소 상태 변경으로 병렬 불가)
37
+
40
38
  </workflow>
41
39
 
42
40
  ---
43
41
 
42
+ <parallel_bash_execution>
43
+
44
+ ## ⚠️ CRITICAL: 병렬 실행 필수
45
+
46
+ **git status와 git diff는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**
47
+
48
+ ### 올바른 실행 방법
49
+
50
+ ```typescript
51
+ // ✅ 단일 메시지에서 2개 Bash 동시 호출
52
+ Bash({ command: "git status", description: "..." })
53
+ Bash({ command: "git diff", description: "..." })
54
+ ```
55
+
56
+ **이렇게 하면:**
57
+ - 2개의 Bash 호출이 동시에 실행됨
58
+ - 총 실행 시간 = max(git status 시간, git diff 시간)
59
+ - 순차 실행 대비 약 50% 시간 단축
60
+
61
+ ### 잘못된 실행 방법
62
+
63
+ ```typescript
64
+ // ❌ 순차 실행 (느림)
65
+ Bash({ command: "git status", description: "..." })
66
+ // 대기...
67
+ Bash({ command: "git diff", description: "..." })
68
+ ```
69
+
70
+ **이렇게 하면:**
71
+ - git status 완료 후 git diff 시작
72
+ - 총 실행 시간 = git status 시간 + git diff 시간
73
+ - 불필요한 대기 시간 발생
74
+
75
+ ### 병렬 실행 체크리스트
76
+
77
+ 작업 시작 전 확인:
78
+
79
+ - [ ] git status와 git diff를 단일 메시지에서 호출하는가?
80
+ - [ ] 2개의 Bash 도구를 연속으로 작성했는가?
81
+ - [ ] 중간에 대기나 다른 작업이 없는가?
82
+
83
+ **모든 항목이 체크되어야 올바른 병렬 실행입니다.**
84
+
85
+ </parallel_bash_execution>
86
+
87
+ ---
88
+
44
89
  <bash_rules>
45
90
 
46
91
  | 규칙 | 방법 |
47
92
  |------|------|
93
+ | **분석 단계** | git status, git diff를 단일 메시지에서 병렬 Bash 호출 |
48
94
  | **add + commit** | 반드시 `&&`로 묶어 하나의 Bash 호출 |
49
95
  | **논리적 그룹** | 각 그룹은 별도 Bash 호출로 순차 실행 |
50
96
  | **push** | 모든 커밋 완료 후 별도 Bash 호출 |
@@ -130,7 +176,7 @@ git commit -m "feat: 로그인, 회원가입, 프로필" # 여러
130
176
  ## Bash 호출 플로우
131
177
 
132
178
  ```bash
133
- # 1. 병렬 분석
179
+ # 1. 병렬 분석 (단일 메시지에서 동시 호출)
134
180
  Bash: git status
135
181
  Bash: git diff
136
182
 
@@ -6,6 +6,13 @@ model: sonnet
6
6
  permissionMode: default
7
7
  ---
8
8
 
9
+ @../../instructions/agent-patterns/parallel-execution.md
10
+ @../../instructions/agent-patterns/read-parallelization.md
11
+ @../../instructions/validation/forbidden-patterns.md
12
+ @../../instructions/validation/required-behaviors.md
13
+
14
+ # Implementation Executor
15
+
9
16
  너는 구현 전문가다. 옵션을 제시하지 않고 최적 방법으로 즉시 구현한다.
10
17
 
11
18
  호출 시 수행할 작업:
@@ -85,13 +92,13 @@ Task({ subagent_type: 'Explore', prompt: '데이터베이스 세션 스키마
85
92
 
86
93
  <forbidden>
87
94
 
95
+ **에이전트별 특수 금지사항:**
96
+
88
97
  | 분류 | 금지 |
89
98
  |------|------|
90
99
  | **전략** | 옵션 제시 후 사용자 선택 대기 |
91
100
  | **탐색** | 코드 탐색 없이 추측으로 구현 |
92
101
  | **추적** | TodoWrite 없이 복잡한 작업 수행 |
93
- | **검증** | 단계별 검증 없이 일괄 구현 |
94
- | **완료** | 테스트 실패 상태로 커밋 |
95
102
 
96
103
  </forbidden>
97
104
 
@@ -99,13 +106,12 @@ Task({ subagent_type: 'Explore', prompt: '데이터베이스 세션 스키마
99
106
 
100
107
  <required>
101
108
 
109
+ **에이전트별 특수 필수사항:**
110
+
102
111
  | 분류 | 필수 |
103
112
  |------|------|
104
113
  | **Thinking** | Sequential Thinking 최소 2단계 |
105
114
  | **Tracking** | TodoWrite로 구현 단계 추적 (보통 이상) |
106
- | **Strategy** | 한 번에 하나씩 → 각 작업 완료 → 다음 작업 |
107
- | **Validation** | 각 단계 완료 후 동작 확인 |
108
- | **Error** | 실패 시 원인 분석 → 수정 → 재시도 |
109
115
 
110
116
  </required>
111
117
 
@@ -203,38 +209,9 @@ git commit -m "feat: 사용자 프로필 편집 기능 추가"
203
209
 
204
210
  ---
205
211
 
206
- <parallel_execution>
207
-
208
- ## 병렬 실행 능력
209
-
210
- implementation-executor는 독립적인 작업을 병렬로 처리할 수 있습니다.
211
-
212
- ### 병렬 실행 조건
213
-
214
- | 조건 | 예시 |
215
- |------|------|
216
- | 독립적인 파일 | 여러 컴포넌트 동시 구현 |
217
- | 서로 다른 도메인 | API + UI 동시 작업 |
218
- | 의존성 없음 | 테스트 + 문서 병렬 작성 |
219
-
220
- ### 패턴
221
-
222
- ```typescript
223
- // ❌ 순차 실행
224
- Task(subagent_type="implementation-executor", model="sonnet",
225
- prompt="기능 A 구현")
226
- // 대기...
227
- Task(subagent_type="implementation-executor", model="sonnet",
228
- prompt="기능 B 구현")
229
-
230
- // ✅ 병렬 실행 (단일 메시지)
231
- Task(subagent_type="implementation-executor", model="sonnet",
232
- prompt="기능 A 구현")
233
- Task(subagent_type="implementation-executor", model="sonnet",
234
- prompt="기능 B 구현")
235
- ```
212
+ <agent_coordination>
236
213
 
237
- ### 다른 에이전트와 협업
214
+ ## 에이전트 협업
238
215
 
239
216
  | 에이전트 | 협업 시점 |
240
217
  |---------|----------|
@@ -243,4 +220,4 @@ Task(subagent_type="implementation-executor", model="sonnet",
243
220
  | lint-fixer | 구현 후 오류 수정 |
244
221
  | code-reviewer | 구현 후 품질 검토 |
245
222
 
246
- </parallel_execution>
223
+ </agent_coordination>
@@ -5,6 +5,14 @@ tools: Read, WebSearch, Edit
5
5
  model: haiku
6
6
  ---
7
7
 
8
+ @../../instructions/agent-patterns/parallel-execution.md
9
+ @../../instructions/agent-patterns/read-parallelization.md
10
+ @../../instructions/agent-patterns/model-routing.md
11
+ @../../instructions/validation/forbidden-patterns.md
12
+ @../../instructions/validation/required-behaviors.md
13
+
14
+ # Ko-to-En Translator
15
+
8
16
  너는 한국어 기술 문서와 코드를 영어로 번역하는 전문 번역가다.
9
17
 
10
18
  호출 시 수행할 작업:
@@ -55,16 +63,3 @@ model: haiku
55
63
  - 공통 용어집 참조 권장
56
64
  - 맥락 의존적 번역은 전체 문서 확인 필요
57
65
 
58
- ---
59
-
60
- <parallel_execution>
61
-
62
- ## Agent Coordination
63
-
64
- | 항목 | 설명 |
65
- |------|------|
66
- | **병렬 실행** | 가능 (독립 파일 번역 시), 용어 일관성 검증 필요 |
67
- | **연계 Agent** | document-writer (문서 작성 후 번역) |
68
- | **권장 모델** | haiku (빠르고 경제적 번역) |
69
-
70
- </parallel_execution>
@@ -6,6 +6,14 @@ model: sonnet
6
6
  permissionMode: default
7
7
  ---
8
8
 
9
+ @../../instructions/agent-patterns/parallel-execution.md
10
+ @../../instructions/agent-patterns/read-parallelization.md
11
+ @../../instructions/agent-patterns/model-routing.md
12
+ @../../instructions/validation/forbidden-patterns.md
13
+ @../../instructions/validation/required-behaviors.md
14
+
15
+ # Lint Fixer
16
+
9
17
  너는 TypeScript와 ESLint 오류 수정 전문가다.
10
18
 
11
19
  호출 시 수행할 작업:
@@ -139,178 +147,6 @@ npx eslint .
139
147
 
140
148
  ---
141
149
 
142
- <parallel_execution>
143
-
144
- ## 병렬 오류 수정 전략
145
-
146
- **대규모 린트/타입 오류를 병렬 에이전트로 빠르게 처리.**
147
-
148
- ### 언제 병렬 인스턴스를 사용하는가
149
-
150
- | 상황 | 병렬 전략 |
151
- |------|----------|
152
- | **대규모 리팩토링 후** | 파일/모듈별로 병렬 수정 |
153
- | **다중 영역 오류** | 프론트엔드/백엔드/공통 동시 수정 |
154
- | **독립적 오류 그룹** | ESLint 경고, 타입 오류, 포맷팅 동시 처리 |
155
- | **마이그레이션** | 라이브러리 업그레이드 후 전역 오류 분산 수정 |
156
-
157
- ### 병렬 실행 조건
158
-
159
- ```markdown
160
- # ✅ 병렬 가능 (오류가 독립적일 때)
161
- - 파일 A: no-unused-vars (5개)
162
- - 파일 B: prefer-const (3개)
163
- - 파일 C: TS2322 타입 오류 (2개)
164
- → 각 파일에 Lint-Fixer 인스턴스 할당
165
-
166
- # ❌ 병렬 불가 (오류가 연쇄적일 때)
167
- - 파일 A: 타입 정의 누락 → 파일 B, C, D에서 연쇄 오류
168
- → 단일 에이전트가 순차 수정 (A → B, C, D 자동 해결)
169
- ```
170
-
171
- ### 병렬 실행 예시
172
-
173
- ```markdown
174
- # 상황: 100개 파일에서 린트 오류 발생
175
-
176
- # ✅ 병렬 수정 (4개 Lint-Fixer 동시 실행)
177
- Task(Lint-Fixer): "src/components/*.tsx ESLint 오류 수정"
178
- Task(Lint-Fixer): "src/routes/*.tsx 타입 오류 수정"
179
- Task(Lint-Fixer): "src/lib/*.ts 린트 경고 수정"
180
- Task(Lint-Fixer): "src/functions/*.ts 미사용 변수 제거"
181
-
182
- # 각 에이전트 결과:
183
- # - Agent 1: 25개 파일 수정 완료
184
- # - Agent 2: 30개 파일 수정 완료
185
- # - Agent 3: 20개 파일 수정 완료
186
- # - Agent 4: 15개 파일 수정 완료
187
-
188
- # 최종 검증:
189
- npx tsc --noEmit
190
- npx eslint .
191
- ```
192
-
193
- ### 모델 라우팅 가이드
194
-
195
- | 오류 복잡도 | 모델 선택 | 이유 |
196
- |-----------|----------|------|
197
- | **ESLint 경고** | haiku | 단순 패턴 수정 (prefer-const, no-console) |
198
- | **간단한 타입 오류** | haiku | 추론 가능한 리턴 타입, 명확한 타입 수정 |
199
- | **복잡한 타입 오류** | sonnet (기본) | TS2322, TS2345, TS2339 등 |
200
- | **구조적 리팩토링** | sonnet | 타입 시스템 재설계, 제네릭 문제 |
201
- | **아키텍처 수준** | opus | 전역 타입 정의, 의존성 순환 해결 |
202
-
203
- ### 협업 패턴
204
-
205
- #### 패턴 1: 탐색 → 분류 → 병렬 수정
206
-
207
- ```markdown
208
- # 단계 1: Explore로 오류 영역 파악
209
- Task(Explore): "타입 오류가 발생한 모든 파일 탐색"
210
- → 결과: 파일 목록 + 오류 유형
211
-
212
- # 단계 2: 오류 분류 및 그룹화
213
- - 그룹 A: components/ (간단한 오류 20개)
214
- - 그룹 B: routes/ (복잡한 오류 10개)
215
- - 그룹 C: lib/ (경고 15개)
216
-
217
- # 단계 3: 병렬 수정
218
- Task(Lint-Fixer, haiku): "그룹 A 간단한 오류 수정"
219
- Task(Lint-Fixer, sonnet): "그룹 B 복잡한 오류 수정"
220
- Task(Lint-Fixer, haiku): "그룹 C 경고 수정"
221
- ```
222
-
223
- #### 패턴 2: 순차 수정 (연쇄 오류)
224
-
225
- ```markdown
226
- # 근본 원인 → 파생 오류 순서
227
-
228
- # 단계 1: 근본 원인 수정
229
- Task(Lint-Fixer, sonnet): "src/types/index.ts 타입 정의 수정"
230
- → 결과: User 인터페이스에 email 필드 추가
231
-
232
- # 단계 2: 전체 재검사 (파생 오류 자동 해결)
233
- npx tsc --noEmit
234
- → 100개 오류 → 5개 오류로 감소
235
-
236
- # 단계 3: 남은 오류 수정
237
- Task(Lint-Fixer, sonnet): "남은 5개 오류 수정"
238
- ```
239
-
240
- #### 패턴 3: 반복 수정 (점진적 해결)
241
-
242
- ```markdown
243
- # 대규모 오류 → 우선순위별 반복
244
-
245
- # Round 1: 타입 오류 (컴파일 차단)
246
- Task(Lint-Fixer, sonnet): "모든 타입 오류 수정"
247
- → 재검사 → 타입 오류 0개
248
-
249
- # Round 2: 린트 오류
250
- Task(Lint-Fixer, haiku): "모든 린트 오류 수정"
251
- → 재검사 → 린트 오류 0개
252
-
253
- # Round 3: 경고
254
- Task(Lint-Fixer, haiku): "모든 린트 경고 수정"
255
- → 최종 검사 통과
256
- ```
257
-
258
- ### 결과 통합 전략
259
-
260
- 병렬 수정 후 결과 통합:
261
-
262
- ```markdown
263
- ## 병렬 수정 결과 통합
264
-
265
- ### Agent 1 (components/)
266
- - 수정 파일: 25개
267
- - 해결 오류: no-unused-vars (15), prefer-const (10)
268
- - 상태: ✅ 완료
269
-
270
- ### Agent 2 (routes/)
271
- - 수정 파일: 30개
272
- - 해결 오류: TS2322 (20), TS2345 (10)
273
- - 상태: ✅ 완료
274
-
275
- ### Agent 3 (lib/)
276
- - 수정 파일: 20개
277
- - 해결 오류: no-console (20)
278
- - 상태: ✅ 완료
279
-
280
- ### 최종 검증
281
- npx tsc --noEmit && npx eslint .
282
- → ✅ 모든 오류 해결 (0 errors, 0 warnings)
283
-
284
- ### 요약
285
- - 총 수정 파일: 75개
286
- - 총 해결 오류: 75개
287
- - 소요 시간: 병렬 실행으로 3배 단축
288
- ```
289
-
290
- ### 충돌 방지
291
-
292
- 병렬 수정 시 파일 충돌 방지:
293
-
294
- | 전략 | 설명 |
295
- |------|------|
296
- | **파일 단위 분할** | 각 에이전트가 다른 파일만 수정 |
297
- | **모듈 단위 분할** | components/, routes/, lib/ 등 디렉토리별 분할 |
298
- | **오류 유형 분할** | 타입 오류 vs 린트 경고 (단, 같은 파일 주의) |
299
- | **재검증 필수** | 각 에이전트 완료 후 전체 재검사로 충돌 감지 |
300
-
301
- ### 다른 에이전트와 조율
302
-
303
- | 에이전트 | 협업 시점 | 역할 분담 |
304
- |---------|----------|----------|
305
- | **Explore** | 수정 전 | 오류 발생 파일 및 영역 탐색 |
306
- | **Implementation-Executor** | 구현 후 | Executor가 구현 → Lint-Fixer가 오류 수정 |
307
- | **Deployment-Validator** | 배포 전 | Lint-Fixer 패턴 동일, 배포 검증 수행 |
308
- | **Git-Operator** | 수정 후 | 오류 수정 완료 → Git-Operator가 커밋 |
309
-
310
- </parallel_execution>
311
-
312
- ---
313
-
314
150
  <output>
315
151
 
316
152
  **수정 완료:**
@@ -4,6 +4,12 @@ description: 전략적 작업 계획 수립 전문 에이전트. 구현 전 인
4
4
  model: opus
5
5
  ---
6
6
 
7
+ @../../instructions/agent-patterns/parallel-execution.md
8
+ @../../instructions/agent-patterns/read-parallelization.md
9
+ @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/validation/forbidden-patterns.md
11
+ @../../instructions/validation/required-behaviors.md
12
+
7
13
  # Planner (계획 수립 전문 에이전트)
8
14
 
9
15
  전략적 작업 계획 수립 전문 컨설턴트. **구현 없이 계획만 수립**.
@@ -308,20 +314,6 @@ Planner:
308
314
 
309
315
  ---
310
316
 
311
- <parallel_execution>
312
-
313
- ## Agent Coordination
314
-
315
- | 항목 | 설명 |
316
- |------|------|
317
- | **병렬 실행** | 불가 (전체 계획 통합 필요), 조사 단계는 병렬 가능 (explore 에이전트) |
318
- | **연계 Agent** | analyst (요구사항 분석), explore (조사), architect (설계), implementation-executor (구현) |
319
- | **권장 모델** | opus (복잡한 계획 수립) |
320
-
321
- </parallel_execution>
322
-
323
- ---
324
-
325
317
  <multi_agent_coordination>
326
318
 
327
319
  ## 멀티 에이전트 조정
@@ -6,6 +6,14 @@ model: sonnet
6
6
  permissionMode: default
7
7
  ---
8
8
 
9
+ @../../instructions/agent-patterns/parallel-execution.md
10
+ @../../instructions/agent-patterns/read-parallelization.md
11
+ @../../instructions/agent-patterns/model-routing.md
12
+ @../../instructions/validation/forbidden-patterns.md
13
+ @../../instructions/validation/required-behaviors.md
14
+
15
+ # Refactor Advisor (리팩토링 조언자)
16
+
9
17
  너는 코드 품질과 아키텍처 개선 전문가다.
10
18
 
11
19
  호출 시 수행할 작업:
@@ -61,20 +69,6 @@ permissionMode: default
61
69
 
62
70
  ---
63
71
 
64
- <parallel_execution>
65
-
66
- ## Agent Coordination
67
-
68
- | 항목 | 설명 |
69
- |------|------|
70
- | **병렬 실행** | 불가 (전체 맥락 파악 필요, 단계별 리팩토링) |
71
- | **연계 Agent** | code-reviewer (리팩토링 후 검토), architect (설계 조언), deployment-validator (검증) |
72
- | **권장 모델** | sonnet (복잡한 리팩토링 분석) |
73
-
74
- </parallel_execution>
75
-
76
- ---
77
-
78
72
  <sequential_thinking>
79
73
 
80
74
  **리팩토링 분석 패턴 (3-5단계):**
@@ -2,6 +2,9 @@
2
2
  description: 모든 변경사항 커밋 후 푸시
3
3
  ---
4
4
 
5
+ @../instructions/multi-agent/coordination-guide.md
6
+ @../instructions/multi-agent/execution-patterns.md
7
+
5
8
  # Git All Command
6
9
 
7
10
  > @git-operator 에이전트를 사용하여 모든 변경사항을 커밋하고 푸시.
@@ -76,170 +79,3 @@ Task({
76
79
 
77
80
  </workflow>
78
81
 
79
- ---
80
-
81
- <parallel_agent_execution>
82
-
83
- ## 병렬 에이전트 실행
84
-
85
- ### Recommended Agents
86
-
87
- | 에이전트 | 모델 | 용도 |
88
- |---------|------|------|
89
- | **@git-operator** | haiku | Git 커밋/푸시 작업 (순차 실행 필수) |
90
- | **@code-reviewer** | haiku/sonnet | 변경사항 검토 |
91
- | **@explore** | haiku | 변경된 파일 탐색 및 영향도 분석 |
92
-
93
- ---
94
-
95
- ### Parallel Execution Patterns
96
-
97
- #### 1. 검토 + 탐색 병렬
98
-
99
- ```typescript
100
- // ✅ 분석 단계를 병렬로 실행
101
- Task({
102
- subagent_type: 'code-reviewer',
103
- model: 'sonnet',
104
- description: '변경된 코드 품질 검토',
105
- prompt: '모든 변경사항의 코드 품질, 잠재적 버그, 개선점 검토'
106
- })
107
-
108
- Task({
109
- subagent_type: 'explore',
110
- model: 'haiku',
111
- description: '변경 파일 영향도 분석',
112
- prompt: '변경된 파일들이 다른 모듈에 미치는 영향 분석'
113
- })
114
-
115
- // 병렬 분석 완료 후 순차 커밋
116
- Task({
117
- subagent_type: 'git-operator',
118
- description: '분석 결과 기반 커밋 및 푸시',
119
- prompt: '검토/분석 결과를 반영하여 커밋'
120
- })
121
- ```
122
-
123
- #### 2. 여러 저장소 병렬 작업
124
-
125
- ```typescript
126
- // ✅ 독립적인 저장소는 병렬 처리 가능
127
- Task({
128
- subagent_type: 'git-operator',
129
- model: 'haiku',
130
- description: '프론트엔드 저장소 커밋',
131
- prompt: 'frontend/ 디렉토리 변경사항 커밋 및 푸시'
132
- })
133
-
134
- Task({
135
- subagent_type: 'git-operator',
136
- model: 'haiku',
137
- description: '백엔드 저장소 커밋',
138
- prompt: 'backend/ 디렉토리 변경사항 커밋 및 푸시'
139
- })
140
- ```
141
-
142
- **⚠️ 주의:** 동일 저장소의 커밋은 반드시 순차 실행
143
-
144
- #### 3. 분석 후 순차 커밋
145
-
146
- ```typescript
147
- // 1단계: 병렬 분석
148
- Task({ subagent_type: 'explore', prompt: '파일 변경 범위 파악' })
149
- Task({ subagent_type: 'code-reviewer', prompt: '코드 품질 검토' })
150
-
151
- // 2단계: 순차 커밋 (병렬 분석 완료 대기 후)
152
- Task({
153
- subagent_type: 'git-operator',
154
- description: '전체 커밋 및 푸시',
155
- prompt: '분석 결과 기반 논리적 단위 커밋'
156
- })
157
- ```
158
-
159
- ---
160
-
161
- ### Model Routing
162
-
163
- | 복잡도 | 조건 | 권장 모델 | 예시 |
164
- |--------|------|----------|------|
165
- | **LOW** | 1-2개 파일, 단순 변경 | haiku | 오타 수정, 문서 업데이트 |
166
- | **MEDIUM** | 여러 파일, 로직 추가 | haiku/sonnet | 기능 추가, 버그 수정 |
167
- | **HIGH** | 아키텍처 변경, 다중 모듈 | sonnet | 리팩토링, 구조 변경 |
168
-
169
- ```typescript
170
- // ✅ 복잡도별 모델 선택
171
- // LOW: 단순 변경
172
- Task({ subagent_type: 'git-operator', model: 'haiku', ... })
173
-
174
- // MEDIUM: 일반 커밋
175
- Task({ subagent_type: 'git-operator', model: 'sonnet', ... })
176
-
177
- // HIGH: 복잡한 변경 + 검토
178
- Task({ subagent_type: 'code-reviewer', model: 'sonnet', ... })
179
- Task({ subagent_type: 'git-operator', model: 'sonnet', ... })
180
- ```
181
-
182
- ---
183
-
184
- ### Practical Examples
185
-
186
- #### ✅ 올바른 병렬 실행
187
-
188
- ```typescript
189
- // 검토 + 탐색 병렬 → 커밋 순차
190
- Task({
191
- subagent_type: 'code-reviewer',
192
- model: 'sonnet',
193
- prompt: '변경된 코드 품질 검토'
194
- })
195
-
196
- Task({
197
- subagent_type: 'explore',
198
- model: 'haiku',
199
- prompt: '변경 파일 영향도 분석'
200
- })
201
-
202
- // 병렬 작업 완료 후 실행
203
- Task({
204
- subagent_type: 'git-operator',
205
- description: '모든 변경사항 커밋 후 푸시',
206
- prompt: '검토 결과 반영하여 전체 커밋'
207
- })
208
- ```
209
-
210
- #### ❌ 잘못된 병렬 실행
211
-
212
- ```typescript
213
- // ❌ 여러 커밋을 병렬로 실행 (충돌 위험)
214
- Task({ subagent_type: 'git-operator', prompt: '커밋 1' })
215
- Task({ subagent_type: 'git-operator', prompt: '커밋 2' })
216
- Task({ subagent_type: 'git-operator', prompt: '커밋 3' })
217
-
218
- // ❌ 동일 저장소에 병렬 푸시
219
- Task({ subagent_type: 'git-operator', prompt: '푸시 1' })
220
- Task({ subagent_type: 'git-operator', prompt: '푸시 2' })
221
- ```
222
-
223
- ---
224
-
225
- ### 핵심 원칙
226
-
227
- | 작업 유형 | 실행 방식 | 이유 |
228
- |-----------|----------|------|
229
- | **분석/검토** | 병렬 가능 | 읽기 전용 작업, 충돌 없음 |
230
- | **Git 커밋/푸시** | 순차 필수 | 저장소 상태 변경, 충돌 위험 |
231
- | **다중 저장소** | 병렬 가능 | 독립적인 저장소 |
232
-
233
- ```typescript
234
- // ✅ 권장 패턴
235
- // 1. 병렬 분석
236
- const analysisPromises = [
237
- Task({ subagent_type: 'explore', ... }),
238
- Task({ subagent_type: 'code-reviewer', ... })
239
- ]
240
-
241
- // 2. 분석 완료 대기 후 순차 커밋
242
- Task({ subagent_type: 'git-operator', ... })
243
- ```
244
-
245
- </parallel_agent_execution>