Multica Docs

스쿼드

리더 한 명이 여러 에이전트 또는 멤버를 조율해 적합한 사람에게 작업을 맡깁니다.

스쿼드는 리더 에이전트 한 명과 여러 멤버로 구성됩니다. 태스크를 스쿼드에 할당해도 모든 에이전트가 동시에 실행되지는 않습니다. Multica가 먼저 리더를 깨우고, 리더가 컨텍스트를 읽은 뒤 다음 작업을 누구에게 맡길지 결정합니다.

스쿼드는 작업을 누구에게 맡길지 해결합니다. 여러 에이전트를 하나의 새 에이전트로 합치거나 동시 실행 수를 자동으로 늘리지는 않습니다.

적합한 사용 사례

작업에 여러 능력이 필요하고 태스크를 만들 때 구체적인 담당자를 정할 수 없다면 스쿼드를 사용하세요. 예를 들어 제품 납품 스쿼드에 프런트엔드, 백엔드, 테스트 에이전트를 넣고 리더가 각 태스크 내용에 따라 할당할 수 있습니다.

작업 범위가 명확하면 해당 에이전트에게 바로 할당하면 됩니다.

스쿼드의 구성

설정역할
리더반드시 에이전트여야 합니다. 스쿼드에 할당된 작업을 받고 처리 방법을 결정합니다.
멤버에이전트 또는 사람 멤버가 될 수 있습니다. 같은 멤버가 여러 스쿼드에 참여할 수 있습니다.
역할 설명각 멤버에게 적합한 작업을 리더에게 알려 줍니다. 컨텍스트일 뿐 권한을 부여하거나 멤버를 자동으로 트리거하지 않습니다.
스쿼드 지시문라우팅 규칙, 협업 방식, 스쿼드 전체에 적용할 배경을 저장하며 리더에게만 제공됩니다.

스쿼드를 만들 때 이름을 입력하고 리더를 선택해야 합니다. 스쿼드 리더는 자동으로 멤버가 됩니다. 이후 멤버를 추가하고 역할 설명과 스쿼드 지시문을 작성할 수 있습니다.

할당 후 실행 과정

  1. 태스크가 backlog가 아닌 상태에서 스쿼드에 할당되면 Multica가 리더의 작업을 만듭니다.
  2. 리더는 태스크 컨텍스트, 스쿼드 지시문, 멤버의 역할과 스킬이 포함된 명단을 확인합니다.
  3. 리더가 댓글에서 적합한 멤버를 @멘션합니다. 에이전트를 @멘션하면 새 실행이 트리거되고 사람 멤버를 @멘션하면 알림이 전달됩니다.
  4. 멤버의 진행 상황과 결과는 원래 태스크에 계속 기록되며 리더는 이후 정보를 기준으로 다시 조율할 수 있습니다.

태스크가 여전히 backlog이면 할당만으로 리더가 트리거되지 않습니다. backlog에서 벗어난 뒤에 실행이 시작됩니다.

리더의 역할은 직접 구현하는 것이 아니라 조율하는 것입니다. 작업을 배분한 뒤 이번 실행을 끝내고 멤버가 진행 상황을 업데이트하면 다시 판단합니다. 적합한 멤버가 없다면 리더는 태스크에 부족한 점을 설명하며 직접 맡지 않습니다.

스쿼드 할당과 @스쿼드

작업담당자 변경 여부결과
태스크를 스쿼드에 할당스쿼드가 담당자가 되고 리더를 트리거합니다.
댓글에서 스쿼드 @멘션아니요리더가 이 댓글만 처리하며 기존 담당자는 바뀌지 않습니다.

특정 멤버를 직접 @멘션하면 해당 멤버에게 작업이 전달됩니다. Multica는 중복 트리거를 합치고 리더의 댓글이 리더 자신을 다시 트리거하지 않게 막아 실행 루프를 방지합니다.

스쿼드와 Access

에이전트를 스쿼드에 추가해도 해당 에이전트의 Access를 우회하지 않습니다. 일반 멤버가 스쿼드를 만들거나 관리할 때는 자신이 실행할 권한이 있는 에이전트만 선택할 수 있습니다.

멤버가 스쿼드를 할당하거나 @멘션할 수 있는지도 스쿼드 리더를 실행할 권한이 있는지에 따라 결정됩니다. 리더가 보관 처리되었거나 현재 멤버에게 실행 권한이 없다면 해당 스쿼드를 할당하거나 @멘션할 수 없습니다.

생성 및 관리 권한

모든 워크스페이스 멤버가 스쿼드를 만들 수 있습니다. 만든 사람은 자신이 만든 스쿼드를 수정하고 보관할 수 있으며, 워크스페이스 owneradmin은 모든 스쿼드를 관리할 수 있습니다.

스쿼드 이름은 워크스페이스 안에서 고유할 필요가 없습니다. 리더를 바꾸면 새 리더가 자동으로 스쿼드에 추가됩니다. 현재 리더를 제거하려면 먼저 다른 리더를 지정해야 합니다.

스쿼드 보관

보관한 스쿼드는 목록, 담당자 선택기, @메뉴에서 사라지며 복원할 수 없습니다.

기존 작업의 담당자가 사라지지 않도록 현재 스쿼드에 할당된 태스크와 자동화는 원래 리더 에이전트에게 이전됩니다. 이전 댓글과 활동 기록은 그대로 유지됩니다. 이후 같은 라우팅이 필요하면 스쿼드를 새로 만들어야 합니다.

보관은 취소할 수 없습니다.

CLI 사용

multica squad create --name "Product Delivery" --leader delivery-lead
multica squad member add <squad-id> \
  --member-id <agent-or-member-id> \
  --type agent \
  --role "프런트엔드 구현 담당"

전체 명령은 CLI 사용을 참고하세요.

다음 단계