Agent team

Agent Team

강한 모델은 판단과 통합을 맡고, 저렴한 모델은 독립 실행을 맡긴다. 현재 요청과 호출 인자를 팀의 목표로 사용한다.

런타임 라우팅

1. 위임 전에 현재 coordinator 런타임을 확인한다.
2. Claude Code에서는 Claude Code 지침만 읽는다.
3. Codex에서는 Codex 지침만 읽는다.
4. 다른 런타임의 reference는 읽지 않는다. 모델명과 팀 도구가 섞이면 잘못된 실행 표면을 선택한다.
5. 예외: 사용자가 Zellij를 요청하거나 현재 런타임에 없는 worker 모델명·harness를 지정하면 cross-harness 위임이다 — 모르는 모델명을 "없는 모델"로 단정하기 전에 다른 harness reference의 모델 절에서 확인하고, 해당 reference와 Zellij 지침을 읽는다.

공통 계약

• 서로 독립적으로 진행할 작업이 2개 이상일 때만 팀을 만든다.
• 순차 의존, 같은 파일 편집, 작은 수정, 페르소나 부여, 테스트 러너 실행은 lead가 직접 처리한다. 코드리뷰는 위임이 낫다.
• 팀을 쓰지 않으면 이유를 한 줄로 알리고 작업을 계속한다.
• lead가 요구사항 해석, 작업 분해, 결과 통합, 테스트, 최종 diff 검증을 직접 수행한다.
• worker에게 하위 worker 생성을 허용하지 않는다.
• 모든 위임 프롬프트에 다음 템플릿을 그대로 포함한다.

목표:
범위:
출력 형식:
결과 예산:
완료 조건:
담당 파일:
Obstacles:

• worker는 원문 로그 대신 결론, 변경 파일, 검증 결과, Obstacles를 반환한다.
• lead는 worker 결과를 다른 worker에게 전달할 때 원문 대신 필요한 사실과 쟁점만 요약한다.

규모·안정성

• 동시 fan-out은 현재 런타임 cap 이내로 제한한다. 일반 작업은 2~4개, 광범위 read-only 탐색만 최대 6개로 나누며, 초과 fan-out은 rate limit과 529 cascade를 키운다.
• 529가 연속 3회면 재시도하지 말고 대기하거나 lead가 직접 수행한다. 에이전트 정의(~/.claude/agents/<name>.md)를 읽으면 같은 절차를 그대로 밟을 수 있다.
• 에이전트 수는 복잡도에 비례시킨다. 단순 작업 1개, 비교 2~4개, 광범위 탐색에만 다수.
• 권한 프롬프트가 뜰 수 있는 Bash는 한 병렬 블록에 묶지 않는다. 하나가 거부되면 블록 전체가 cascade-cancel된다.
• worker의 카운팅·집계 결과는 lead가 rg로 교차 검증한다. 집계 명령은 절대 경로로 쓴다 — worker의 cwd는 리셋될 수 있다.
• Workflow가 사용량 한도로 일부 실패하면 한도 리셋 후 같은 scriptPath와 resumeFromRunId로 재개한다. 완료분은 캐시에서 복원된다.