@kood/claude-code 0.6.7 → 0.7.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 (56) hide show
  1. package/package.json +1 -1
  2. package/templates/.claude/agents/analyst.md +5 -0
  3. package/templates/.claude/agents/architect.md +5 -0
  4. package/templates/.claude/agents/build-fixer.md +1 -0
  5. package/templates/.claude/agents/code-reviewer.md +1 -0
  6. package/templates/.claude/agents/critic.md +4 -0
  7. package/templates/.claude/agents/deep-executor.md +1 -0
  8. package/templates/.claude/agents/dependency-manager.md +2 -0
  9. package/templates/.claude/agents/deployment-validator.md +2 -0
  10. package/templates/.claude/agents/designer.md +2 -0
  11. package/templates/.claude/agents/document-writer.md +3 -0
  12. package/templates/.claude/agents/explore.md +1 -0
  13. package/templates/.claude/agents/git-operator.md +2 -0
  14. package/templates/.claude/agents/implementation-executor.md +2 -0
  15. package/templates/.claude/agents/ko-to-en-translator.md +3 -0
  16. package/templates/.claude/agents/lint-fixer.md +2 -0
  17. package/templates/.claude/agents/planner.md +3 -0
  18. package/templates/.claude/agents/pm.md +349 -0
  19. package/templates/.claude/agents/qa-tester.md +1 -0
  20. package/templates/.claude/agents/refactor-advisor.md +4 -0
  21. package/templates/.claude/agents/researcher.md +1 -0
  22. package/templates/.claude/agents/scientist.md +1 -0
  23. package/templates/.claude/agents/security-reviewer.md +1 -0
  24. package/templates/.claude/agents/tdd-guide.md +1 -0
  25. package/templates/.claude/agents/vision.md +1 -0
  26. package/templates/.claude/commands/lint-fix.md +20 -0
  27. package/templates/.claude/commands/pre-deploy.md +20 -0
  28. package/templates/.claude/commands/version-update.md +20 -0
  29. package/templates/.claude/instructions/agent-patterns/agent-teams-usage.md +376 -0
  30. package/templates/.claude/scripts/agent-teams/check-availability.sh +238 -0
  31. package/templates/.claude/scripts/agent-teams/setup-tmux.sh +125 -0
  32. package/templates/.claude/skills/agent-teams-setup/SKILL.md +460 -0
  33. package/templates/.claude/skills/brainstorm/SKILL.md +20 -0
  34. package/templates/.claude/skills/bug-fix/SKILL.md +20 -0
  35. package/templates/.claude/skills/crawler/SKILL.md +2 -0
  36. package/templates/.claude/skills/docs-creator/SKILL.md +20 -0
  37. package/templates/.claude/skills/docs-fetch/SKILL.md +20 -0
  38. package/templates/.claude/skills/docs-refactor/SKILL.md +20 -0
  39. package/templates/.claude/skills/elon-musk/SKILL.md +20 -0
  40. package/templates/.claude/skills/execute/SKILL.md +20 -0
  41. package/templates/.claude/skills/feedback/SKILL.md +20 -0
  42. package/templates/.claude/skills/figma-to-code/SKILL.md +20 -0
  43. package/templates/.claude/skills/genius-thinking/SKILL.md +1 -0
  44. package/templates/.claude/skills/global-uiux-design/SKILL.md +20 -0
  45. package/templates/.claude/skills/korea-uiux-design/SKILL.md +20 -0
  46. package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md +20 -0
  47. package/templates/.claude/skills/plan/SKILL.md +20 -0
  48. package/templates/.claude/skills/prd/SKILL.md +20 -0
  49. package/templates/.claude/skills/project-optimizer/SKILL.md +20 -0
  50. package/templates/.claude/skills/ralph/SKILL.md +1 -0
  51. package/templates/.claude/skills/refactor/SKILL.md +20 -0
  52. package/templates/.claude/skills/research/SKILL.md +1 -0
  53. package/templates/.claude/skills/sql-optimizer/SKILL.md +20 -0
  54. package/templates/.claude/skills/startup-validator/SKILL.md +1 -0
  55. package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md +20 -0
  56. package/templates/.claude/skills/tauri-react-best-practices/SKILL.md +20 -0
@@ -10,6 +10,7 @@ user-invocable: true
10
10
  @../../instructions/workflow-patterns/sequential-thinking.md
11
11
  @../../instructions/agent-patterns/parallel-execution.md
12
12
  @../../instructions/agent-patterns/model-routing.md
13
+ @../../instructions/agent-patterns/agent-teams-usage.md
13
14
  @../../instructions/validation/forbidden-patterns.md
14
15
  @../../instructions/validation/required-behaviors.md
15
16
  @../../instructions/sourcing/reliable-search.md
@@ -336,6 +337,25 @@ docs/library/{name}/
336
337
 
337
338
  <parallel_agent_execution>
338
339
 
340
+ ### ⚠️ Agent Teams 우선 원칙
341
+
342
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
343
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
344
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
345
+
346
+ **Agent Teams 모드 (기본)**:
347
+ ```typescript
348
+ TeamCreate({ team_name: "docs-fetch-team", description: "문서 수집" })
349
+ Task(subagent_type="researcher", team_name="docs-fetch-team", name="researcher", ...)
350
+ ```
351
+
352
+ **수명주기 관리:**
353
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
354
+ - 종료 후 `TaskList`로 다음 태스크 확인
355
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
356
+
357
+ ---
358
+
339
359
  ## Agent 활용 패턴
340
360
 
341
361
  | Phase | Agent | Model | 용도 |
@@ -7,6 +7,7 @@ metadata:
7
7
  ---
8
8
 
9
9
  @../../instructions/workflow-patterns/sequential-thinking.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/validation/forbidden-patterns.md
11
12
  @../../instructions/validation/required-behaviors.md
12
13
 
@@ -38,6 +39,25 @@ metadata:
38
39
 
39
40
  <parallel_agent_execution>
40
41
 
42
+ ### ⚠️ Agent Teams 우선 원칙
43
+
44
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
45
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
46
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
47
+
48
+ **Agent Teams 모드 (기본)**:
49
+ ```typescript
50
+ TeamCreate({ team_name: "docs-refactor-team", description: "문서 리팩토링" })
51
+ Task(subagent_type="document-writer", team_name="docs-refactor-team", name="writer", ...)
52
+ ```
53
+
54
+ **수명주기 관리:**
55
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
56
+ - 종료 후 `TaskList`로 다음 태스크 확인
57
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
58
+
59
+ ---
60
+
41
61
  @../docs-creator/SKILL.md#parallel_agent_execution
42
62
 
43
63
  **리팩토링 특화:**
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/sourcing/reliable-search.md
11
12
  @../../instructions/validation/forbidden-patterns.md
12
13
  @../../instructions/validation/required-behaviors.md
@@ -160,6 +161,25 @@ MCP 미가용 시 → researcher가 WebSearch + WebFetch로 수행
160
161
 
161
162
  <parallel_agent_execution>
162
163
 
164
+ ### ⚠️ Agent Teams 우선 원칙
165
+
166
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
167
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
168
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
169
+
170
+ **Agent Teams 모드 (기본)**:
171
+ ```typescript
172
+ TeamCreate({ team_name: "first-principles-team", description: "제1원칙 분석" })
173
+ Task(subagent_type="researcher", team_name="first-principles-team", name="researcher", ...)
174
+ ```
175
+
176
+ **수명주기 관리:**
177
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
178
+ - 종료 후 `TaskList`로 다음 태스크 확인
179
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
180
+
181
+ ---
182
+
163
183
  ## 병렬 Agent 실행
164
184
 
165
185
  ### Phase 1: 도메인 조사 (3방향 동시)
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/context-optimization/phase-based-execution.md
11
12
  @../../instructions/context-optimization/sub-agent-distribution.md
12
13
  @../../instructions/validation/scope-completeness.md
@@ -43,6 +44,25 @@ user-invocable: true
43
44
 
44
45
  <parallel_agent_execution>
45
46
 
47
+ ### ⚠️ Agent Teams 우선 원칙
48
+
49
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
50
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
51
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
52
+
53
+ **Agent Teams 모드 (기본)**:
54
+ ```typescript
55
+ TeamCreate({ team_name: "execute-team", description: "즉시 구현" })
56
+ Task(subagent_type="implementation-executor", team_name="execute-team", name="executor", ...)
57
+ ```
58
+
59
+ **수명주기 관리:**
60
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
61
+ - 종료 후 `TaskList`로 다음 태스크 확인
62
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
63
+
64
+ ---
65
+
46
66
  ## 병렬 에이전트 실행
47
67
 
48
68
  @../../instructions/agent-patterns/delegation-patterns.md
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/validation/forbidden-patterns.md
11
12
  @../../instructions/validation/required-behaviors.md
12
13
 
@@ -288,6 +289,25 @@ Task({
288
289
 
289
290
  <parallel_agent_execution>
290
291
 
292
+ ### ⚠️ Agent Teams 우선 원칙
293
+
294
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
295
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
296
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
297
+
298
+ **Agent Teams 모드 (기본)**:
299
+ ```typescript
300
+ TeamCreate({ team_name: "feedback-team", description: "피드백 처리" })
301
+ Task(subagent_type="implementation-executor", team_name="feedback-team", name="executor", ...)
302
+ ```
303
+
304
+ **수명주기 관리:**
305
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
306
+ - 종료 후 `TaskList`로 다음 태스크 확인
307
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
308
+
309
+ ---
310
+
291
311
  ## Parallel Agent Execution
292
312
 
293
313
  ### Model Routing
@@ -6,6 +6,7 @@ ui-only: true
6
6
  ---
7
7
 
8
8
  @../../instructions/agent-patterns/read-parallelization.md
9
+ @../../instructions/agent-patterns/agent-teams-usage.md
9
10
  @../../instructions/validation/forbidden-patterns.md
10
11
  @../../instructions/validation/required-behaviors.md
11
12
 
@@ -38,6 +39,25 @@ ui-only: true
38
39
 
39
40
  <parallel_agent_execution>
40
41
 
42
+ ### ⚠️ Agent Teams 우선 원칙
43
+
44
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
45
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
46
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
47
+
48
+ **Agent Teams 모드 (기본)**:
49
+ ```typescript
50
+ TeamCreate({ team_name: "figma-team", description: "Figma to Code 변환" })
51
+ Task(subagent_type="designer", team_name="figma-team", name="designer", ...)
52
+ ```
53
+
54
+ **수명주기 관리:**
55
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
56
+ - 종료 후 `TaskList`로 다음 태스크 확인
57
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
58
+
59
+ ---
60
+
41
61
  ## ULTRAWORK MODE (병렬 에이전트 실행)
42
62
 
43
63
  ### 기본 원칙
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/validation/forbidden-patterns.md
11
12
  @../../instructions/validation/required-behaviors.md
12
13
 
@@ -6,6 +6,7 @@ ui-only: true
6
6
  ---
7
7
 
8
8
  @../../instructions/agent-patterns/read-parallelization.md
9
+ @../../instructions/agent-patterns/agent-teams-usage.md
9
10
  @../../instructions/validation/forbidden-patterns.md
10
11
  @../../instructions/validation/required-behaviors.md
11
12
 
@@ -29,6 +30,25 @@ ui-only: true
29
30
 
30
31
  <parallel_agent_execution>
31
32
 
33
+ ### ⚠️ Agent Teams 우선 원칙
34
+
35
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
36
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
37
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
38
+
39
+ **Agent Teams 모드 (기본)**:
40
+ ```typescript
41
+ TeamCreate({ team_name: "global-uiux-team", description: "Global UI/UX 디자인" })
42
+ Task(subagent_type="designer", team_name="global-uiux-team", name="designer", ...)
43
+ ```
44
+
45
+ **수명주기 관리:**
46
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
47
+ - 종료 후 `TaskList`로 다음 태스크 확인
48
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
49
+
50
+ ---
51
+
32
52
  ## 병렬 에이전트 실행 (Global UX 특화)
33
53
 
34
54
  ### 핵심 원칙
@@ -6,6 +6,7 @@ ui-only: true
6
6
  ---
7
7
 
8
8
  @../../instructions/agent-patterns/read-parallelization.md
9
+ @../../instructions/agent-patterns/agent-teams-usage.md
9
10
  @../../instructions/validation/forbidden-patterns.md
10
11
  @../../instructions/validation/required-behaviors.md
11
12
 
@@ -29,6 +30,25 @@ ui-only: true
29
30
 
30
31
  <parallel_agent_execution>
31
32
 
33
+ ### ⚠️ Agent Teams 우선 원칙
34
+
35
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
36
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
37
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
38
+
39
+ **Agent Teams 모드 (기본)**:
40
+ ```typescript
41
+ TeamCreate({ team_name: "korea-uiux-team", description: "한국형 UI/UX 디자인" })
42
+ Task(subagent_type="designer", team_name="korea-uiux-team", name="designer", ...)
43
+ ```
44
+
45
+ **수명주기 관리:**
46
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
47
+ - 종료 후 `TaskList`로 다음 태스크 확인
48
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
49
+
50
+ ---
51
+
32
52
  ## 한국형 UI/UX 병렬 에이전트 실행
33
53
 
34
54
  ### 핵심 원칙
@@ -9,6 +9,7 @@ metadata:
9
9
  ---
10
10
 
11
11
  @../../instructions/agent-patterns/read-parallelization.md
12
+ @../../instructions/agent-patterns/agent-teams-usage.md
12
13
  @../../instructions/validation/forbidden-patterns.md
13
14
  @../../instructions/validation/required-behaviors.md
14
15
  @../../instructions/multi-agent/coordination-guide.md
@@ -38,6 +39,25 @@ Vercel에서 관리하는 React와 Next.js 애플리케이션 종합 성능 최
38
39
 
39
40
  <parallel_agent_execution>
40
41
 
42
+ ### ⚠️ Agent Teams 우선 원칙
43
+
44
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
45
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
46
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
47
+
48
+ **Agent Teams 모드 (기본)**:
49
+ ```typescript
50
+ TeamCreate({ team_name: "nextjs-team", description: "Next.js 최적화" })
51
+ Task(subagent_type="general-purpose", team_name="nextjs-team", name="optimizer", ...)
52
+ ```
53
+
54
+ **수명주기 관리:**
55
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
56
+ - 종료 후 `TaskList`로 다음 태스크 확인
57
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
58
+
59
+ ---
60
+
41
61
  ## 병렬 에이전트 실행 (ULTRAWORK MODE)
42
62
 
43
63
  ### 기본 원칙
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/sourcing/reliable-search.md
11
12
  @../../instructions/context-optimization/phase-based-execution.md
12
13
  @../../instructions/context-optimization/sub-agent-distribution.md
@@ -60,6 +61,25 @@ Task({
60
61
 
61
62
  <parallel_agent_execution>
62
63
 
64
+ ### ⚠️ Agent Teams 우선 원칙
65
+
66
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
67
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
68
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
69
+
70
+ **Agent Teams 모드 (기본)**:
71
+ ```typescript
72
+ TeamCreate({ team_name: "plan-team", description: "계획 수립" })
73
+ Task(subagent_type="planner", team_name="plan-team", name="planner", ...)
74
+ ```
75
+
76
+ **수명주기 관리:**
77
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
78
+ - 종료 후 `TaskList`로 다음 태스크 확인
79
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
80
+
81
+ ---
82
+
63
83
  ## 병렬 에이전트 실행
64
84
 
65
85
  @../../instructions/agent-patterns/delegation-patterns.md
@@ -6,6 +6,7 @@ user-invocable: true
6
6
 
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/read-parallelization.md
9
+ @../../instructions/agent-patterns/agent-teams-usage.md
9
10
  @../../instructions/sourcing/reliable-search.md
10
11
  @../../instructions/context-optimization/redundant-exploration-prevention.md
11
12
  @../../instructions/validation/forbidden-patterns.md
@@ -116,6 +117,25 @@ user-invocable: true
116
117
 
117
118
  <parallel_agent_execution>
118
119
 
120
+ ### ⚠️ Agent Teams 우선 원칙
121
+
122
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
123
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
124
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
125
+
126
+ **Agent Teams 모드 (기본)**:
127
+ ```typescript
128
+ TeamCreate({ team_name: "prd-team", description: "PRD 작성" })
129
+ Task(subagent_type="analyst", team_name="prd-team", name="analyst", ...)
130
+ ```
131
+
132
+ **수명주기 관리:**
133
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
134
+ - 종료 후 `TaskList`로 다음 태스크 확인
135
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
136
+
137
+ ---
138
+
119
139
  ## 병렬 Agent 실행
120
140
 
121
141
  ### Agent & Model Routing
@@ -9,6 +9,7 @@ metadata:
9
9
  ---
10
10
 
11
11
  @../../instructions/agent-patterns/read-parallelization.md
12
+ @../../instructions/agent-patterns/agent-teams-usage.md
12
13
  @../../instructions/validation/forbidden-patterns.md
13
14
  @../../instructions/validation/required-behaviors.md
14
15
  @../../instructions/multi-agent/coordination-guide.md
@@ -40,6 +41,25 @@ metadata:
40
41
 
41
42
  <parallel_agent_execution>
42
43
 
44
+ ### ⚠️ Agent Teams 우선 원칙
45
+
46
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
47
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
48
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
49
+
50
+ **Agent Teams 모드 (기본)**:
51
+ ```typescript
52
+ TeamCreate({ team_name: "optimizer-team", description: "프로젝트 최적화" })
53
+ Task(subagent_type="analyst", team_name="optimizer-team", name="analyst", ...)
54
+ ```
55
+
56
+ **수명주기 관리:**
57
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
58
+ - 종료 후 `TaskList`로 다음 태스크 확인
59
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
60
+
61
+ ---
62
+
43
63
  ## 병렬 에이전트 실행
44
64
 
45
65
  ### 기본 원칙
@@ -8,6 +8,7 @@ user-invocable: true
8
8
  @../../instructions/workflow-patterns/phase-based-workflow.md
9
9
  @../../instructions/agent-patterns/parallel-execution.md
10
10
  @../../instructions/agent-patterns/model-routing.md
11
+ @../../instructions/agent-patterns/agent-teams-usage.md
11
12
  @../../instructions/context-optimization/phase-based-execution.md
12
13
  @../../instructions/context-optimization/sub-agent-distribution.md
13
14
  @../../instructions/validation/scope-completeness.md
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/context-optimization/phase-based-execution.md
11
12
  @../../instructions/context-optimization/sub-agent-distribution.md
12
13
  @../../instructions/validation/scope-completeness.md
@@ -149,6 +150,25 @@ $ARGUMENTS 있음 → 다음 단계 진행
149
150
 
150
151
  <parallel_agent_execution>
151
152
 
153
+ ### ⚠️ Agent Teams 우선 원칙
154
+
155
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
156
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
157
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
158
+
159
+ **Agent Teams 모드 (기본)**:
160
+ ```typescript
161
+ TeamCreate({ team_name: "refactor-team", description: "리팩토링" })
162
+ Task(subagent_type="refactor-advisor", team_name="refactor-team", name="advisor", ...)
163
+ ```
164
+
165
+ **수명주기 관리:**
166
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
167
+ - 종료 후 `TaskList`로 다음 태스크 확인
168
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
169
+
170
+ ---
171
+
152
172
  ## 병렬 에이전트 실행
153
173
 
154
174
  @../../instructions/agent-patterns/delegation-patterns.md
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/sourcing/reliable-search.md
11
12
  @../../instructions/context-optimization/redundant-exploration-prevention.md
12
13
  @../../instructions/validation/forbidden-patterns.md
@@ -10,6 +10,7 @@ metadata:
10
10
  @../../instructions/workflow-patterns/sequential-thinking.md
11
11
  @../../instructions/agent-patterns/parallel-execution.md
12
12
  @../../instructions/agent-patterns/model-routing.md
13
+ @../../instructions/agent-patterns/agent-teams-usage.md
13
14
  @../../instructions/validation/forbidden-patterns.md
14
15
  @../../instructions/validation/required-behaviors.md
15
16
 
@@ -262,6 +263,25 @@ thought 5: "추천: 옵션 B - ORM 최적화 + Partial Index
262
263
 
263
264
  <parallel_agent_execution>
264
265
 
266
+ ### ⚠️ Agent Teams 우선 원칙
267
+
268
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
269
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
270
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
271
+
272
+ **Agent Teams 모드 (기본)**:
273
+ ```typescript
274
+ TeamCreate({ team_name: "sql-team", description: "SQL 최적화" })
275
+ Task(subagent_type="architect", team_name="sql-team", name="architect", ...)
276
+ ```
277
+
278
+ **수명주기 관리:**
279
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
280
+ - 종료 후 `TaskList`로 다음 태스크 확인
281
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
282
+
283
+ ---
284
+
265
285
  ## 병렬 에이전트 실행
266
286
 
267
287
  ```typescript
@@ -7,6 +7,7 @@ user-invocable: true
7
7
  @../../instructions/workflow-patterns/sequential-thinking.md
8
8
  @../../instructions/agent-patterns/parallel-execution.md
9
9
  @../../instructions/agent-patterns/model-routing.md
10
+ @../../instructions/agent-patterns/agent-teams-usage.md
10
11
  @../../instructions/validation/forbidden-patterns.md
11
12
  @../../instructions/validation/required-behaviors.md
12
13
 
@@ -10,6 +10,7 @@ metadata:
10
10
  ---
11
11
 
12
12
  @../../instructions/agent-patterns/read-parallelization.md
13
+ @../../instructions/agent-patterns/agent-teams-usage.md
13
14
  @../../instructions/validation/forbidden-patterns.md
14
15
  @../../instructions/validation/required-behaviors.md
15
16
  @../../instructions/multi-agent/coordination-guide.md
@@ -39,6 +40,25 @@ React 19와 TanStack Start v1 애플리케이션 성능 최적화 가이드. 8
39
40
 
40
41
  <parallel_agent_execution>
41
42
 
43
+ ### ⚠️ Agent Teams 우선 원칙
44
+
45
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
46
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
47
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
48
+
49
+ **Agent Teams 모드 (기본)**:
50
+ ```typescript
51
+ TeamCreate({ team_name: "tanstack-team", description: "TanStack Start 최적화" })
52
+ Task(subagent_type="general-purpose", team_name="tanstack-team", name="optimizer", ...)
53
+ ```
54
+
55
+ **수명주기 관리:**
56
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
57
+ - 종료 후 `TaskList`로 다음 태스크 확인
58
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
59
+
60
+ ---
61
+
42
62
  ## 병렬 에이전트 실행
43
63
 
44
64
  **ULTRAWORK MODE:** TanStack Start 최적화 작업 시 여러 규칙을 동시에 적용하여 5-15배 성능 향상.
@@ -10,6 +10,7 @@ metadata:
10
10
  ---
11
11
 
12
12
  @../../instructions/agent-patterns/read-parallelization.md
13
+ @../../instructions/agent-patterns/agent-teams-usage.md
13
14
  @../../instructions/validation/forbidden-patterns.md
14
15
  @../../instructions/validation/required-behaviors.md
15
16
  @../../instructions/multi-agent/coordination-guide.md
@@ -42,6 +43,25 @@ Tauri v2 + React 19 데스크톱/모바일 애플리케이션 성능 및 보안
42
43
 
43
44
  <parallel_agent_execution>
44
45
 
46
+ ### ⚠️ Agent Teams 우선 원칙
47
+
48
+ > **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
49
+ > - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
50
+ > - Agent Teams 미가용 → Task 병렬 호출 (폴백)
51
+
52
+ **Agent Teams 모드 (기본)**:
53
+ ```typescript
54
+ TeamCreate({ team_name: "tauri-team", description: "Tauri + React 최적화" })
55
+ Task(subagent_type="general-purpose", team_name="tauri-team", name="optimizer", ...)
56
+ ```
57
+
58
+ **수명주기 관리:**
59
+ - 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
60
+ - 종료 후 `TaskList`로 다음 태스크 확인
61
+ - 모든 작업 완료 → `TeamDelete`로 팀 해산
62
+
63
+ ---
64
+
45
65
  ## 병렬 에이전트 실행
46
66
 
47
67
  **ULTRAWORK MODE:** Tauri + React 최적화 작업 시 여러 규칙을 동시에 적용.