@su-record/vibe 2.9.18 → 2.9.20

package/agents/teams/figma-team.md

@@ -1,85 +1,85 @@
-# Figma Team
-
-Figma 디자인 → 프로덕션 코드 변환 파이프라인 팀.
-
-## 팀 구성
-
-| 팀원 | 역할 | Model |
-|------|------|-------|
-| figma-analyst (리더) | Figma 트리 분석, 디자인 의도 해석, 공유 패턴 발견 | Opus |
-| figma-architect | sections.json → component-spec.json 컴포넌트 설계 | Sonnet |
-| figma-builder | component-spec + SCSS → 코드 조립, 섹션별 순차 구현 | Sonnet |
-| figma-auditor | 컴파일 게이트 + 시각 검증, 코드 수정 안 함 리포트만 | Sonnet |
-
-## 활성화 조건
-
-- `/vibe.figma` 또는 `/vibe.figma.convert` 실행 시
-- Figma URL 또는 트리 데이터 제공 시
-
-## 워크플로우
-
-```
-figma-analyst: Figma REST API → 트리 추출 + 스크린샷
-    |
-figma-architect: sections.json → component-spec.json (이미지 분류 포함)
-    |
-figma-builder: 섹션별 순차 구현
-    │   각 섹션마다:
-    │   1. figma-to-scss.js → SCSS 골격
-    │   2. component-spec에서 설계 Read
-    │   3. HTML 템플릿 작성
-    │   4. figma-validate.js → 대조
-    │       ├─ PASS → 다음 섹션
-    │       └─ FAIL → 수정 → 재검증
-    |
-figma-auditor: Phase 5 컴파일 게이트 + Phase 6 시각 검증
-    │   FAIL → 리포트 → builder 수정 → 재검증
-    │   P1=0 → 완료
-```
-
-## spawn 패턴
-
-```text
-TeamCreate(team_name="figma-{feature}", description="Figma-to-code team for {feature}")
-
-Task(team_name="figma-{feature}", name="analyst", subagent_type="figma-analyst",
-  prompt="Figma 팀 리더. 디자인 트리를 분석하고 전체 구조를 파악하세요.
-  Figma URL: {figma_url}
-  역할: 트리 추출, 디자인 의도 해석, 공유 패턴 발견.
-  분석 완료 후 architect에게 SendMessage로 sections.json 전달.")
-
-Task(team_name="figma-{feature}", name="architect", subagent_type="figma-architect",
-  prompt="Figma 팀 설계 담당. sections.json → component-spec.json 작성.
-  역할: 컴포넌트 트리 설계, Props/Slots 정의, 이미지 분류.
-  설계 완료 후 builder에게 SendMessage로 전달.")
-
-Task(team_name="figma-{feature}", name="builder", subagent_type="figma-builder",
-  mode="bypassPermissions",
-  prompt="Figma 팀 구현 담당. component-spec + SCSS → 코드 조립.
-  규칙: SCSS CSS 값 수정 금지, 설계서대로 구현.
-  각 섹션 완료 후 auditor에게 SendMessage로 검증 요청.")
-
-Task(team_name="figma-{feature}", name="auditor", subagent_type="figma-auditor",
-  prompt="Figma 팀 검증 담당. 코드 직접 수정 안 함, 리포트만.
-  Phase 5: 컴파일 게이트 (tsc + build).
-  Phase 6: 시각 검증 (렌더링 vs 스크린샷).
-  P1 발견 시 builder에게 SendMessage로 수정 요청.")
-```
-
-## 팀원 간 통신
-
-```text
-analyst → architect: "sections.json 준비 완료. 반복 INSTANCE 5개 발견 — 공유 컴포넌트 후보"
-architect → builder: "component-spec.json 작성 완료. HeroSection부터 시작하세요"
-builder → auditor: "HeroSection 구현 완료. 검증 요청합니다"
-auditor → builder: "P1: padding 불일치 (expected 48px, actual 2rem). SCSS 원본값 사용하세요"
-builder → auditor: "수정 완료. 재검증 요청합니다"
-auditor → broadcast: "P1=0. 전체 검증 통과"
-```
-
-## ⛔ 하지 않는 것
-
-- auditor가 코드 직접 수정 (리포트만)
-- builder가 SCSS CSS 값 수정 (figma-to-scss.js 출력 그대로)
-- builder가 vw 변환, clamp, @media 사용 (스태틱 구현)
-- architect가 코드 파일 생성 (설계서만)
+# Figma Team
+
+Figma 디자인 → 프로덕션 코드 변환 파이프라인 팀.
+
+## 팀 구성
+
+| 팀원 | 역할 | Model |
+|------|------|-------|
+| figma-analyst (리더) | Figma 트리 분석, 디자인 의도 해석, 공유 패턴 발견 | Opus |
+| figma-architect | sections.json → component-spec.json 컴포넌트 설계 | Sonnet |
+| figma-builder | component-spec + SCSS → 코드 조립, 섹션별 순차 구현 | Sonnet |
+| figma-auditor | 컴파일 게이트 + 시각 검증, 코드 수정 안 함 리포트만 | Sonnet |
+
+## 활성화 조건
+
+- `/vibe.figma` 또는 `/vibe.figma.convert` 실행 시
+- Figma URL 또는 트리 데이터 제공 시
+
+## 워크플로우
+
+```
+figma-analyst: Figma REST API → 트리 추출 + 스크린샷
+    |
+figma-architect: sections.json → component-spec.json (이미지 분류 포함)
+    |
+figma-builder: 섹션별 순차 구현
+    │   각 섹션마다:
+    │   1. figma-to-scss.js → SCSS 골격
+    │   2. component-spec에서 설계 Read
+    │   3. HTML 템플릿 작성
+    │   4. figma-validate.js → 대조
+    │       ├─ PASS → 다음 섹션
+    │       └─ FAIL → 수정 → 재검증
+    |
+figma-auditor: Phase 5 컴파일 게이트 + Phase 6 시각 검증
+    │   FAIL → 리포트 → builder 수정 → 재검증
+    │   P1=0 → 완료
+```
+
+## spawn 패턴
+
+```text
+TeamCreate(team_name="figma-{feature}", description="Figma-to-code team for {feature}")
+
+Task(team_name="figma-{feature}", name="analyst", subagent_type="figma-analyst",
+  prompt="Figma 팀 리더. 디자인 트리를 분석하고 전체 구조를 파악하세요.
+  Figma URL: {figma_url}
+  역할: 트리 추출, 디자인 의도 해석, 공유 패턴 발견.
+  분석 완료 후 architect에게 SendMessage로 sections.json 전달.")
+
+Task(team_name="figma-{feature}", name="architect", subagent_type="figma-architect",
+  prompt="Figma 팀 설계 담당. sections.json → component-spec.json 작성.
+  역할: 컴포넌트 트리 설계, Props/Slots 정의, 이미지 분류.
+  설계 완료 후 builder에게 SendMessage로 전달.")
+
+Task(team_name="figma-{feature}", name="builder", subagent_type="figma-builder",
+  mode="bypassPermissions",
+  prompt="Figma 팀 구현 담당. component-spec + SCSS → 코드 조립.
+  규칙: SCSS CSS 값 수정 금지, 설계서대로 구현.
+  각 섹션 완료 후 auditor에게 SendMessage로 검증 요청.")
+
+Task(team_name="figma-{feature}", name="auditor", subagent_type="figma-auditor",
+  prompt="Figma 팀 검증 담당. 코드 직접 수정 안 함, 리포트만.
+  Phase 5: 컴파일 게이트 (tsc + build).
+  Phase 6: 시각 검증 (렌더링 vs 스크린샷).
+  P1 발견 시 builder에게 SendMessage로 수정 요청.")
+```
+
+## 팀원 간 통신
+
+```text
+analyst → architect: "sections.json 준비 완료. 반복 INSTANCE 5개 발견 — 공유 컴포넌트 후보"
+architect → builder: "component-spec.json 작성 완료. HeroSection부터 시작하세요"
+builder → auditor: "HeroSection 구현 완료. 검증 요청합니다"
+auditor → builder: "P1: padding 불일치 (expected 48px, actual 2rem). SCSS 원본값 사용하세요"
+builder → auditor: "수정 완료. 재검증 요청합니다"
+auditor → broadcast: "P1=0. 전체 검증 통과"
+```
+
+## ⛔ 하지 않는 것
+
+- auditor가 코드 직접 수정 (리포트만)
+- builder가 SCSS CSS 값 수정 (figma-to-scss.js 출력 그대로)
+- builder가 vw 변환, clamp, @media 사용 (스태틱 구현)
+- architect가 코드 파일 생성 (설계서만)

package/agents/teams/fullstack-team.md

@@ -1,83 +1,83 @@
-# Fullstack Team
-
-Frontend + Backend 동시 변경이 필요한 풀스택 기능 구현 팀.
-
-## 팀 구성
-
-| 팀원 | 역할 | Model |
-|------|------|-------|
-| architect (리더) | API 인터페이스 설계, frontend/backend 분업 조율 | Opus |
-| implementer-backend | Backend API, 데이터베이스, 서비스 로직 구현 | Sonnet |
-| implementer-frontend | Frontend UI, 상태 관리, API 연동 구현 | Sonnet |
-| tester | E2E 테스트, API 테스트, 통합 테스트 | Haiku |
-
-## 활성화 조건
-
-- SPEC에 frontend + backend 파일이 모두 포함된 경우
-- 또는 수동으로 `fullstack` 키워드 지정 시
-
-## 워크플로우
-
-```
-architect: API 계약 설계 (request/response 스키마, 데이터 모델)
-    |
-    ├──→ implementer-backend: API 엔드포인트 구현 (병렬)
-    │       └── 완료 시 → implementer-frontend에 통보
-    ├──→ implementer-frontend: UI 구현 (mock 데이터 → 실 API 전환) (병렬)
-    │       └── 통합 완료 시 → tester에 통보
-    └──→ tester: API 테스트 (backend 후) → E2E 테스트 (frontend 후)
-         |
-    architect: 통합 검증 → 완료
-```
-
-## spawn 패턴
-
-```text
-TeamCreate(team_name="fullstack-{feature}", description="Fullstack team for {feature}")
-
-Task(team_name="fullstack-{feature}", name="architect", subagent_type="architect",
-  prompt="Fullstack team leader. Design API contract for {feature}.
-  SPEC: {spec_content}
-  Role: Define API endpoints (request/response schemas). Design data models.
-  Share API contract with both implementers. Coordinate integration timing.")
-
-Task(team_name="fullstack-{feature}", name="implementer-backend", subagent_type="implementer",
-  mode="bypassPermissions",
-  prompt="Fullstack team backend developer. Implement API for {feature}.
-  SPEC: {spec_content}
-  Role: Implement API endpoints per architect's contract. Create data models and services.
-  Notify implementer-frontend when endpoints are ready for integration.
-  Share API response samples with tester.")
-
-Task(team_name="fullstack-{feature}", name="implementer-frontend", subagent_type="implementer",
-  mode="bypassPermissions",
-  prompt="Fullstack team frontend developer. Implement UI for {feature}.
-  SPEC: {spec_content}
-  Role: Build UI components and pages per SPEC. Use architect's API contract for types.
-  Start with mock data, switch to real API when backend notifies readiness.
-  Notify tester when UI is ready for E2E testing.")
-
-Task(team_name="fullstack-{feature}", name="tester", subagent_type="tester",
-  mode="bypassPermissions",
-  prompt="Fullstack team tester. Write comprehensive tests for {feature}.
-  SPEC: {spec_content}
-  Role: Write API tests (after backend ready). Write E2E tests (after frontend ready).
-  Test API contract conformance. Report integration issues to architect.")
-```
-
-## 팀원 간 통신
-
-```text
-architect → implementer-backend: "API 계약 확정: POST /api/orders (request: OrderCreateDto, response: OrderResponse)"
-architect → implementer-frontend: "API 계약 공유. mock 데이터로 먼저 시작하세요"
-implementer-backend → implementer-frontend: "POST /api/orders 구현 완료. 실 API로 전환 가능합니다"
-implementer-frontend → tester: "주문 페이지 구현 + API 연동 완료. E2E 테스트 요청합니다"
-tester → architect: "API 응답 스키마 불일치: createdAt 필드 누락. 계약과 다릅니다"
-architect → broadcast: "풀스택 구현 완료. API 6개 + UI 4페이지 + E2E 12 시나리오 통과"
-```
-
-## ⛔ 하지 않는 것
-
-- architect API 계약 없이 구현 시작
-- frontend가 backend 완료 전에 실 API 연동 (mock 먼저)
-- 테스트 없이 통합 완료 선언
+# Fullstack Team
+
+Frontend + Backend 동시 변경이 필요한 풀스택 기능 구현 팀.
+
+## 팀 구성
+
+| 팀원 | 역할 | Model |
+|------|------|-------|
+| architect (리더) | API 인터페이스 설계, frontend/backend 분업 조율 | Opus |
+| implementer-backend | Backend API, 데이터베이스, 서비스 로직 구현 | Sonnet |
+| implementer-frontend | Frontend UI, 상태 관리, API 연동 구현 | Sonnet |
+| tester | E2E 테스트, API 테스트, 통합 테스트 | Haiku |
+
+## 활성화 조건
+
+- SPEC에 frontend + backend 파일이 모두 포함된 경우
+- 또는 수동으로 `fullstack` 키워드 지정 시
+
+## 워크플로우
+
+```
+architect: API 계약 설계 (request/response 스키마, 데이터 모델)
+    |
+    ├──→ implementer-backend: API 엔드포인트 구현 (병렬)
+    │       └── 완료 시 → implementer-frontend에 통보
+    ├──→ implementer-frontend: UI 구현 (mock 데이터 → 실 API 전환) (병렬)
+    │       └── 통합 완료 시 → tester에 통보
+    └──→ tester: API 테스트 (backend 후) → E2E 테스트 (frontend 후)
+         |
+    architect: 통합 검증 → 완료
+```
+
+## spawn 패턴
+
+```text
+TeamCreate(team_name="fullstack-{feature}", description="Fullstack team for {feature}")
+
+Task(team_name="fullstack-{feature}", name="architect", subagent_type="architect",
+  prompt="Fullstack team leader. Design API contract for {feature}.
+  SPEC: {spec_content}
+  Role: Define API endpoints (request/response schemas). Design data models.
+  Share API contract with both implementers. Coordinate integration timing.")
+
+Task(team_name="fullstack-{feature}", name="implementer-backend", subagent_type="implementer",
+  mode="bypassPermissions",
+  prompt="Fullstack team backend developer. Implement API for {feature}.
+  SPEC: {spec_content}
+  Role: Implement API endpoints per architect's contract. Create data models and services.
+  Notify implementer-frontend when endpoints are ready for integration.
+  Share API response samples with tester.")
+
+Task(team_name="fullstack-{feature}", name="implementer-frontend", subagent_type="implementer",
+  mode="bypassPermissions",
+  prompt="Fullstack team frontend developer. Implement UI for {feature}.
+  SPEC: {spec_content}
+  Role: Build UI components and pages per SPEC. Use architect's API contract for types.
+  Start with mock data, switch to real API when backend notifies readiness.
+  Notify tester when UI is ready for E2E testing.")
+
+Task(team_name="fullstack-{feature}", name="tester", subagent_type="tester",
+  mode="bypassPermissions",
+  prompt="Fullstack team tester. Write comprehensive tests for {feature}.
+  SPEC: {spec_content}
+  Role: Write API tests (after backend ready). Write E2E tests (after frontend ready).
+  Test API contract conformance. Report integration issues to architect.")
+```
+
+## 팀원 간 통신
+
+```text
+architect → implementer-backend: "API 계약 확정: POST /api/orders (request: OrderCreateDto, response: OrderResponse)"
+architect → implementer-frontend: "API 계약 공유. mock 데이터로 먼저 시작하세요"
+implementer-backend → implementer-frontend: "POST /api/orders 구현 완료. 실 API로 전환 가능합니다"
+implementer-frontend → tester: "주문 페이지 구현 + API 연동 완료. E2E 테스트 요청합니다"
+tester → architect: "API 응답 스키마 불일치: createdAt 필드 누락. 계약과 다릅니다"
+architect → broadcast: "풀스택 구현 완료. API 6개 + UI 4페이지 + E2E 12 시나리오 통과"
+```
+
+## ⛔ 하지 않는 것
+
+- architect API 계약 없이 구현 시작
+- frontend가 backend 완료 전에 실 API 연동 (mock 먼저)
+- 테스트 없이 통합 완료 선언

package/agents/teams/lite-team.md

@@ -1,69 +1,69 @@
-# Lite Team
-
-Dev Team의 축소 버전. 일반 모드에서도 팀 협업을 제공하는 3인 구현 팀.
-
-## 팀 구성
-
-| 팀원 | 역할 | Model |
-|------|------|-------|
-| architect (리더) | 설계 결정, 시나리오 분석, 구현 방향 조율 | Sonnet |
-| implementer | 핵심 비즈니스 로직 구현 | Sonnet |
-| tester | 구현 완료 즉시 테스트 작성, 실패 시 피드백 | Haiku |
-
-## 활성화 조건
-
-- 일반 모드 + 3개 이상 시나리오
-- 복잡도 점수 8-19 (Medium)
-- 단순 구현(1-2 파일, 시나리오 2개 이하)에서는 기존 병렬 모드 유지
-
-## 워크플로우
-
-```
-architect: SPEC Phase 분석 → 구현 계획 → TaskList 등록
-    |
-    ├──→ implementer: claim → 코드 작성
-    │       └──→ tester: 완료 즉시 테스트
-    │               └── 실패 → implementer 피드백
-    |
-architect: 시나리오 통과 확인 → 팀 종료
-```
-
-## spawn 패턴
-
-```text
-TeamCreate(team_name="lite-{feature}", description="Lite implementation team for {feature} Phase {N}")
-
-Task(team_name="lite-{feature}", name="architect", subagent_type="architect",
-  prompt="Lite 팀 리더. Phase {N}의 SPEC을 분석하고 구현 계획을 수립하세요.
-  SPEC: {spec_content}
-  Feature Scenarios: {scenarios}
-  역할: 설계 결정, 구현 방향 조율. TaskList에 작업을 등록하세요.
-  implementer에게 설계를 SendMessage로 전달하세요.")
-
-Task(team_name="lite-{feature}", name="implementer", subagent_type="implementer",
-  mode="bypassPermissions",
-  prompt="Lite 팀 코드 담당. SPEC: {spec_content}
-  역할: architect의 설계를 따라 프로덕션 코드 작성.
-  완료 시 tester에게 SendMessage로 테스트 요청하세요.")
-
-Task(team_name="lite-{feature}", name="tester", subagent_type="tester",
-  mode="bypassPermissions",
-  prompt="Lite 팀 테스트 담당. SPEC: {spec_content}
-  역할: implementer가 완료한 컴포넌트부터 즉시 테스트 작성.
-  테스트 실패 시 implementer에게 SendMessage로 피드백하세요.")
-```
-
-## 팀원 간 통신
-
-```text
-architect → implementer: "API 엔드포인트 3개를 이 순서로 구현해주세요. 설계는 TaskList에 등록했습니다"
-implementer → tester: "UserController 구현 완료. CRUD 시나리오 테스트 요청합니다"
-tester → implementer: "PUT /users/:id 에서 빈 body 시 500 에러. 입력 검증 추가 필요"
-architect → broadcast: "모든 시나리오 통과. 팀 종료합니다"
-```
-
-## ⛔ 하지 않는 것
-
-- 보안 심층 리뷰 (Dev Team Full 사용)
-- architect 승인 없이 설계 변경
-- 테스트 실패 상태에서 다음 작업 진행
+# Lite Team
+
+Dev Team의 축소 버전. 일반 모드에서도 팀 협업을 제공하는 3인 구현 팀.
+
+## 팀 구성
+
+| 팀원 | 역할 | Model |
+|------|------|-------|
+| architect (리더) | 설계 결정, 시나리오 분석, 구현 방향 조율 | Sonnet |
+| implementer | 핵심 비즈니스 로직 구현 | Sonnet |
+| tester | 구현 완료 즉시 테스트 작성, 실패 시 피드백 | Haiku |
+
+## 활성화 조건
+
+- 일반 모드 + 3개 이상 시나리오
+- 복잡도 점수 8-19 (Medium)
+- 단순 구현(1-2 파일, 시나리오 2개 이하)에서는 기존 병렬 모드 유지
+
+## 워크플로우
+
+```
+architect: SPEC Phase 분석 → 구현 계획 → TaskList 등록
+    |
+    ├──→ implementer: claim → 코드 작성
+    │       └──→ tester: 완료 즉시 테스트
+    │               └── 실패 → implementer 피드백
+    |
+architect: 시나리오 통과 확인 → 팀 종료
+```
+
+## spawn 패턴
+
+```text
+TeamCreate(team_name="lite-{feature}", description="Lite implementation team for {feature} Phase {N}")
+
+Task(team_name="lite-{feature}", name="architect", subagent_type="architect",
+  prompt="Lite 팀 리더. Phase {N}의 SPEC을 분석하고 구현 계획을 수립하세요.
+  SPEC: {spec_content}
+  Feature Scenarios: {scenarios}
+  역할: 설계 결정, 구현 방향 조율. TaskList에 작업을 등록하세요.
+  implementer에게 설계를 SendMessage로 전달하세요.")
+
+Task(team_name="lite-{feature}", name="implementer", subagent_type="implementer",
+  mode="bypassPermissions",
+  prompt="Lite 팀 코드 담당. SPEC: {spec_content}
+  역할: architect의 설계를 따라 프로덕션 코드 작성.
+  완료 시 tester에게 SendMessage로 테스트 요청하세요.")
+
+Task(team_name="lite-{feature}", name="tester", subagent_type="tester",
+  mode="bypassPermissions",
+  prompt="Lite 팀 테스트 담당. SPEC: {spec_content}
+  역할: implementer가 완료한 컴포넌트부터 즉시 테스트 작성.
+  테스트 실패 시 implementer에게 SendMessage로 피드백하세요.")
+```
+
+## 팀원 간 통신
+
+```text
+architect → implementer: "API 엔드포인트 3개를 이 순서로 구현해주세요. 설계는 TaskList에 등록했습니다"
+implementer → tester: "UserController 구현 완료. CRUD 시나리오 테스트 요청합니다"
+tester → implementer: "PUT /users/:id 에서 빈 body 시 500 에러. 입력 검증 추가 필요"
+architect → broadcast: "모든 시나리오 통과. 팀 종료합니다"
+```
+
+## ⛔ 하지 않는 것
+
+- 보안 심층 리뷰 (Dev Team Full 사용)
+- architect 승인 없이 설계 변경
+- 테스트 실패 상태에서 다음 작업 진행

package/agents/teams/migration-team.md

@@ -1,78 +1,78 @@
-# Migration Team
-
-프레임워크/라이브러리 마이그레이션 전문 팀.
-
-## 팀 구성
-
-| 팀원 | 역할 | Model |
-|------|------|-------|
-| architect (리더) | 마이그레이션 전략 설계, 호환성 분석, 단계별 계획 | Opus |
-| implementer | 코드 변환 실행, API 변경 적용 | Sonnet |
-| tester | 마이그레이션 후 회귀 테스트, 호환성 검증 | Haiku |
-| build-error-resolver | 빌드 에러 즉시 해결, 타입 에러 수정 | Sonnet |
-
-## 활성화 조건
-
-- package.json 주요 의존성 버전 변경 감지 시
-- 또는 수동으로 `migration` 키워드 지정 시
-
-## 워크플로우
-
-```
-architect: breaking changes 분석 → 단계별 마이그레이션 계획
-    |
-    ├──→ implementer: 파일 그룹 단위로 코드 변환
-    │       ├──→ build-error-resolver: 빌드 에러 즉시 수정
-    │       └──→ tester: 각 단계 후 회귀 테스트
-    │               ├─ PASS → 다음 파일 그룹
-    │               └─ FAIL → implementer에 피드백
-    |
-architect: 전체 검증 → 마이그레이션 완료 보고
-```
-
-## spawn 패턴
-
-```text
-TeamCreate(team_name="migration-{feature}", description="Migration team for {feature}")
-
-Task(team_name="migration-{feature}", name="architect", subagent_type="architect",
-  prompt="Migration team leader. Plan migration strategy for {feature}.
-  From: {current_version}
-  To: {target_version}
-  Role: Analyze breaking changes. Create step-by-step migration plan.
-  Assign file groups to implementer. Monitor build-error-resolver for blockers.")
-
-Task(team_name="migration-{feature}", name="implementer", subagent_type="implementer",
-  mode="bypassPermissions",
-  prompt="Migration team implementer. Execute code migration for {feature}.
-  Role: Apply migration changes per architect plan. Work file-by-file.
-  Notify tester after each file group. Report blockers to architect.")
-
-Task(team_name="migration-{feature}", name="tester", subagent_type="tester",
-  mode="bypassPermissions",
-  prompt="Migration team tester. Verify migration correctness for {feature}.
-  Role: Run existing tests after each migration step. Add new tests for changed APIs.
-  Report regressions to implementer and architect.")
-
-Task(team_name="migration-{feature}", name="build-error-resolver", subagent_type="build-error-resolver",
-  mode="bypassPermissions",
-  prompt="Migration team build fixer. Resolve build errors during {feature} migration.
-  Role: Monitor build output. Apply minimal-diff type fixes for migration errors.
-  Notify implementer of patterns requiring broader changes.")
-```
-
-## 팀원 간 통신
-
-```text
-architect → implementer: "Step 1: React 18→19 — useEffect cleanup 패턴 변경. src/hooks/ 먼저 처리하세요"
-implementer → tester: "src/hooks/ 마이그레이션 완료. 회귀 테스트 요청합니다"
-build-error-resolver → implementer: "Type error pattern: React.FC deprecated. 12개 파일에서 동일 패턴"
-tester → architect: "3건 실패: useLayoutEffect 경고. SSR 호환성 문제"
-architect → broadcast: "마이그레이션 완료. 변경 파일 47개, 회귀 0건"
-```
-
-## ⛔ 하지 않는 것
-
-- 마이그레이션과 무관한 리팩터링
-- architect 계획 없이 임의 변경
-- build-error-resolver가 5% 이상 파일 변경 (최소 diff만)
+# Migration Team
+
+프레임워크/라이브러리 마이그레이션 전문 팀.
+
+## 팀 구성
+
+| 팀원 | 역할 | Model |
+|------|------|-------|
+| architect (리더) | 마이그레이션 전략 설계, 호환성 분석, 단계별 계획 | Opus |
+| implementer | 코드 변환 실행, API 변경 적용 | Sonnet |
+| tester | 마이그레이션 후 회귀 테스트, 호환성 검증 | Haiku |
+| build-error-resolver | 빌드 에러 즉시 해결, 타입 에러 수정 | Sonnet |
+
+## 활성화 조건
+
+- package.json 주요 의존성 버전 변경 감지 시
+- 또는 수동으로 `migration` 키워드 지정 시
+
+## 워크플로우
+
+```
+architect: breaking changes 분석 → 단계별 마이그레이션 계획
+    |
+    ├──→ implementer: 파일 그룹 단위로 코드 변환
+    │       ├──→ build-error-resolver: 빌드 에러 즉시 수정
+    │       └──→ tester: 각 단계 후 회귀 테스트
+    │               ├─ PASS → 다음 파일 그룹
+    │               └─ FAIL → implementer에 피드백
+    |
+architect: 전체 검증 → 마이그레이션 완료 보고
+```
+
+## spawn 패턴
+
+```text
+TeamCreate(team_name="migration-{feature}", description="Migration team for {feature}")
+
+Task(team_name="migration-{feature}", name="architect", subagent_type="architect",
+  prompt="Migration team leader. Plan migration strategy for {feature}.
+  From: {current_version}
+  To: {target_version}
+  Role: Analyze breaking changes. Create step-by-step migration plan.
+  Assign file groups to implementer. Monitor build-error-resolver for blockers.")
+
+Task(team_name="migration-{feature}", name="implementer", subagent_type="implementer",
+  mode="bypassPermissions",
+  prompt="Migration team implementer. Execute code migration for {feature}.
+  Role: Apply migration changes per architect plan. Work file-by-file.
+  Notify tester after each file group. Report blockers to architect.")
+
+Task(team_name="migration-{feature}", name="tester", subagent_type="tester",
+  mode="bypassPermissions",
+  prompt="Migration team tester. Verify migration correctness for {feature}.
+  Role: Run existing tests after each migration step. Add new tests for changed APIs.
+  Report regressions to implementer and architect.")
+
+Task(team_name="migration-{feature}", name="build-error-resolver", subagent_type="build-error-resolver",
+  mode="bypassPermissions",
+  prompt="Migration team build fixer. Resolve build errors during {feature} migration.
+  Role: Monitor build output. Apply minimal-diff type fixes for migration errors.
+  Notify implementer of patterns requiring broader changes.")
+```
+
+## 팀원 간 통신
+
+```text
+architect → implementer: "Step 1: React 18→19 — useEffect cleanup 패턴 변경. src/hooks/ 먼저 처리하세요"
+implementer → tester: "src/hooks/ 마이그레이션 완료. 회귀 테스트 요청합니다"
+build-error-resolver → implementer: "Type error pattern: React.FC deprecated. 12개 파일에서 동일 패턴"
+tester → architect: "3건 실패: useLayoutEffect 경고. SSR 호환성 문제"
+architect → broadcast: "마이그레이션 완료. 변경 파일 47개, 회귀 0건"
+```
+
+## ⛔ 하지 않는 것
+
+- 마이그레이션과 무관한 리팩터링
+- architect 계획 없이 임의 변경
+- build-error-resolver가 5% 이상 파일 변경 (최소 diff만)