# Claude Code 에이전트 팀 v4.0 (맞춤형 - 32 에이전트)

사용자의 업무 전 영역을 지원하는 **유기적 32 에이전트 팀**입니다.

## 📊 v4.0 변경 사항

### 신규 추가 8개 (★)
- legal-advisor (법무)
- hr-manager (인사)
- pr-officer (홍보)
- policy-driver (정책 추진)
- auditor (감사 종합)
- researcher (정책 연구)
- admin-officer (행정 실무)
- school-supervisor (학교 지도)

### 개선 적용 2개 (◎)
- korean-doc-writer: 보고서 작성 기능 대폭 강화 (정책/사업/일일/주간/월간/상황/결재용 보고)
- team-coordinator: 32 에이전트 흐름도 반영, 6대 갈등 중재 프로토콜

### 중복 분석 결과 (불채택 1개)
- '보고' → korean-doc-writer 확장으로 흡수 (별도 에이전트 불필요)

## 🏛 팀 구조 (32 에이전트)

```
┌──────────────────────────────────────────────┐
│ [지휘부]                                      │
│   orchestrator      작업 분배·통합           │
│   team-coordinator  보조자·중재·동행 (32팀 갱신)│
└──────────────────────────────────────────────┘

[사업 사이클] 6
  business-ideator → planner → budget-planner
    → expenditure-manager → settlement-manager
    → business-evaluator → (환류)

[기획·검토] planner / reviewer
[문서·기획] korean-doc-writer◎ / scheduler / design-master
[문서 품질] grammar-checker / format-reviewer
[분석·리서치] data-analyst / statistician / researcher★ / github-explorer / blog-explorer
[개발·품질] module-checker / debugger / security-auditor / backup-manager
[개선·제안] feature-improver / idea-proposer

[전문 자문 라인] ★신규 7
  legal-advisor      법무
  hr-manager         인사
  pr-officer         홍보
  policy-driver      정책 추진
  auditor            감사 종합
  admin-officer      행정 실무
  school-supervisor  학교 지도
```

## 🎯 6대 표준 협업 패턴

### 패턴 A: 사업 전체 사이클 (가장 복잡)
business-ideator → researcher → planner → reviewer → legal-advisor
  → budget-planner → korean-doc-writer → policy-driver
  → expenditure-manager → school-supervisor → pr-officer
  → settlement-manager → auditor → business-evaluator → 환류

### 패턴 B: 학교 방문·장학 지도
school-supervisor → data-analyst → scheduler → admin-officer
  → [방문] → korean-doc-writer → 품질팀 → 보고

### 패턴 C: 일상 공문·민원
admin-officer (접수) → 분류 → korean-doc-writer
  → grammar+format-checker → admin-officer (발송)

### 패턴 D: 위기·긴급 상황
team-coordinator (즉시 조율) → legal-advisor + pr-officer
  + policy-driver + korean-doc-writer → admin-officer (실행)

### 패턴 E: 감사 대비
auditor (주관) + security-auditor + settlement-manager
  + reviewer + legal-advisor → korean-doc-writer → backup-manager

### 패턴 F: 정책 연구
researcher → data-analyst + statistician → blog-explorer
  → reviewer → korean-doc-writer → design-master → policy-driver

## 🔄 6대 갈등 중재 프로토콜 (team-coordinator)

| 충돌 쌍 | 갈등 유형 | 중재 방법 |
|---------|----------|----------|
| planner ↔ reviewer | 의욕 vs 신중 | 데이터 기반 객관화 |
| policy-driver ↔ legal-advisor | 추진 vs 법무 | 리스크 매트릭스 |
| budget-planner ↔ planner | 예산 vs 의욕 | 우선순위 조정 |
| auditor ↔ expenditure-manager | 절차 vs 속도 | 절차 우선 |
| pr-officer ↔ legal-advisor | 홍보 vs 표현 | 사실+안전 표현 |
| school-supervisor ↔ 학교 | 지도 vs 자율 | 협력 컨설팅 |

## 🚀 즉시 적용

### Windows PowerShell
```powershell
.\install-agents.ps1
```

### Mac/Linux/WSL
```bash
chmod +x install-agents.sh && ./install-agents.sh
```

### 수동
```bash
mkdir -p ~/.claude/agents && cp *.md ~/.claude/agents/
```

## 💡 사용 예시

### 사업 사이클
```
> business-ideator로 2027 협약형 특성화고 컨셉 5개
> planner로 위 컨셉 #2 세부 계획
> legal-advisor로 협약서 검토
> budget-planner로 예산서 작성
> auditor로 사전 점검 체크리스트
```

### 학교 방문
```
> school-supervisor로 ○○고 장학지도 준비
> data-analyst로 학교 성과 지표 정리
> korean-doc-writer로 방문 결과 보고서
```

### 위기 대응
```
> team-coordinator: 학교 안전사고 발생, 긴급 대응
→ legal-advisor + pr-officer + policy-driver 자동 동시 호출
```

### 정책 연구
```
> researcher로 독일·호주 직업교육 비교 체계적 문헌고찰
> statistician으로 ○○ 직업교육 성과 ANOVA 분석
> korean-doc-writer로 정책 보고서 작성
```

### 통합 의뢰
```
> team-coordinator로 협약형 특성화고 2026 사업 전체 사이클 진행
→ 12개 이상 에이전트가 패턴 A로 자동 협업
```

## 📋 맞춤 원칙 (전체 공통)

1. 응답: 가능/불가/먼저 판단 → 개조식 → 요약
2. 불가능 시: 반드시 해결 방법 제시
3. 코드: 모듈형 설계, 해당 모듈만 수정
4. 언어: 한국어 우선, 공문은 격식체
5. 검증: 추측 금지, 근거 기반

## 🔐 도구 권한 매트릭스 (32 에이전트)

| 에이전트 | Read | Write | Edit | Bash | Web | 모델 |
|----------|:----:|:-----:|:----:|:----:|:---:|:----:|
| orchestrator | ✅ | - | - | - | - | opus |
| team-coordinator◎ | ✅ | ✅ | ✅ | - | - | opus |
| business-ideator | ✅ | ✅ | - | - | ✅ | opus |
| planner | ✅ | ✅ | ✅ | - | ✅ | opus |
| budget-planner | ✅ | ✅ | ✅ | ✅ | ✅ | opus |
| expenditure-manager | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| settlement-manager | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| business-evaluator | ✅ | ✅ | ✅ | - | ✅ | opus |
| reviewer | ✅ | - | - | - | ✅ | opus |
| korean-doc-writer◎ | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| scheduler | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| design-master | ✅ | ✅ | ✅ | ✅ | ✅ | sonnet |
| grammar-checker | ✅ | - | ✅ | - | ✅ | sonnet |
| format-reviewer | ✅ | - | ✅ | - | ✅ | sonnet |
| data-analyst | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| statistician | ✅ | ✅ | ✅ | ✅ | ✅ | opus |
| **researcher** ★ | ✅ | ✅ | ✅ | - | ✅ | opus |
| github-explorer | ✅ | - | - | ✅ | ✅ | sonnet |
| blog-explorer | ✅ | ✅ | - | - | ✅ | sonnet |
| module-checker | ✅ | - | ✅ | ✅ | - | sonnet |
| debugger | ✅ | - | ✅ | ✅ | - | sonnet |
| security-auditor | ✅ | - | - | ✅ | - | sonnet |
| backup-manager | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| feature-improver | ✅ | - | ✅ | ✅ | - | sonnet |
| idea-proposer | ✅ | - | - | - | ✅ | opus |
| **legal-advisor** ★ | ✅ | ✅ | ✅ | - | ✅ | opus |
| **hr-manager** ★ | ✅ | ✅ | ✅ | - | ✅ | sonnet |
| **pr-officer** ★ | ✅ | ✅ | ✅ | - | ✅ | opus |
| **policy-driver** ★ | ✅ | ✅ | ✅ | - | ✅ | opus |
| **auditor** ★ | ✅ | ✅ | ✅ | ✅ | ✅ | opus |
| **admin-officer** ★ | ✅ | ✅ | ✅ | ✅ | - | sonnet |
| **school-supervisor** ★ | ✅ | ✅ | ✅ | - | ✅ | opus |

★ = v4.0 신규 / ◎ = v4.0 개선

## 📁 파일 목록 (33개)

| # | 파일명 | 라인 |
|---|--------|------|
| 1 | README.md (이 문서) | - |
| 2 | orchestrator.md | |
| 3 | team-coordinator.md ◎ | |
| 4 | business-ideator.md | |
| 5 | planner.md | |
| 6 | budget-planner.md | |
| 7 | expenditure-manager.md | |
| 8 | settlement-manager.md | |
| 9 | business-evaluator.md | |
| 10 | reviewer.md | |
| 11 | korean-doc-writer.md ◎ | |
| 12 | scheduler.md | |
| 13 | design-master.md | |
| 14 | grammar-checker.md | |
| 15 | format-reviewer.md | |
| 16 | data-analyst.md | |
| 17 | statistician.md | |
| 18 | researcher.md ★ | |
| 19 | github-explorer.md | |
| 20 | blog-explorer.md | |
| 21 | module-checker.md | |
| 22 | debugger.md | |
| 23 | security-auditor.md | |
| 24 | backup-manager.md | |
| 25 | feature-improver.md | |
| 26 | idea-proposer.md | |
| 27 | legal-advisor.md ★ | |
| 28 | hr-manager.md ★ | |
| 29 | pr-officer.md ★ | |
| 30 | policy-driver.md ★ | |
| 31 | auditor.md ★ | |
| 32 | admin-officer.md ★ | |
| 33 | school-supervisor.md ★ | |

## 🔧 유지보수

- **추가**: 동일 양식으로 `<name>.md` 생성
- **수정**: 파일 편집 후 세션 재시작 또는 `/agents`로 즉시 적용
- **프로젝트 오버라이드**: `.claude/agents/`가 `~/.claude/agents/`보다 우선
- **비활성화**: 파일명 앞에 `_` 추가

## 📞 지원
```
> team-coordinator: 32개 팀 전체 상태 점검
> team-coordinator: 사업 사이클 어디까지 진행됐는지 정리
> team-coordinator: 충돌이 발생한 작업 중재
```