# 🤖 InsuWiki 멀티에이전트 운영 가이드

> 9개 에이전트 관점에서 모든 작업을 검토하는 원칙

---

## 🚨 필수 검토 플로우 (Jay 부장 자동 실행)

> **대표님이 확인하지 않아도**, 모든 검토 대상 작업 시 아래 플로우를 자동으로 실행합니다.
> **문제가 없다고 판단될 때까지 반복 수정합니다.**

### 작업 지시 플로우
```
[작업 시작]
     ↓
[초안 작성]
     ↓
[관련 에이전트 관점에서 실질적 검토]  ← 형식적 ✅ 금지!
     ↓
├─ 문제 발견 시: 구체적 이슈 + 개선안 제시
│       ↓
│   [피드백 반영하여 수정]
│       ↓
│   [다시 검토] ← 문제 없을 때까지 반복!
│
├─ 문제 없을 시: "검토 완료" + 확인 항목 명시
     ↓
[최종 결과물 제출]
```

---

## 검토 대상 작업 (PM 피드백 반영)

> 아래 유형의 작업은 **반드시** 검토 필수

| 유형 | 예시 | 필수 검토 에이전트 |
|------|------|-------------------|
| **설계 결정** | 스키마, 아키텍처 | Data, Backend, QA |
| **API 설계** | 엔드포인트, 스펙 | Backend, Frontend, QA |
| **UI/화면 설계** | 와이어프레임, 컴포넌트 | Frontend, UX, Reflect |
| **기능 설계** | PRD, 요구사항 | Planner, PM, Reflect |
| **코드 작성** | 핵심 로직 | QA, 담당 에이전트 |
| **문서 작성** | 가이드, 정책 | Planner, Legal, UX |

---

## 에이전트 목록

| # | Agent | 역할 | 핵심 질문 |
|---|-------|------|----------|
| 1 | **PM** | 프로젝트 관리 | "일정에 맞는가? 우선순위는?" |
| 2 | **Backend** | API/DB/인증 | "API 설계가 적절한가?" |
| 3 | **Frontend** | UI/UX 구현 | "컴포넌트 재사용 가능한가?" |
| 4 | **Data** | DB 스키마/쿼리 | "데이터 구조가 효율적인가?" |
| 5 | **QA** | 테스트/보안/리뷰 | "테스트 가능한가? 보안은?" |
| 6 | **UX** | 사용자 경험 | "사용자가 이해하기 쉬운가?" |
| 7 | **Legal** | 법적 요구사항 | "법적 문제는 없는가?" |
| 8 | **Planner** | 기능 설계/PRD | "요구사항이 명확한가?" |
| 9 | **Reflect** | Reflect/Obsidian 기능 | "Zero-friction 원칙 준수?" |

---

## 검토 결과 작성 형식 (QA 피드백 반영)

### 문제 발견 시
```markdown
### {Agent} Agent
❓ 문제: {구체적 문제 설명}
→ {문제가 발생하는 상황/영향}

💡 개선: {구체적인 해결 방안}
```

### 문제 없을 시
```markdown
### {Agent} Agent
✅ 검토 완료, 이슈 없음
- 확인 항목: {실제로 확인한 내용 나열}
```

> **중요**: "이슈 없음"만 쓰면 안 됨. **확인한 항목을 반드시 명시**

---

## 검토 완료 조건

> 아래 조건을 **모두** 만족해야 검토 완료

1. ✅ 관련 에이전트 **전원** 검토 완료
2. ✅ 모든 문제점에 대해 **개선안 반영됨**
3. ✅ 각 검토에 **확인 항목 명시됨**
4. ✅ 재검토 시 **새로운 이슈 없음**

---

## 에이전트 파일 위치

```
📁 .claude/agents/
├── pm.agent.md
├── backend.agent.md
├── frontend.agent.md
├── data.agent.md
├── qa.agent.md
├── ux.agent.md
├── legal.agent.md
├── planner.agent.md
└── reflect.agent.md
```

---

**마지막 업데이트**: 2026-02-08