Agent Teams: 여러 Claude가 팀으로 일한다

[기존 5파일+ BUILD]
SPEC v4 → PLAN v2.1 → REVIEW READY → BUILD Day 1 (혼자) → Day 2 (혼자) → ...
                                          ↓
[Agent Teams BUILD]
SPEC v4 → PLAN v2.1 → REVIEW READY → BUILD Day 1
                                       ├─ 에이전트 A: src/components/
                                       ├─ 에이전트 B: src/api/
                                       └─ 에이전트 C: tests/
                                          ↓ 통합
                                       BUILD.md Day 1 갱신 (3 트레이스)

## 6. File Structure
src/
  app/         라우팅
  components/  UI 컴포넌트  ← 에이전트 A 담당
  lib/         유틸 + SSOT 인터페이스
  api/         외부 호출    ← 에이전트 B 담당
tests/
  unit/        단위 테스트
  e2e/         E2E 테스트   ← 에이전트 C 담당

/delegate 아래 두 작업을 동시에 진행해줘:

  에이전트 A (담당 폴더: src/components/):
    - 줍줍 카드 컴포넌트 리팩토링 (200줄 이하)
    - 신뢰지수 표시 UI 개선

  에이전트 B (담당 폴더: src/api/):
    - 공공데이터 API 호출 최적화 (병렬 fetch)
    - LLM 분류 confidence 0.7 임계값 fallback 추가

두 에이전트가 완료하면 결과를 통합해서 보고해줘.
충돌이 생기면 즉시 멈추고 알려줘.

src/app/(tabs)/business/    소상공인 탭
src/app/(tabs)/individual/  개인 복지 탭

/delegate Phase 1 두 탭 UI를 동시에 개발해줘:

  에이전트 A (담당 폴더: src/app/(tabs)/business/):
    - 소상공인 탭 메인 페이지 (목록·카테고리 필터)
    - 사업단계 필터 (창업준비·1년미만·3년미만·3년이상·폐업재기)
    - "사장님 톤" 닉네임 페르소나 풀 적용 (E5)

  에이전트 B (담당 폴더: src/app/(tabs)/individual/):
    - 개인 복지 탭 메인 페이지 (목록·생애주기 필터)
    - 가구 형태 필터 (1인가구·부부·한부모·다자녀·노인·장애인)
    - "시민 톤" 닉네임 페르소나 풀 적용 (E5)

CLAUDE.md §5 Two-Tab Content SSOT 7 규칙 준수 필수:
- 사실 단일 출처 (benefits 테이블)
- 톤 분리 (사장님 / 시민)
- 닉네임 페르소나 풀 분리

두 에이전트 완료 후 자동 일관성 테스트:
"같은 benefit_id에 대해 두 탭 노출 시 사실 일치"

src/personas/stat/        STAT 페르소나 (통계학자)
src/personas/observer/    OBSERVER 페르소나 (균형 관찰자)
src/personas/_shared/     공통 (system prompt 베이스, cache_control)
lib/match_facts.ts        SSOT 인터페이스 (단일 출처)

/delegate Phase 1.0 두 페르소나를 동시에 개발해줘:

  에이전트 A (담당 폴더: src/personas/stat/):
    - STAT system prompt 작성 (통계학자 톤)
    - 정량·기술적 표현 강조 (xG·점유율·슈팅 수치)
    - cache_control 적용 (lib/_shared/cache.ts 참조)
    - SEO 키워드: "통계 분석", "xG 분석"

  에이전트 B (담당 폴더: src/personas/observer/):
    - OBSERVER system prompt 작성 (신중한 관찰자 톤)
    - 균형 어법 강조 ("한편으로는 ..., 다만 ...")
    - cache_control 적용
    - SEO 키워드: "경기 미리보기", "다관점 분석"

공통 파일 (lib/match_facts.ts, lib/_shared/)은 두 에이전트 모두
읽기 전용. 수정 금지.

CLAUDE.md §5 Persona System Rules 8개 규칙 준수 필수:
[1] 활성 페르소나 2종만
[2] SSOT 의무 (MatchFacts 인터페이스)
[3] 사실 자체 변경 금지
[4] 자동 일관성 테스트 통과 의무
[5] prompt caching 적용 의무
[6] SEO 키워드 분리 (cannibalization 방지)
[7] 익명성 유지
[8] Position C 일관 노출

두 에이전트 완료 후 일관성 테스트:
tests/persona_consistency.test.ts 5개 케이스 모두 통과해야 함.
fail 시 cron/publish.ts 자동 정지.

[두 에이전트 완료 후, Claude Code]
두 에이전트 작업 완료. 통합 단계 시작:

1. 자동 일관성 테스트 실행 (tests/persona_consistency.test.ts)
   - 모두 통과 → 다음 단계
   - fail → 어느 에이전트의 어느 결정이 원인인지 분석

2. CLAUDE.md §5 8개 규칙 검증
   - 모두 준수 → PASS
   - 위반 → 해당 에이전트 결과 롤백

3. BUILD.md Day 8 갱신:
   - 두 에이전트 LogOnTable 트레이스 (각 1~3줄)
   - 통합 결과 1줄

4. git commit
   - 메시지: "Day 8: STAT + OBSERVER 페르소나 (Agent Teams)"

# Claude가 "에이전트 A에서 충돌 발생" 보고 시
에이전트 A 작업만 취소해줘. 에이전트 B는 완료 상태로 유지.
에이전트 A는 내가 직접 순차 진행.

# 전체 실패 시
git stash
/clear
/model claude-sonnet-4-6
"두 작업을 순차 실행으로 전환. 새 11장 CLAUDE.md 5파일 모두
읽고 현재 상황 파악 후 진행."