@kood/claude-code 0.7.0 → 0.7.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kood/claude-code",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "Claude Code documentation installer for projects",
   "type": "module",
   "bin": "./dist/index.js",

package/templates/.claude/commands/lint-fix.md

@@ -134,6 +134,26 @@ argument-hint: [파일/디렉토리 경로...]
 
 <parallel_execution_critical>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "lint-fix-team", description: "린트 오류 병렬 수정" })
+Task(subagent_type="lint-fixer", team_name="lint-fix-team", name="fixer-1", ...)
+Task(subagent_type="lint-fixer", team_name="lint-fix-team", name="fixer-2", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ⚠️ CRITICAL: 병렬 검사 필수
 
 **tsc와 eslint는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**

package/templates/.claude/commands/pre-deploy.md

@@ -99,6 +99,26 @@ argument-hint: [파일/디렉토리 경로...]
 
 <parallel_execution_critical>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "pre-deploy-team", description: "배포 전 검증" })
+Task(subagent_type="deployment-validator", team_name="pre-deploy-team", name="validator", ...)
+Task(subagent_type="security-reviewer", team_name="pre-deploy-team", name="security", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ⚠️ CRITICAL: 병렬 검사 필수
 
 **typecheck와 lint는 반드시 단일 메시지에서 병렬로 실행해야 합니다.**

package/templates/.claude/commands/version-update.md

@@ -66,6 +66,26 @@ argument-hint: <new-version | +1 | +minor | +major>
 
 <parallel_execution_critical>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "version-update-team", description: "버전 업데이트 작업" })
+Task(subagent_type="document-writer", team_name="version-update-team", name="changelog", ...)
+Task(subagent_type="document-writer", team_name="version-update-team", name="readme", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ⚠️ CRITICAL: 병렬 작업 패턴
 
 ### 병렬 실행 가능 작업

package/templates/.claude/instructions/agent-patterns/agent-teams-usage.md

@@ -4,6 +4,48 @@
 
 ---
 
+<mandatory_rules>
+
+## ⚠️ 필수 사용 규칙
+
+> **이 규칙은 선택이 아닌 필수입니다. 위반 시 workflow 실패로 간주합니다.**
+
+| 조건 | 행동 | 위반 시 |
+|------|------|--------|
+| **3개+ 병렬 에이전트 필요** | Agent Teams **필수** 사용 | ❌ 스킬 실행 중단 |
+| **팀원 간 소통/조율 필요** | Agent Teams **필수** 사용 | ❌ 스킬 실행 중단 |
+| **Agent Teams 미가용** | Task 병렬 호출 (폴백) | ✅ 허용 |
+| **단순 작업 (1-2 에이전트)** | Task 직접 호출 | ✅ 허용 |
+
+### 필수 패턴
+
+```typescript
+// ✅ 3개+ 에이전트 → Agent Teams 필수
+TeamCreate({ team_name: "skill-team", description: "..." })
+Task({ subagent_type: "...", team_name: "skill-team", name: "worker-1", ... })
+Task({ subagent_type: "...", team_name: "skill-team", name: "worker-2", ... })
+Task({ subagent_type: "...", team_name: "skill-team", name: "worker-3", ... })
+
+// ❌ 금지: 3개+ 에이전트를 Agent Teams 없이 호출
+Task({ subagent_type: "...", ... })
+Task({ subagent_type: "...", ... })
+Task({ subagent_type: "...", ... })  // Agent Teams 미사용 → 위반
+```
+
+### 수명주기 필수 관리
+
+| 단계 | 필수 행동 |
+|------|----------|
+| **시작** | `TeamCreate` → 팀원 spawn |
+| **완료** | 팀원별 `shutdown_request` 전송 |
+| **해산** | 모든 팀원 종료 확인 → `TeamDelete` |
+
+**팀 정리 없이 스킬 종료 금지.**
+
+</mandatory_rules>
+
+---
+
 <availability_check>
 
 ## 환경 확인

package/templates/.claude/skills/brainstorm/SKILL.md

@@ -181,6 +181,25 @@ Sequential Thinking (2단계):
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "brainstorm-team", description: "브레인스토밍" })
+Task(subagent_type="researcher", team_name="brainstorm-team", name="researcher", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md
@@ -339,6 +358,8 @@ Task({ subagent_type: 'analyst', prompt: '비평가 관점: 약점과 리스크'
 ❌ 다음 단계 없이 종료
 ❌ 결과 저장 없이 종료
 ❌ 발행일 미확인 정보 기반 추천
+❌ 3개+ 에이전트 시 Agent Teams 미사용 (가용 환경)
+❌ 팀 정리(shutdown → TeamDelete) 없이 종료
 ```
 
 ## 병렬 실행 체크리스트

package/templates/.claude/skills/bug-fix/SKILL.md

@@ -335,6 +335,25 @@ npm run build
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "bugfix-team", description: "버그 수정" })
+Task(subagent_type="explore", team_name="bugfix-team", name="analyzer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## Parallel Agent Execution
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/docs-creator/SKILL.md

@@ -35,6 +35,25 @@ metadata:
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "docs-team", description: "문서 작성" })
+Task(subagent_type="document-writer", team_name="docs-team", name="writer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 핵심 원칙
 
 | 원칙 | 방법 | 효과 |

package/templates/.claude/skills/docs-fetch/SKILL.md

@@ -337,6 +337,25 @@ docs/library/{name}/
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "docs-fetch-team", description: "문서 수집" })
+Task(subagent_type="researcher", team_name="docs-fetch-team", name="researcher", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## Agent 활용 패턴
 
 | Phase | Agent | Model | 용도 |

package/templates/.claude/skills/docs-refactor/SKILL.md

@@ -39,6 +39,25 @@ metadata:
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "docs-refactor-team", description: "문서 리팩토링" })
+Task(subagent_type="document-writer", team_name="docs-refactor-team", name="writer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 @../docs-creator/SKILL.md#parallel_agent_execution
 
 **리팩토링 특화:**

package/templates/.claude/skills/elon-musk/SKILL.md

@@ -161,6 +161,25 @@ MCP 미가용 시 → researcher가 WebSearch + WebFetch로 수행
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "first-principles-team", description: "제1원칙 분석" })
+Task(subagent_type="researcher", team_name="first-principles-team", name="researcher", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 Agent 실행
 
 ### Phase 1: 도메인 조사 (3방향 동시)

package/templates/.claude/skills/execute/SKILL.md

@@ -44,6 +44,25 @@ user-invocable: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "execute-team", description: "즉시 구현" })
+Task(subagent_type="implementation-executor", team_name="execute-team", name="executor", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/feedback/SKILL.md

@@ -289,6 +289,25 @@ Task({
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "feedback-team", description: "피드백 처리" })
+Task(subagent_type="implementation-executor", team_name="feedback-team", name="executor", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## Parallel Agent Execution
 
 ### Model Routing

package/templates/.claude/skills/figma-to-code/SKILL.md

@@ -39,6 +39,25 @@ ui-only: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "figma-team", description: "Figma to Code 변환" })
+Task(subagent_type="designer", team_name="figma-team", name="designer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## ULTRAWORK MODE (병렬 에이전트 실행)
 
 ### 기본 원칙

package/templates/.claude/skills/global-uiux-design/SKILL.md

@@ -30,6 +30,25 @@ ui-only: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "global-uiux-team", description: "Global UI/UX 디자인" })
+Task(subagent_type="designer", team_name="global-uiux-team", name="designer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행 (Global UX 특화)
 
 ### 핵심 원칙

package/templates/.claude/skills/korea-uiux-design/SKILL.md

@@ -30,6 +30,25 @@ ui-only: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "korea-uiux-team", description: "한국형 UI/UX 디자인" })
+Task(subagent_type="designer", team_name="korea-uiux-team", name="designer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 한국형 UI/UX 병렬 에이전트 실행
 
 ### 핵심 원칙

package/templates/.claude/skills/nextjs-react-best-practices/SKILL.md

@@ -39,6 +39,25 @@ Vercel에서 관리하는 React와 Next.js 애플리케이션 종합 성능 최
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "nextjs-team", description: "Next.js 최적화" })
+Task(subagent_type="general-purpose", team_name="nextjs-team", name="optimizer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행 (ULTRAWORK MODE)
 
 ### 기본 원칙

package/templates/.claude/skills/plan/SKILL.md

@@ -61,6 +61,25 @@ Task({
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "plan-team", description: "계획 수립" })
+Task(subagent_type="planner", team_name="plan-team", name="planner", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md
@@ -730,6 +749,8 @@ Skill({
 ❌ 장단점 없이 옵션만 나열
 ❌ 단일 파일로 문서 생성 (여러 파일로 분리 필수)
 ❌ 문서 생성 후 "구현을 시작할까요?" 물어보기 (즉시 진행)
+❌ 3개+ 에이전트 시 Agent Teams 미사용 (가용 환경)
+❌ 팀 정리(shutdown → TeamDelete) 없이 종료
 ```
 
 </validation>

package/templates/.claude/skills/prd/SKILL.md

@@ -117,6 +117,25 @@ user-invocable: true
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "prd-team", description: "PRD 작성" })
+Task(subagent_type="analyst", team_name="prd-team", name="analyst", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 Agent 실행
 
 ### Agent & Model Routing

package/templates/.claude/skills/project-optimizer/SKILL.md

@@ -41,6 +41,25 @@ metadata:
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "optimizer-team", description: "프로젝트 최적화" })
+Task(subagent_type="analyst", team_name="optimizer-team", name="analyst", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 ### 기본 원칙

package/templates/.claude/skills/refactor/SKILL.md

@@ -150,6 +150,25 @@ $ARGUMENTS 있음 → 다음 단계 진행
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "refactor-team", description: "리팩토링" })
+Task(subagent_type="refactor-advisor", team_name="refactor-team", name="advisor", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 @../../instructions/agent-patterns/delegation-patterns.md

package/templates/.claude/skills/research/SKILL.md

@@ -78,6 +78,38 @@ Phase 0에서 자동 분류 → 채널 조합 결정:
 
 ---
 
+<parallel_agent_execution>
+
+### ⚠️ Agent Teams 필수 원칙
+
+> **3개+ 병렬 에이전트 사용 시 Agent Teams 필수** (가용 환경에서)
+> - Agent Teams 가용 → `TeamCreate` → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**기본 실행 패턴 (standard/deep):**
+```typescript
+// Phase 0: 팀 생성 (standard: 3-4명, deep: 4-6명)
+TeamCreate({ team_name: "research-team", description: "자료 조사" })
+
+// Phase 2: 팀원 스폰 (병렬)
+Task({ subagent_type: "researcher", team_name: "research-team", name: "r1", prompt: "기술 A 조사..." })
+Task({ subagent_type: "researcher", team_name: "research-team", name: "r2", prompt: "기술 B 조사..." })
+Task({ subagent_type: "researcher", team_name: "research-team", name: "r3", prompt: "비교 분석..." })
+Task({ subagent_type: "explore", team_name: "research-team", name: "explorer", model: "haiku", prompt: "gh search..." })
+```
+
+**수명주기 관리 (필수):**
+| 단계 | 행동 |
+|------|------|
+| 완료 | 팀원별 `shutdown_request` 전송 |
+| 해산 | `TeamDelete`로 팀 정리 |
+
+**quick 모드 예외:** 2명 이하 → Task 직접 호출 허용
+
+</parallel_agent_execution>
+
+---
+
 <sourcing_strategy>
 
 @../../instructions/sourcing/reliable-search.md
@@ -253,6 +285,6 @@ gRPC가 처리량/레이턴시 우위(HTTP/2)이나 브라우저 미지원.
 | **리포트** | Exec Summary 250-400자, 출처, 비교 테이블, 권장사항, 참고자료, 메타데이터 |
 | **저장** | .claude/research/ 저장, 터미널 출력, 경로 안내 |
 
-**절대 금지:** 출처 없는 주장 / 단일 소스 리포트 / Exec Summary 누락 / 권장사항 누락 / 저장 안 함 / 라이브러리 주제 (→ docs-fetch) / **연도 없는 검색** / **출처 등급 미표기**
+**절대 금지:** 출처 없는 주장 / 단일 소스 리포트 / Exec Summary 누락 / 권장사항 누락 / 저장 안 함 / 라이브러리 주제 (→ docs-fetch) / **연도 없는 검색** / **출처 등급 미표기** / **3개+ 에이전트 시 Agent Teams 미사용** (가용 환경) / **팀 정리 없이 종료**
 
 </validation>

package/templates/.claude/skills/sql-optimizer/SKILL.md

@@ -263,6 +263,25 @@ thought 5: "추천: 옵션 B - ORM 최적화 + Partial Index
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "sql-team", description: "SQL 최적화" })
+Task(subagent_type="architect", team_name="sql-team", name="architect", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 ```typescript

package/templates/.claude/skills/tanstack-start-react-best-practices/SKILL.md

@@ -40,6 +40,25 @@ React 19와 TanStack Start v1 애플리케이션 성능 최적화 가이드. 8
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "tanstack-team", description: "TanStack Start 최적화" })
+Task(subagent_type="general-purpose", team_name="tanstack-team", name="optimizer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 **ULTRAWORK MODE:** TanStack Start 최적화 작업 시 여러 규칙을 동시에 적용하여 5-15배 성능 향상.

package/templates/.claude/skills/tauri-react-best-practices/SKILL.md

@@ -43,6 +43,25 @@ Tauri v2 + React 19 데스크톱/모바일 애플리케이션 성능 및 보안
 
 <parallel_agent_execution>
 
+### ⚠️ Agent Teams 우선 원칙
+
+> **복잡한 병렬 작업 시 Agent Teams를 기본으로 사용**
+> - Agent Teams 가용 → TeamCreate → 팀원 spawn → 병렬 협업
+> - Agent Teams 미가용 → Task 병렬 호출 (폴백)
+
+**Agent Teams 모드 (기본)**:
+```typescript
+TeamCreate({ team_name: "tauri-team", description: "Tauri + React 최적화" })
+Task(subagent_type="general-purpose", team_name="tauri-team", name="optimizer", ...)
+```
+
+**수명주기 관리:**
+- 팀원 태스크 완료 → 즉시 `shutdown_request` 전송
+- 종료 후 `TaskList`로 다음 태스크 확인
+- 모든 작업 완료 → `TeamDelete`로 팀 해산
+
+---
+
 ## 병렬 에이전트 실행
 
 **ULTRAWORK MODE:** Tauri + React 최적화 작업 시 여러 규칙을 동시에 적용.