// 단일 에이전트 - 모든 컨텍스트를 하나의 세션에서 관리
컨텍스트 = [API 코드 + 프론트엔드 코드 + 테스트 코드 + 문서]

// Agent Teams - 컨텍스트 분산
팀 리드 = [프로젝트 구조 + 작업 계획]
API 팀원 = [API 코드]
프론트엔드 팀원 = [프론트엔드 코드]
테스트 팀원 = [테스트 코드]

// ~/.claude/settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude code

// 메인 세션에서 사용자가 입력하는 예시

"인증 시스템을 검토할 에이전트 팀을 만들어줘. 다음 3명의 팀원을 생성해줘:

1. security-reviewer: 보안 취약점 감사, 토큰 처리 검증
2. performance-analyst: 응답 시간 프로파일링, 병목 구간 파악
3. test-coverage-checker: 엣지 케이스 검증, 미테스트 경로 찾기

팀원들은 작업 목록을 공유하고 서로 협력해서 진행해줘."

# Claude의 응답 예시
✓ Team created: auth-review-team
✓ Spawned teammate: security-reviewer
✓ Spawned teammate: performance-analyst
✓ Spawned teammate: test-coverage-checker
✓ Shared task list created

Teammates are ready. Starting parallel work...

# 메인 터미널에서 모든 팀원 작업 확인
# 키보드 단축키:
Shift+Up/Down  # 팀원 간 전환
Enter          # 선택한 팀원의 세션 보기
Esc            # 팀원 작업 중단
Ctrl+T         # 작업 목록 토글

# 각 팀원이 별도 패널에 표시
┌─────────────────┬─────────────────┐
│ Team Lead       │ security-review │
├─────────────────┼─────────────────┤
│ performance-    │ test-coverage-  │
│ analyst         │ checker         │
└─────────────────┴─────────────────┘

# 마우스 클릭으로 패널 전환 및 상호작용

// In-process 모드에서
// Shift+Up/Down으로 "security-reviewer" 선택 후 입력

"JWT 토큰 검증 부분을 우선적으로 확인해줘.
만료 시간과 리프레시 토큰 로직을 중점적으로 봐줘."

"security-reviewer에게 메시지 전달해줘:
인증 모듈의 JWT 검증 로직을 우선 검토 바랍니다."

// performance-analyst → security-reviewer
"인증 API의 응답 시간이 평균 500ms인데,
토큰 검증 로직에서 병목이 발생하는 것 같아요.
확인 부탁드려요."

// security-reviewer → performance-analyst
"확인했어요. Redis 캐싱을 추가하면
200ms로 줄일 수 있을 것 같아요."

// security-reviewer → team-lead
"JWT 검증 최적화 방안을 찾았습니다.
Redis 캐싱 도입을 권장합니다."

## 인증 시스템 검토 결과

### Security Review (security-reviewer)

- ✅ JWT 토큰 검증 로직 안전함
- ⚠️ 리프레시 토큰 만료 시간 너무 김 (30일 → 7일 권장)
- ✅ HTTPS 강제 적용됨

### Performance Analysis (performance-analyst)

- ⚠️ 인증 API 평균 응답 시간: 500ms
- 💡 Redis 캐싱 도입 시 200ms로 개선 가능
- ✅ 동시 요청 처리 성능 양호

### Test Coverage (test-coverage-checker)

- ⚠️ 엣지 케이스 미테스트: 만료된 토큰 갱신
- ⚠️ 동시 로그인 시나리오 테스트 부족
- ✅ 기본 인증 플로우 100% 커버리지

### 권장 사항

1. Redis 캐싱 도입 (성능 개선)
2. 리프레시 토큰 만료 시간 단축 (보안 강화)
3. 엣지 케이스 테스트 추가

// 사용자 → 메인 세션
"Next.js 15 프로젝트의 SEO를 개선하는 에이전트 팀을 만들어줘:

1. meta-tags-specialist: 메타 태그 최적화, Open Graph 설정
2. sitemap-generator: sitemap.xml 자동 생성, robots.txt 설정
3. performance-optimizer: Core Web Vitals 개선, 이미지 최적화
4. schema-markup-expert: JSON-LD 구조화 데이터 추가

각 팀원은 독립적으로 작업하되,
meta-tags-specialist가 완료되면 schema-markup-expert가 시작하도록 해줘."

# 단일 에이전트 사용 - 별도 설정 불필요
claude code

// 단일 에이전트 작업 흐름
1. API 엔드포인트 구현 (10분)
   ↓
2. 프론트엔드 폼 개발 (10분)
   ↓
3. 통합 테스트 작성 (10분)

총 소요 시간: 30분

// Agent Teams 작업 흐름
병렬 작업:
- 팀원 A: API 엔드포인트 구현 (10분)
- 팀원 B: 프론트엔드 폼 개발 (10분)
- 팀원 C: 테스트 코드 작성 (10분)

총 소요 시간: 10분 (3배 빠름!)

// 팀 리드 → 보안 검토 팀원에게 메시지
{
  operation: "write",
  target_agent_id: "security-reviewer",
  value: "인증 모듈 우선 검토 부탁드려요. 내일까지 배포 예정입니다."
}

// 보안 검토 팀원 → 팀 리드에게 응답
{
  operation: "write",
  target_agent_id: "team-lead",
  value: "JWT 토큰 만료 시간이 너무 길어요. 1시간으로 줄이는 것을 권장합니다."
}

// 팀 리드 → 백엔드 팀원에게 수정 지시
{
  operation: "write",
  target_agent_id: "backend-developer",
  value: "JWT 만료 시간을 1시간으로 수정해주세요. auth/config.ts 파일 확인 바랍니다."
}

// 팀 리드 → 전체 팀원에게 상태 확인 요청
{
  operation: "broadcast",
  name: "team-lead",
  value: "상태 확인: 각자 진행 상황을 공유해주세요."
}

// 시나리오: Next.js 대시보드 개발

// 팀 리드: 작업 분배
팀원 A (frontend-ui): "대시보드 레이아웃 및 차트 컴포넌트 개발"
팀원 B (api-integration): "데이터 페칭 및 TanStack Query 설정"
팀원 C (styling): "Tailwind 테마 및 반응형 디자인"
팀원 D (testing): "Playwright E2E 테스트 작성"

// 팀원 B → 팀원 A에게 메시지 (Peer-to-peer)
{
  operation: "write",
  target_agent_id: "frontend-ui",
  value: "API 엔드포인트 /api/dashboard/stats가 준비됐어요. 이 데이터 구조로 차트를 그려주세요: { revenue: number[], users: number[] }"
}

// 팀원 A → 팀원 B에게 확인
{
  operation: "write",
  target_agent_id: "api-integration",
  value: "데이터 구조 확인했어요. 날짜 범위 필터는 어떻게 구현되나요?"
}

// 팀원 C → 팀 리드에게 보고
{
  operation: "write",
  target_agent_id: "team-lead",
  value: "다크 모드 테마 완료했습니다. 모든 컴포넌트에 적용 가능해요."
}

// 팀 리드: API 명세 정의 (TypeScript 인터페이스)
interface ProfileUpdateRequest {
  name: string;
  email: string;
  avatar?: File;
}

// 팀원 A: 백엔드 API 엔드포인트
// - 입력 검증 (Zod 스키마)
// - 데이터베이스 마이그레이션
// - S3 이미지 업로드

// 팀원 B: 프론트엔드 ProfileEditor 컴포넌트
// - React Hook Form으로 폼 검증
// - 이미지 업로드 미리보기
// - Optimistic Updates (낙관적 UI 업데이트)

// 팀원 C: E2E 테스트
// - Playwright로 폼 제출 시나리오 테스트
// - 이미지 업로드 검증

# 팀 리드: 프로젝트 구조 설계 및 패키지 설치
npx create-next-app@latest

# 팀원 A: 레이아웃 및 공통 컴포넌트
# - RootLayout 설정
# - Header, Footer, Sidebar 컴포넌트
# - 폰트 설정 (next/font)

# 팀원 B: 라우팅 및 페이지
# - app/(home)/page.tsx
# - app/blog/page.tsx
# - app/docs/layout.tsx

# 팀원 C: 설정 파일
# - tailwind.config.ts
# - tsconfig.json
# - next.config.mjs

// 팀 리드: 전략 수립 및 tsconfig.json 설정
{
  "compilerOptions": {
    "strict": true,
    "jsx": "react-jsx"
  }
}

// 팀원 A: src/components/*.jsx → *.tsx
// - React 컴포넌트 타입 정의
// - Props 인터페이스 작성

// 팀원 B: src/utils/*.js → *.ts
// - 유틸리티 함수 타입 정의
// - 제네릭 활용

// 팀원 C: src/api/*.js → *.ts
// - API 응답 타입 정의 (Zod)
// - Axios 설정 타입 안전성 확보

// 팀원 D: 타입 에러 수정 및 린트
// - TypeScript 에러 전수 조사
// - ESLint 설정 (@typescript-eslint)

// 팀 리드: 디자인 토큰 정의 (Tailwind config)
theme: {
  extend: {
    colors: {
      primary: {...},
      secondary: {...}
    }
  }
}

// 팀원 A: 기본 컴포넌트 (Button, Input, Card)
// 팀원 B: 폼 컴포넌트 (Form, Select, Checkbox)
// 팀원 C: 레이아웃 컴포넌트 (Dialog, Drawer, Sheet)
// 팀원 D: Storybook 스토리 작성 및 문서화

// 팀 리드: 성능 측정 및 병목 구간 파악
// - Lighthouse 분석
// - Chrome DevTools Performance 프로파일링

// 팀원 A: 이미지 최적화
// - next/image로 전환
// - WebP 포맷 변환
// - Lazy Loading 적용

// 팀원 B: 번들 크기 최적화
// - Dynamic Import (코드 스플리팅)
// - Tree Shaking
// - webpack-bundle-analyzer 분석

// 팀원 C: 렌더링 최적화
// - React.memo 적용
// - useMemo, useCallback 최적화
// - 불필요한 리렌더링 제거

// 팀원 A: 서버 컴포넌트 분석
// - SSR HTML 출력 확인
// - Date, Random 값 사용 여부 점검

// 팀원 B: 클라이언트 컴포넌트 분석
// - useEffect 의존성 배열 검증
// - localStorage/sessionStorage 사용 확인

// 팀원 C: 브라우저 확장 프로그램 영향 조사
// - DevTools Console 로그 분석
// - 서드파티 스크립트 확인

claude code

# settings.json에 환경변수 추가
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

# 또는 터미널에서
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1
claude code