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