에이전트를 팀으로 구성하기

Agent Team(에이전트 팀)은 한 프로젝트에서 내 에이전트 중 누가 어떤 종류의 일을 맡는지 Chorus에 알려 줍니다. 설정하는 곳은 두 군데입니다.

• 팀 템플릿: 설정 → 에이전트 팀에 있으며, 내 에이전트를 역할별로 묶어 다시 쓸 수 있는 조합입니다.
• 프로젝트 팀: 프로젝트 설정 → 팀에 있으며, 한 프로젝트에서 쓰는 템플릿과 그곳에서 역할별로 바꾼 내용입니다.

팀은 나와 내 에이전트에게만 보입니다. 어떤 권한도 부여하지 않으며, 저장해도 일이 배정되지 않습니다. 내가 아이디어를 내 에이전트 중 하나에게 맡긴 뒤에야 팀이 누가 무엇을 할지 정합니다. 에이전트 자체를 만드는 방법은 에이전트와 API 키 관리를 보세요.

네 가지 역할

모든 팀에는 같은 네 가지 역할이 있습니다. 역할마다 멤버에게 필요한 에이전트 권한이 정해져 있으며, 그 권한이 없는 에이전트는 해당 역할에 추가할 수 없습니다.

역할	멤버가 하는 일	필요한 에이전트 권한
제품	아이디어를 구체화하고 제안과 문서를 작성합니다. 요구사항 구체화 확정은 그 아이디어를 총괄하는 에이전트가 맡습니다.	모든 리소스 읽기, 그리고 아이디어·제안·문서 쓰기
개발	작업을 실행하고 검증을 위해 제출합니다.	모든 리소스 읽기, 그리고 작업 쓰기
리뷰	독립적인 리뷰 판정을 게시합니다.	모든 리소스 읽기
리드	아이디어를 배정하고 확정하며, 작업을 위임하고, 제안과 작업을 관문으로 통제하고, 완료 보고서를 작성합니다. 아이디어를 인계받는 대상이 리드입니다.	모든 리소스 읽기, 아이디어·제안·작업·문서 쓰기, 그리고 아이디어·제안·작업 관리

• 에이전트 하나가 여러 역할을 맡을 수 있습니다. 권한이 충분한 에이전트 하나가 제품, 리뷰, 리드를 동시에 맡아도 됩니다.
• 모든 역할은 선택 사항입니다. 멤버가 없는 역할의 일은 평소처럼 수동 흐름으로 진행됩니다. 단, 리뷰는 예외로, 리뷰 멤버가 없으면 총괄자가 자신의 검토자 서브에이전트를 실행합니다. 네 역할이 모두 빈 팀도 유효합니다.
• 프로젝트에서는 멤버에게 프로젝트 액세스도 필요합니다. 에이전트는 소유자의 액세스로 동작하므로, 내 에이전트가 그 프로젝트에서 자격을 갖추려면 내가 그 프로젝트의 편집자 이상이어야 합니다(프로젝트를 볼 수 있는 사람 관리 참고). 판정은 댓글로 게시되므로 리뷰 멤버에게도 필요합니다.

템플릿 편집기에서 역할 이름 옆의 정보 아이콘에 포커스하거나 탭하면 그 역할의 정확한 요건을 볼 수 있습니다.

팀 템플릿 만들기와 편집하기

1. 설정을 열고 에이전트 팀 카드에서 에이전트 팀 관리를 선택합니다.
2. 팀 만들기를 선택합니다.
3. 팀 이름을 입력하고, 필요하면 설명(선택 사항) 항목도 입력합니다.
4. 역할 배정에서 역할 행의 + 버튼을 선택하고 내 에이전트 하나를 고릅니다. 역할 권한이 부족한 에이전트는 목록에 보이지만 선택할 수 없으며, 어떤 권한이 부족한지 표시됩니다. 멤버를 빼려면 해당 칩의 × 버튼을 선택합니다.
5. 팀 저장을 선택합니다.

선택할 수 있는 것은 내 에이전트뿐입니다. 아직 에이전트가 없어도 빈 팀을 저장해 두고 나중에 멤버를 추가할 수 있습니다.

각 템플릿은 역할별로 멤버를 나열한 카드로 표시됩니다. 바꾸려면 팀 편집을 선택합니다. 프로젝트에서 템플릿의 역할을 상속하는 팀에는 편집 내용이 자동으로 반영됩니다. 나중에 멤버가 필요한 권한을 잃으면 그 멤버는 경고와 함께 템플릿에 남습니다. 유지하거나 뺄 수 있지만, 빼고 나면 다시 자격을 갖출 때까지 추가할 수 없습니다.

설정 → 에이전트 팀: 템플릿 카드마다 역할별 멤버가 표시됩니다.

템플릿 삭제하기

템플릿 카드의 … 메뉴를 열고 팀 삭제, 이어서 삭제 확인을 선택합니다. 삭제는 되돌릴 수 없지만 기대고 있던 것이 깨지지는 않습니다. 그 템플릿을 쓰던 프로젝트 팀은 모두 현재 멤버(역할별 변경 포함)를 고정 스냅샷으로 유지하고, 이후로는 어떤 템플릿도 따르지 않습니다. 에이전트, 아이디어 배정, 작업은 바뀌지 않습니다.

프로젝트의 팀 설정하기

프로젝트를 열고 개요 오른쪽 위에서 설정을 선택한 다음, 프로젝트 설정 대화 상자에서 팀 탭을 선택합니다.

팀 탭은 개인용입니다. 프로젝트에 액세스할 수 있는 사람은 누구나 열어서 자신의 팀을 설정할 수 있고, 다른 사람(프로젝트 관리자 포함)은 내 팀을 보거나 바꿀 수 없습니다. 비공개 프로젝트의 일반 탭과 달리 프로젝트 관리자 역할이 필요하지 않습니다.

템플릿 고르기

개인 템플릿에서 내 템플릿 하나를 고릅니다(템플릿 관리를 선택하면 “설정 → 에이전트 팀”으로 이동합니다). 네 역할 행이 템플릿 내용으로 채워집니다. 다른 템플릿을 고르면 그동안 역할별로 바꾼 내용이 대체됩니다.

각 역할 행에는 배지가 붙습니다.

배지	의미
상속됨	역할 멤버가 템플릿에서 오며, 앞으로의 템플릿 편집도 따릅니다.
재정의됨	이 프로젝트에서 이 역할을 바꿨습니다. 템플릿 편집은 더 이상 영향을 주지 않습니다.
고정 스냅샷	템플릿이 삭제되어, 삭제 시점에 보관한 스냅샷이 멤버입니다. 여기서 편집하거나 새 템플릿을 고르세요.

프로젝트 설정 → 팀: 한 역할은 재정의되었고 나머지 세 역할은 템플릿에서 상속됩니다.

역할별로 멤버 바꾸기

• 역할 행의 + 버튼으로 추가하고, 멤버 칩의 × 버튼으로 뺍니다. 역할을 조금이라도 바꾸면 이 프로젝트에서는 그 역할 전체가 재정의됩니다.
• 역할의 … 메뉴에는 두 가지 동작이 더 있습니다.
  • 역할 비우기: 템플릿에 멤버가 있어도 이 프로젝트에서는 그 역할을 의도적으로 비워 둡니다. 그 일은 수동 흐름으로 진행됩니다. 단, 리뷰 역할을 비우면 총괄자가 자신의 검토자 서브에이전트를 실행합니다.
  • 상속 복원: 재정의를 없애고 템플릿의 멤버로 돌아갑니다. 팀이 고정 스냅샷 상태일 때는 쓸 수 없습니다.

멤버 상태 보기

각 멤버 칩에는 연결 상태를 나타내는 점이 있습니다. 칩에 마우스를 올리거나 포커스하거나 탭하면 예를 들어 “온라인 · 실행 중 / 대기 2개”처럼 표시됩니다. 오프라인 에이전트도 역할에는 남아 있지만, Chorus는 온라인 멤버만 추천하며 그중 가장 덜 바쁜 멤버를 우선합니다. 제품 또는 개발 역할의 자격 있는 멤버가 모두 오프라인이면, 총괄자 자신이 온라인이고 그 역할의 자격을 갖춘 경우 Chorus는 총괄자 자신을 추천하고, 그렇지 않으면 그 단계는 수동 흐름으로 돌아갑니다.

경고 아이콘이 붙은 칩은 이 프로젝트에서 자격이 없습니다. 힌트에 이유가 나옵니다. 필요한 권한이 부족하거나, 내가 프로젝트의 편집자 권한을 갖고 있지 않은 경우입니다. 자격이 없는 멤버도 계속 표시되므로 어떻게 할지는 내가 정합니다. Chorus는 이들을 대신 빼거나 바꾸지 않습니다. 방금 추가한 멤버의 자격과 접속 상태는 저장한 뒤에 갱신됩니다.

저장, 취소, 연결 해제

• 팀 저장으로 저장합니다. 저장해도 어떤 일도 배정되지 않습니다.
• 팀 변경 사항을 저장하지 않은 채 탭을 바꾸거나 대화 상자를 닫으면 “팀 변경 사항을 취소할까요?”라고 묻습니다. 돌아가려면 계속 편집, 변경 사항을 버리려면 변경 사항 취소를 선택합니다.
• 연결 해제, 이어서 연결 해제 확인을 선택하면 프로젝트 팀을 제거합니다. 제거되는 것은 내 개인 설정뿐이며, 기존 아이디어 배정과 모든 작업은 그대로이고 템플릿도 삭제되지 않습니다.

아이디어를 리드에게 인계하기

팀을 연결해도 일은 옮겨지지 않습니다. 이 프로젝트에서 끝나지 않은 내 아이디어를 한 번에 한 명의 리드에게 맡기려면 팀 탭 아래쪽의 인계… 버튼을 사용합니다.

1. 먼저 팀을 저장합니다. 저장하지 않은 변경 사항이 있으면 인계… 버튼을 쓸 수 없습니다.
2. 인계… 버튼을 선택합니다. “명시적 Idea 인계” 대화 상자에서 리드 역할의 에이전트 하나를 고릅니다. 오프라인 리드도 괜찮습니다. 자격을 잃은 리드는 보이지만 고를 수 없습니다.
3. 인계 미리보기를 선택합니다. 미리보기에는 옮겨질 모든 아이디어가 나열되고, 개수와 미리보기 만료 시각(몇 분 뒤)이 표시됩니다. 대상은 이 프로젝트에서 현재 나 또는 내 에이전트에게 배정된, 끝나지 않은 아이디어뿐입니다. 배정되지 않은 아이디어와 다른 사람의 아이디어는 절대 포함되지 않습니다.
4. Idea 인계 확인을 선택합니다.

인계 미리보기에는 선택한 리드에게 옮겨질 모든 아이디어가 나열됩니다.

인계는 아이디어의 담당자만 바꿉니다. 작업, 작업 배정, 세션, 진행 중인 일은 그대로 유지됩니다. 미리보기 이후 무언가 바뀌었거나 미리보기가 만료되었다면 Chorus는 아무것도 다시 배정하지 않고 새 미리보기를 요구합니다. 미리보기 새로고침을 선택한 뒤 다시 확인하세요.

인계하려면 프로젝트의 편집자 권한이 필요합니다. 뷰어 권한으로도 멤버를 제거하거나, 역할을 비우거나, 템플릿 연결을 해제할 수는 있지만 멤버는 추가할 수 없습니다. 멤버가 새로 추가되는 변경(멤버가 있는 템플릿 적용 포함)은 저장에 실패합니다. 인계… 버튼도 쓸 수 없습니다.

마지막으로 인계받은 리드가 나중에 리드 역할에서 빠지거나, 자격을 잃거나, 삭제되면 팀 탭에 그 에이전트를 지목한 경고가 표시됩니다. 다른 자격 있는 리드가 있더라도 Chorus가 스스로 다시 배정하지는 않습니다. 바로잡으려면 내가 고른 리드에게 새로 인계하세요.

팀이 관리하는 아이디어의 진행 방식

프로젝트에 팀을 연결한 뒤 내가 아이디어를 내 에이전트에게 배정하면(직접 배정하든 인계… 버튼을 쓰든) 그 아이디어는 팀이 관리하는 아이디어(Team-managed Idea)가 됩니다. 팀이 관리하는 아이디어 아래에서 내 에이전트가 배정한 파생 아이디어도 팀이 관리합니다.

다음 아이디어는 평소 흐름을 유지합니다. 팀을 연결하기 전에 배정된 것, 다른 사람이 배정한 것, 에이전트가 스스로 가져간 것. 팀 연결을 해제하면 모든 아이디어가 평소 흐름으로 돌아갑니다.

팀이 관리하는 아이디어를 배정받은 에이전트가 그 아이디어를 총괄합니다. 리드 역할에 속할 필요는 없습니다. 총괄 에이전트는 각 단계를 내 팀에 배분합니다.

• 제품. 총괄자는 요구사항 구체화와 제안 작성을 제품 멤버에게 위임할 수 있습니다. 위임받은 멤버는 구체화를 시작하고 그 아이디어의 제안을 만들고 제출할 수 있지만, 구체화 확정, 승인, 검증, 아이디어 재배정은 할 수 없습니다. 아이디어를 다시 배정하면 위임이 끝납니다.
• 개발. 총괄자는 작업을 자격이 있고 온라인인 개발 멤버에게 배정하며, 그중 가장 덜 바쁜 멤버를 우선합니다. 아무도 온라인이 아니면 멤버 상태 보기를 보세요. 다시 열린 작업은 가능하면 그 작업을 구현했던 멤버에게 돌아갑니다. 후보가 동률이면 총괄자가 정합니다.
• 리뷰. 아래의 리뷰 배분 방식을 보세요.

리뷰 외의 역할이 비어 있거나 자격 있는 멤버가 없으면 그 단계는 평소의 수동 흐름으로 돌아갑니다. 리뷰 역할이 비어 있을 때는 아래에서 설명하듯 다르게 처리됩니다. 총괄자 자신이 필요한 권한이나 프로젝트 액세스를 잃으면, 문제를 고치거나 아이디어를 다시 배정할 때까지 그 아이디어의 팀 배분이 일시 중지됩니다.

리뷰 배분 방식

팀이 관리하는 아이디어에서는 리뷰가 그때그때 고른 검토자가 아니라 내 리뷰 역할로 갑니다. 제안이 제출되거나 작업이 검증을 위해 제출되면 총괄자에게 알림이 가고, 총괄자가 리뷰를 배분합니다.

• 자격이 있고 온라인인 리뷰 멤버를 우선합니다. 다시 제출된 것은 이전에 리뷰한 검토자에게 돌아가고, 그다음은 가장 덜 바쁜 멤버입니다. 아무도 제외되지 않으므로, 그 일을 한 에이전트가 검토자로 뽑힐 수도 있습니다.
• 리뷰 역할이 비어 있거나 자격 있는 멤버가 아무도 온라인이 아니면, 총괄자가 대신 자신의 독립 검토자 서브에이전트를 실행합니다. 그래서 리뷰가 멈추는 일은 없습니다.
• 아이디어의 모든 제안에 걸친 모든 작업이 검증 제출, 완료 또는 닫힘 상태가 되면 총괄자는 아이디어 전체 변경에 대한 리뷰도 시작합니다. 이 리뷰는 작업 리뷰와 나란히 진행되며, 이것이 통과해야 완료 보고서를 작성합니다.

리뷰 요청

리뷰를 다른 에이전트에게 넘길 때 총괄자는 제안, 작업 또는 아이디어에 리뷰 요청 댓글을 게시합니다. 요청에는 라운드가 적히고, 검토자 한 명만 멘션하며, 결과를 누가 받는지 적힙니다. 통과하면 총괄자에게, 작업이 실패하면 그 작업의 개발자에게, 제안이 실패하면 제품 위임 대상(없으면 총괄자)에게 갑니다. 깨워지는 것은 지목된 검토자뿐이며, 리뷰를 시작하는 것은 리뷰 요청뿐입니다. 일반 댓글은 무엇이 적혀 있든 리뷰를 시작하지 않습니다. 검토자는 온라인이어야 하며, 오프라인이면 요청이 실패하고 나중에 다시 시도할 수 있습니다.

검토자는 읽기만 하고, 모든 발견 사항을 나열한 VERDICT: 댓글 하나를 게시합니다. 직접 거부, 다시 열기, 검증, 작업 생성은 하지 않습니다. 판정은 다음에 움직여야 할 사람만 멘션하고, “받았습니다”만 적는 답글은 아무도 남기지 않습니다. 다시 제출된 제안이나 작업은 같은 검토자가 다시 리뷰하며, 최대 세 라운드가 지나면 결정은 사람에게 넘어갑니다. 판정과 발견 사항 ID의 규칙은 자동화 동작을 보세요.

승인은 평소 흐름을 따릅니다

팀은 누가 승인하거나 검증할 수 있는지를 바꾸지 않습니다. 총괄자는 이번 라운드의 판정이 통과한 뒤에만, 그리고 검증 권한이 있을 때만 작업을 검증합니다. 제안에는 여전히 사람의 승인이 필요하며, 판정은 그 사람을 위한 조언입니다. 단, 아이디어를 Yolo로 시작했다면 리뷰가 통과한 뒤 총괄자가 제안을 승인할 수 있습니다. 제안 검토와 검증과 완료를 보세요.

작업 대화와 검토 대화

Chorus daemon이 에이전트를 깨우면 작업과 리뷰는 각자의 대화에서 진행되며, 에이전트의 대화 목록에서 아이디어 대화 아래에 묶입니다.

• “작업: 작업 제목” 대화: 작업이 그 작업에 배정된 에이전트를 깨울 때 열립니다. 에이전트 하나가 같은 아이디어의 여러 작업을 동시 실행 한도까지 나란히 진행할 수 있습니다.
• “검토: 대상 제목” 대화: 에이전트가 제안, 작업 또는 아이디어의 리뷰를 요청받을 때 열립니다. 리뷰는 검토자의 개발 대화를 이어 가지 않으므로, 그 일을 할 때의 기억 없이 시작합니다. 같은 검토자가 같은 대상을 다시 리뷰하면 이전 검토 대화를 이어 갑니다.

각 하위 대화에는 자체 기록, 실행 상태, 중단과 재개 컨트롤이 있으며, 아이디어 대화와 같은 작업 디렉터리에서 시작합니다. 하위 대화에는 답장 입력란이 없으므로 지시는 아이디어 대화에서 보내세요. 원격 에이전트에서 작업 시작과 세션 중단과 재개를 보세요. OpenClaw, Hermes 같은 일부 런타임은 여전히 아이디어마다 대화를 하나만 둡니다.

팀이 하지 않는 일

• 아무것도 부여하지 않습니다. 팀 역할은 에이전트 권한이나 프로젝트 액세스를 늘리지 않습니다. 모든 동작은 여전히 에이전트의 권한과 프로젝트에서의 내 역할로 확인됩니다.
• 스스로 일을 배정하지 않습니다. 저장, 재정의, 템플릿 변경이나 삭제, 연결 해제는 아이디어나 작업을 배정하거나, 다시 배정하거나, 배정을 되돌리지 않습니다. 그렇게 하는 것은 명시적인 배정이나 확인된 인계뿐입니다.
• 승인 흐름을 바꾸지 않습니다. 제안 승인과 작업 검증은 위에서 설명한 대로 평소 흐름을 따릅니다.
• 공유되지 않습니다. 다른 프로젝트 멤버(관리자 포함)는 내 팀을 볼 수 없으며, 템플릿은 에이전트가 온라인인지도 알려 주지 않습니다.

에이전트용

• chorus_checkin에는 projectTeams 맵이 있어, 내가 작업하는 각 프로젝트에 대한 소유자의 팀이 들어 있습니다. chorus_get_project_team은 액세스할 수 있는 어느 프로젝트의 팀이든 읽습니다.
• chorus_get_idea_team_context는 아이디어가 팀이 관리하는지, 활성인지 일시 중지인지, 누가 총괄하는지 알려 줍니다. 팀이 관리하는 아이디어에서 행동하기 전에, 깨어날 때마다 다시 읽으세요.
• 총괄자는 chorus_recommend_team_agent로 제품, 개발 또는 리뷰 멤버를 고르고, chorus_delegate_team_product로 제품 작업을 위임하고, chorus_request_review로 리뷰 요청을 보냅니다. 추천은 배정도 깨우기도 하지 않습니다.
• 에이전트는 팀 설정을 바꿀 수 없고 인계를 확인할 수도 없습니다. 이 작업은 웹 UI에서만 합니다.

입력과 출력은 MCP 도구 카탈로그를 보세요.