팀 에이전트 오케스트레이션은(는) 무엇을 하나요?
에이전트가 단일 어시스턴트가 아닌 팀 형태로 관리될 때 이 스킬을 사용합니다. 목표는 팀 기반 오케스트레이션을 안정적으로 만드는 것입니다: 명확한 작업 항목, 명시적 소유권, 에이전트 칸반 상태, 브랜치 격리, 제어판 가시성 및 병합 게이트.
활성화 시기
- 작업이 여러 에이전트, 도구, 하네스, 브랜치 또는 작업 트리에 걸쳐 있는 경우.
- 사용자가 팀 오케스트레이션, 에이전트 칸반, 스쿼드, 컨덕터, 제어판, 매니저, 데스크톱 앱, Zellij, tmux, Hermes, Devin, Codex, Claude Code, 또는 다중 에이전트 작업을 언급하는 경우.
- 프로젝트에 사람과 에이전트 간의 공유 워크플로우 상태가 필요한 경우.
- 기존 에이전트 팬아웃이 출력을 생성하고 있지만 병합 가능한 제품은 아닌 경우.
운영 모델
모든 에이전트를 좁은 계약(narrow contract)을 가진 팀원으로 취급합니다:
- 소유자(Owner): 작업 항목에 대해 책임이 있는 사람 또는 에이전트.
- 범위(Scope): 파일, 브랜치, 도구 표면 및 금지 영역.
- 상태(State): 백로그, 준비, 실행 중, 검토, 차단됨, 병합됨 또는 보관됨.
- 증거(Evidence): 테스트, 스크린샷, 로그, 검토 노트 또는 평가 보고서.
- 병합 게이트(Merge gate): 통합을 허용하는 정확한 조건.
에이전트 칸반
작업이 세션 간에 표시되어야 할 때 에이전트 칸반을 사용합니다.
| 칼럼 | 의미 | 종료 기준 |
|---|---|---|
| 백로그(Backlog) | 후보 작업 항목, 아직 구체화되지 않음 | 승인 기준 작성됨 |
| 준비(Ready) | 구체화되었고 할당 가능함 | 소유자 및 브랜치/작업 트리 할당됨 |
| 실행 중(Running) | 에이전트가 적극적으로 작업 중 | 핸드오프 아티팩트 및 변경된 파일 존재 |
| 검토(Review) | 작업이 완료되었지만 병합되지 않음 | 테스트, diff 검토 및 위험 검사 통과 |
| 차단됨(Blocked) | 외부 입력이 필요하거나 게이트 실패 | 차단 항목에 소유자 및 다음 조치가 있음 |
| 병합됨(Merged) | 메인라인에 통합됨 | PR 병합됨 또는 로컬 main 업데이트됨 |
| 보관됨(Archived) | 더 이상 관련 없음 | 사유 기록됨 |
각 카드는 다음 스키마를 따라야 합니다:
{
"id": "agent-card-001",
"title": "동적 워크플로우 스킬 구축",
"owner": "codex",
"state": "running",
"branch": "product/dynamic-workflow-team-orchestration",
"worktree": ".",
"acceptance": [
"스킬이 존재함",
"테스트가 필요한 개념을 포함함",
"콘텐츠 아티팩트에 비디오 및 기획 각도가 포함됨"
],
"merge_gate": "lint, 집중 테스트 및 카탈로그 검사 통과",
"handoff": "path/to/handoff.md"
}
팀 기반 오케스트레이션 흐름
- 보드 구체화: 모호한 야망을 소유자와 병합 게이트가 있는 작업 항목으로 변환합니다.
- 실행 모드 선택: 단일 에이전트, 동적 워크플로우 모드, dmux/tmux, 작업 트리 팬아웃 또는 외부 데스크톱 오케스트레이터.
- 경계 할당: 카드당 한 명의 소유자, 명확한 파일 범위, 통합자 없이 중복 쓰기 금지.
- 에이전트 실행: 각 에이전트는 코드뿐만 아니라 증거와 핸드오프 노트를 작성합니다.
- 순차적 검토: 테스트 먼저, 그 다음 diff 검토, 보안/위험 검사, 콘텐츠/제품 다듬기.
- 의도적 병합: 한 명의 통합자가 충돌을 해결하고 제어판 또는 상태 아티팩트를 업데이트합니다.
- 재사용 가능한 스킬 추출: 카드 패턴이 반복되면
skills/로 승격시킵니다.
제어판 요구 사항
팀 오케스트레이션을 위한 유용한 제어판은 다음을 표시해야 합니다:
- 활성 작업 항목 및 해당 에이전트 칸반 상태.
- 소유자, 하네스, 브랜치, 작업 트리 및 마지막 하트비트.
- 핸드오프 아티팩트, 테스트, 스크린샷 및 PR에 대한 링크.
- 소유자별로 그룹화된 차단 항목 및 차단 해제 조치.
- 분위기가 아닌 게이트별 병합 준비 상태.
- 공유 스킬이 되어야 하는 재사용 가능한 워크플로우 후보.
운영자가 다음 질문에 답할 수 있을 때까지 자동화를 추가하지 마십시오: 누가 이것을 소유하는가, 무엇이 변경되었는가, 어떤 게이트가 실패했는가, 무엇이 안전하게 병합될 수 있는가?
동적 워크플로우 호환성
카드에 동적 워크플로우 모드가 필요할 때:
- 태스크 로컬 하네스를 카드 소유자 아래에 둡니다.
- 입력과 출력을 카드에 저장합니다.
- 실행 중에서 검토로 이동하기 전에 평가(eval)를 요구합니다.
- 반복 사용 후에만 하네스를 공유 스킬로 승격시킵니다.
주의해야 할 실패 모드
- 에이전트 수프: 많은 에이전트가 실행 중이지만 소유자나 병합 게이트가 없음.
- 투명하지 않은 작업: 유용한 출력이 채팅 기록에만 존재함.
- 보드 쇼: 칸반 보드는 있지만 카드에 승인 기준이 없음.
- 중복 쓰기: 병렬 에이전트가 작업 트리 없이 동일한 파일을 편집함.
- 제품 아티팩트 없음: 프로세스가 문서는 생성하지만 실행 가능하거나 게시 가능한 표면은 생성하지 않음.
출력 표준
각 오케스트레이션 패스를 다음으로 마무리합니다:
- 보드/카드 변경 사항.
- 병합되었거나 대기 중인 브랜치.
- 테스트 및 평가 증거.
- 차단 항목과 소유자 및 다음 조치.
- 새로운 공유 스킬 후보.