# Agency-Agents Repo Analysis
> 분석일: 2026-03-12 | 소스: `/tmp/agency-agents/` | 분석자: 아누

## 개요
"The Agency"는 50+ AI 에이전트를 NEXUS(Network of EXperts, Unified in Strategy) 파이프라인으로
조율하는 멀티에이전트 오케스트레이션 프레임워크. 7-Phase 파이프라인 + 구조화된 핸드오프 + 품질 게이트.

---

## 1. TOP 10 흡수할 패턴 (가치순)

### #1. Dev-QA 루프 (3회 재시도 + 에스컬레이션)
- 개발자 구현 -> QA 검증 -> PASS/FAIL -> 최대 3회 재시도 -> 에스컬레이션
- **우리와의 차이**: 우리는 Sonnet 3회 실패 시 Opus 직접 개입 규칙만 있음. 이들은
  재시도-에스컬레이션-재배정/분해/보류 결정 트리가 체계적
- **흡수 가치**: task별 attempt 카운터 + 3회 실패 시 자동 보고 프로토콜 도입

### #2. Reality Checker — "기본값은 NEEDS WORK"
- 최종 통합 테스터가 "기본값 = 불합격"으로 작동. A+ 환상 방지
- 증거(스크린샷) 기반만 인정, 주장은 불인정
- **흡수 가치**: 마아트(QC)에 "기본값 NEEDS WORK" 마인드셋 + Fantasy Approval 자동 탐지 룰 추가

### #3. 구조화된 핸드오프 템플릿 (7종)
- Standard / QA-PASS / QA-FAIL / Escalation / Phase Gate / Sprint / Incident
- 메타데이터(From/To/Phase/TaskRef/Priority/Timestamp) + Context + Deliverable + Quality
- **흡수 가치**: dispatch.py 위임 시 task-file에 표준 핸드오프 메타데이터 섹션 추가

### #4. Phase Gate 시스템 (게이트키퍼 + 체크리스트 + GO/NO-GO)
- 매 Phase 경계에 명시적 Gate Keeper, 통과 기준표, 증거 요구
- Gate 실패 시 이전 Phase로 회귀하는 명확한 프로세스
- **우리와의 비교**: 우리의 Phase 분리 원칙과 유사하나, Gate Keeper 지정/체크리스트가 없음
- **흡수 가치**: 위임 시 Phase 완료 기준 체크리스트를 task-file에 명시

### #5. 4-Track 병렬 빌드 (Core/Growth/Quality/Brand)
- Phase 3에서 개발/마케팅/QA/브랜드 4개 트랙 동시 진행
- **흡수 가치**: 1팀+2팀 병렬 위임 시 트랙 명시 (개발/마케팅/QA 병렬 가능성)

### #6. Evidence Collector — 스크린샷 강박증 QA
- "Screenshots Don't Lie" — 모든 주장에 시각적 증거 요구
- Desktop(1920x1080) + Tablet(768x1024) + Mobile(375x667) 3종 필수
- 기본값: "최소 3-5개 이슈 발견" (Zero Issue = Red Flag)
- **흡수 가치**: 아르고스/헤임달(테스터)에 "Zero Issue = Red Flag" 원칙 + 증거 필수 규칙

### #7. Executive Summary — SCQA 프레임워크 (McKinsey)
- Situation-Complication-Question-Answer + 325-475 단어 제한
- 모든 발견에 정량적 데이터 포인트 1개 이상 필수
- **흡수 가치**: 보고서 작성 시 SCQA 포맷 도입 (제이회장님 보고용)

### #8. MCP Memory 기반 핸드오프 (workflow-with-memory.md)
- 에이전트가 deliverable을 memory에 저장, 다음 에이전트가 recall
- 프로젝트 태그 + 수신 에이전트 태그로 자동 검색
- QA 실패 시 rollback → 이전 체크포인트 복원
- **흡수 가치**: 장기적으로 MCP memory 도입 시 참고. 현재 우리의 파일 기반 핸드오프도 유효

### #9. Behavioral Nudge Engine — UX 심리학
- 인지 부하 감소: 50개 할 일 → 가장 중요한 1개만 표시
- 기본값 편향 활용: "답장 초안 작성됨. 보내시겠습니까?"
- 마이크로 스프린트: "5분 안에 몇 개 처리할까요?"
- **흡수 가치**: 보험 자동화 UX (고객 레포트, 인터뷰 도구)에 적용 가능

### #10. Incident Response 프로토콜 (P0-P3 + 대응 시퀀스)
- 탐지 → 분류 → 대응팀 배정 → 해결 → 포스트모템
- P0: 즉시(전원), P1: 1시간, P2: 4시간, P3: 다음 스프린트
- **흡수 가치**: 운영 중 장애 대응 프로토콜로 채택 (InsuWiki 등)

---

## 2. 기존 에이전트별 개선안

### 마케팅 팀 (아폴론/페이토)

| 항목 | Agency 패턴 | 우리 적용 |
|------|------------|----------|
| 플랫폼별 전문화 | Instagram Curator, TikTok Strategist 등 각 플랫폼별 독립 페르소나 | 페이토에 플랫폼별 모드 추가 (Threads/Insta/Blog/Tistory) |
| 콘텐츠 1/3 법칙 | 브랜드 33% + 교육 33% + 커뮤니티 33% | 서울대보험쌤 콘텐츠 비율 가이드로 채택 |
| SEO 전문성 | 키워드 클러스터 + Topic Pillar + E-E-A-T | 네이버SEO/구글SEO 전략에 Topic Cluster 아키텍처 도입 |
| Growth Hacker | 바이럴 계수(K-factor), CAC:LTV, 실험 속도(10+/월) | SNS 성장 KPI로 도입 |
| 런칭 시퀀스 | T-7 → T-0 → T+7 → T+14 체계적 타임라인 | 프로젝트 런칭 시 적용 |

### 테스팅 (아르고스/헤임달)

| 항목 | Agency 패턴 | 우리 적용 |
|------|------------|----------|
| Fantasy Approval 방지 | "Zero issues = Red Flag", A+ 금지 | 테스터 프롬프트에 명시 |
| 증거 필수 | Playwright 스크린샷 3종 (Desktop/Tablet/Mobile) | browser.py 활용 자동 캡처 |
| 기본값 FAIL | "기본값 = NEEDS WORK, 증거로 뒤집어야 PASS" | QC-RULES에 추가 |
| 이슈 최소 3개 | 첫 구현에서 이슈 0개는 비현실적 | 테스터 가이드에 명시 |

### 디자인 (비너스)

| 항목 | Agency 패턴 | 우리 적용 |
|------|------------|----------|
| Brand Guardian | 목적/비전/미션/가치/성격 + CSS 변수 시스템 | 서울대보험쌤/연금쌤 브랜드 가이드 작성 시 참고 |
| 브랜드 일관성 감사 | 95%+ 일관성, 주기적 감사 | 비너스가 월 1회 브랜드 일관성 체크 |
| Voice Guidelines | Do/Don't 예시 + 톤 변형 (Professional/Conversational/Supportive) | SNS 톤앤매너 가이드 |

### QC (마아트)

| 항목 | Agency 패턴 | 우리 적용 |
|------|------------|----------|
| Workflow Optimizer | Lean/Six Sigma + 자동화 기회 식별 + ROI 계량 | 분기별 프로세스 개선 리뷰 |
| Test Results Analyzer | 모든 QA 결과 종합 대시보드 | task-timer 데이터 기반 품질 대시보드 |

---

## 3. 우리 시스템에 부족한 전략/조율 패턴

### 3-1. 에이전트 활성화 프롬프트 표준화
- Agency: 역할별 ready-to-use 활성화 프롬프트 (Phase/Task/참조문서/기대산출물 명시)
- **우리**: dispatch.py의 team_prompts.py가 이 역할을 하지만, task-file 안에
  "Phase/참조문서/산출물/품질기준" 구조가 표준화되어 있지 않음
- **개선**: task-file 템플릿에 메타데이터 섹션 추가

### 3-2. Cross-Division Dependency Matrix
- Agency: 9개 Division 간 의존성 매트릭스 (Producer→Consumer)
- **우리**: bot-team-mapping.md에 팀 구조는 있으나 팀 간 의존성 매핑이 없음
- **개선**: organization-structure.json에 dependency_map 추가

### 3-3. 운영 케이던스 (Continuous/Daily/Weekly/Monthly/Quarterly)
- Agency: Phase 6에서 에이전트별 주기와 SLA 명시
- **우리**: task-timer로 기록하지만 정기 리뷰 주기가 없음
- **개선**: InsuWiki 등 운영 프로젝트에 정기 리뷰 케이던스 도입

### 3-4. 재정 추적 에이전트 (Finance Tracker)
- Agency: 월별 MRR/ARR, CAC, LTV, ROI 추적
- **우리**: Finance센터가 "계획 중" 상태
- **개선**: 토큰 비용 + 인프라 비용 추적 체계 구축 우선

### 3-5. 실험 추적 에이전트 (Experiment Tracker)
- Agency: A/B 테스트 관리, 통계적 유의성 검증, 승자 구현
- **우리**: 없음
- **개선**: SNS 성장 실험 시 실험 로그 체계 (memory/experiments/) 도입

---

## 4. 피해야 할 안티패턴

### 4-1. 에이전트 수 폭발
- Agency는 50+ 에이전트. 플랫폼별 SNS 에이전트만 10개+
- **교훈**: 에이전트 수가 많으면 조율 비용이 기하급수적 증가
- **우리 원칙**: 조직 구조 유지, 논리적 팀 유동 배정 (bot-team-mapping.md)

### 4-2. 프롬프트 내 코드 예시 과다
- Workflow Optimizer 등에 200줄+ Python 코드가 프롬프트에 포함
- **교훈**: 프롬프트 비대화 → 토큰 낭비. 코드는 별도 파일 참조
- **우리 원칙**: CLAUDE.md 200줄 이하, 상세는 별도 파일

### 4-3. 범용 프레임워크 vs 도메인 특화
- Agency는 "어떤 프로젝트든 적용 가능한" 범용 프레임워크
- **교훈**: 범용성 추구 시 각 Phase가 과도하게 무거워짐
  (Phase 0 Discovery만 6명 에이전트, 7일 소요)
- **우리 원칙**: 작업 레벨 시스템으로 경량/중량 구분. Lv.0-1은 즉시 실행

### 4-4. 환상적 성공 지표
- "25% 참여율", "50% 트래픽 증가", "K-factor > 1.0" 등 비현실적 목표
- **교훈**: 지표는 현실적으로. 달성 불가능한 목표는 동기 저하
- **우리 원칙**: 정직한 계산 (dev-environment-spec v4.0: 8.7/10 사례)

### 4-5. 페르소나 과잉 장식
- 이모지, "Your Communication Style", "Learning & Memory" 등 반복적 섹션
- **교훈**: 에이전트 정의는 "무엇을 하는가"가 핵심. 성격 묘사는 최소화
- **우리 원칙**: 간결한 역할 정의 + 구체적 산출물 명세

---

## 5. 즉시 적용 가능한 액션 아이템

| 우선순위 | 항목 | 적용 대상 |
|---------|------|----------|
| High | QA "기본값 NEEDS WORK" + Zero Issue Red Flag | QC-RULES.md |
| High | 핸드오프 메타데이터 표준화 (task-file 템플릿) | dispatch.py / task-file |
| High | 3회 재시도-에스컬레이션 프로토콜 | team_prompts.py |
| Medium | SCQA 보고서 포맷 | 제이회장님 보고용 |
| Medium | 마케팅 콘텐츠 1/3 법칙 + Topic Cluster | SNS 전략 |
| Medium | Phase Gate 체크리스트 | task-file 내 포함 |
| Low | 실험 로그 체계 (memory/experiments/) | 향후 |
| Low | 운영 케이던스 정의 | InsuWiki 운영 시 |
| Low | Cross-Division 의존성 매트릭스 | organization-structure |

---

## 참조 파일 목록
- 전략: `strategy/nexus-strategy.md` (핵심 — 7-Phase 파이프라인 전체)
- 조율: `strategy/coordination/handoff-templates.md` (7종 핸드오프 템플릿)
- 활성화: `strategy/coordination/agent-activation-prompts.md` (역할별 프롬프트)
- 플레이북: `strategy/playbooks/phase-0~6-*.md` (Phase별 상세 플레이북)
- QA: `testing/testing-reality-checker.md`, `testing-evidence-collector.md`
- 프로세스: `testing/testing-workflow-optimizer.md`
- 제품: `product/product-behavioral-nudge-engine.md`, `product-feedback-synthesizer.md`
- 디자인: `design/design-brand-guardian.md`
- 지원: `support/support-executive-summary-generator.md`
- 메모리: `examples/workflow-with-memory.md` (MCP memory 핸드오프 패턴)