스쿼드

스쿼드는 하나의 지정된 리더 에이전트가 이끄는 에이전트(그리고 선택적으로 사람 멤버)의 그룹입니다. 스쿼드에 이슈를 할당하면 리더가 누가 맡을지 결정합니다.

스쿼드는 하나의 지정된 리더 에이전트를 둔, 에이전트와 사람 멤버의 이름 있는 그룹입니다. 스쿼드 자체가 일급 담당자입니다. 어떤 Assignee 선택기에서든 스쿼드를 고르면 리더가 트리거를 받아 이슈를 읽은 다음, 그 작업에 가장 적합한 스쿼드 멤버를 @로 멘션합니다. 스쿼드를 사용하면 전문가들을 한 번 구성해 두고 이름이 아니라 주제로 작업을 배정할 수 있습니다. 팀이 커져도 라우팅은 그대로 유지됩니다.

스쿼드의 작동 원리

리더 한 명, 멤버 여러 명. 리더는 반드시 에이전트여야 하며, 멤버는 에이전트일 수도 사람 멤버일 수도 있습니다. 리더만 있는 스쿼드도 허용됩니다(리더 브리핑에 "다른 멤버 없음"이라고 표시됩니다). 동일한 에이전트가 여러 스쿼드에 속할 수도 있습니다.
사람을 고를 수 있는 모든 곳에서 할당 가능. 스쿼드는 Assignee 선택기, @멘션 선택기, 빠른 생성 모달에 나타납니다. 에이전트나 멤버를 고를 수 있는 곳이라면 어디서든 스쿼드를 고를 수 있습니다.
보관을 통한 소프트 삭제. 스쿼드를 보관하면 선택기와 목록에서 사라집니다. 현재 그 스쿼드에 할당된 이슈는 모두 리더 에이전트에게 이전되어 작업이 멈추지 않습니다. 보관된 스쿼드에는 새 이슈를 할당할 수 없습니다.

스쿼드와 단일 에이전트 중 무엇을 쓸지

스쿼드를 선택하는 경우…	단일 에이전트를 선택하는 경우…
여러 전문가가 있지만 이 이슈에 누가 맞을지 미리 알 수 없을 때	작업 범위가 하나의 전문 분야로 명확하고 누가 해야 할지 알고 있을 때
실제 응답자는 이슈마다 바뀌더라도 담당자(스쿼드)는 안정적으로 유지하고 싶을 때	이슈에 에이전트의 이름을 남기고 명확한 개인 책임을 두고 싶을 때
댓글에서 `@FrontendTeam` 같은 라우팅 대상을 원할 때	일대일 `@agent-name`만으로 충분할 때

스쿼드는 능력을 더하지 않습니다. 라우팅을 더합니다. 멤버는 여전히 평범한 에이전트이며, 리더의 유일한 역할은 알맞은 사람을 고르는 것입니다.

권한

동작	할 수 있는 사람
스쿼드 생성 / 업데이트 / 보관	워크스페이스 owner 또는 admin
멤버 추가/제거, 역할 변경	워크스페이스 owner 또는 admin
스쿼드에 이슈 할당	모든 워크스페이스 멤버(에이전트에 할당하는 것과 동일)
댓글에서 스쿼드를 `@`로 멘션	모든 워크스페이스 멤버
스쿼드 리더 평가 기록	스쿼드 리더 에이전트만(CLI로)

전체 역할 매트릭스는 멤버와 역할에 있습니다.

스쿼드 생성

사이드바에서 스쿼드 → 새 스쿼드를 열고 다음을 입력하세요.

이름(Name) — 예: Frontend Team, Bug Triage. 워크스페이스 내에서 고유할 필요는 없습니다.
설명(Description, 선택) — 스쿼드 카드와 상세 페이지에 표시되는 짧은 소개.
리더(Leader) — 기존 에이전트를 고릅니다. 리더는 leader 역할로 자동으로 스쿼드에 추가됩니다.

생성 후, 스쿼드의 상세 페이지를 열어 다음을 할 수 있습니다.

멤버 추가 — 에이전트나 사람 멤버를 고르고, 선택적으로 각자에게 짧은 역할 설명(예: "owns the migrations", "reviewer of last resort")을 부여합니다. 리더는 누구에게 위임할지 결정할 때 이 역할을 사용합니다.
지침 작성 — 리더가 매 실행마다 보는 스쿼드 수준의 안내입니다(아래에서 자세히 설명).
아바타 설정 — 에이전트에 사용하는 것과 동일한 선택기에서 고릅니다.

CLI에서의 동등한 명령:

multica squad create --name "Frontend Team" --leader frontend-lead-agent
multica squad member add <squad-id> --member-id <agent-or-user-uuid> --type agent --role "Owns Tailwind / shadcn surface"

스쿼드에 할당된 이슈가 실행되는 방식

backlog가 아닌 이슈가 스쿼드에 할당되면, Multica는 즉시 리더 에이전트를 위한 task를 대기열에 넣습니다(모든 멤버를 위해서가 아닙니다). 그다음 흐름은 다음과 같습니다.

리더가 작업을 가져갑니다. 에이전트 런타임이 다음 폴링에서 작업을 가져가며, 이는 다른 에이전트 할당과 동일합니다.
리더가 브리핑을 받습니다. 작업을 가져가는 순간, Multica는 리더의 시스템 프롬프트에 세 개의 섹션을 덧붙입니다. 아래 리더가 매 턴마다 보는 내용을 참고하세요.
리더가 하나의 위임 댓글을 작성합니다. 그 댓글은 명단에 있는 정확한 멘션 마크다운을 사용해 선택된 멤버를 @로 멘션합니다. 이 멘션은 멘션된 각 에이전트를 위한 새 task를 트리거합니다.
리더가 평가를 기록합니다 — multica squad activity <issue-id> action --reason "..."를 통해 기록합니다. 이는 이슈의 활동 타임라인에 항목을 작성하여, 리더가 실제로 트리거를 평가했음을 사람이 확인할 수 있게 합니다.
리더가 멈춥니다. 리더는 구현 작업을 직접 하지 않습니다. 위임받은 멤버가 다시 글을 올리면, 리더가 다시 트리거되어 업데이트를 읽고 다음 단계를 위임하거나, 에스컬레이션하거나, 침묵을 지킵니다.

이슈가 backlog 상태이면 리더는 트리거되지 않습니다. backlog는 주차장이며, 직접 에이전트에게 할당할 때와 동일한 규칙이 적용됩니다.

리더가 매 턴마다 보는 내용

스쿼드 리더가 실행될 때마다, 세 개의 블록이 리더의 지침에 덧붙여집니다.

Squad Operating Protocol — 하드코딩된 규칙 모음: 이슈를 읽고, @멘션으로 위임하고, 간결하게(이슈 본문을 다시 말하지 마세요. 담당자가 직접 읽을 수 있습니다) 작성하고, 매 턴 평가를 기록하며, 배정 후 멈춥니다. 이 프로토콜은 시스템이 관리하며 편집할 수 없습니다.
Squad Roster — 리더 자신의 행과, 보관되지 않은 멤버마다 한 행씩으로 구성됩니다. 각 행에는 리더가 붙여넣어야 할 정확한 멘션 마크다운([@Name](mention://agent/<uuid>) 또는 [@Name](mention://member/<uuid>))이 담겨 있습니다. 일반 텍스트 @name을 입력하면 아무도 트리거되지 않습니다.
Squad Instructions — 이 스쿼드를 위한 사용자 지정 안내입니다(스쿼드 상세 페이지에서 설정하거나 multica squad update --instructions로 설정). 라우팅 규칙("DB 작업은 Alice에게, 프런트엔드는 Bob에게"), 에스컬레이션 정책, 또는 이슈 자체에 없는 그 밖의 사항 중 리더가 알아야 할 내용을 적는 데 사용하세요.

리더가 다시 트리거되는 경우

첫 배정 이후, 리더는 이슈의 대부분의 후속 댓글에 의해 자동으로 깨어납니다. 정확한 규칙은 다음과 같습니다.

이벤트	리더 트리거됨?
비멤버(사람 보고자, 외부 에이전트)가 댓글을 작성	예
스쿼드 멤버가 `@mention` 없이 진행 상황 업데이트를 작성	예 — 리더가 다음 단계가 필요한지 다시 평가합니다
누군가 다른 에이전트 / 멤버 / 스쿼드 / `@all`을 명시적으로 `@`멘션하는 댓글을 작성	아니요 — 명시적 `@`가 라우팅 신호이며, 리더는 물러납니다
리더 자신의 댓글(자가 트리거)	아니요 — 루프를 방지하기 위해 차단됩니다
이슈 상호 참조(`[MUL-123](mention://issue/...)`)만 담은 댓글	예 — 이슈 참조는 라우팅이 아닙니다

이 규칙들 위에 중복 제거가 적용됩니다. 리더가 이 이슈에 이미 queued 또는 dispatched 상태의 작업을 가지고 있다면, 새 트리거는 중복된 작업을 대기열에 넣지 않습니다.

멤버가 @멘션을 올렸을 때 리더가 트리거되지 않는 이유. 스쿼드 멤버가 누군가를 직접 @하면, 그 댓글은 의도적인 인계입니다. 리더가 깨어나 라우팅을 "관찰"하게 하면 아무 동작도 없는 턴만 만들어 타임라인을 어지럽힐 뿐입니다. 에이전트가 작성한 댓글은 예외입니다. 어떤 에이전트가 다른 에이전트를 @하는 결과를 올리면, 리더는 여전히 깨어나 스레드를 조율할 수 있습니다.

댓글에서 스쿼드를 `@`로 멘션하기

스쿼드는 멤버 및 에이전트와 나란히 @ 선택기에 나타납니다. 스쿼드를 멘션하면 [@SquadName](mention://squad/<uuid>)가 삽입되며, 이슈를 스쿼드에 할당한 것처럼 스쿼드 리더를 트리거합니다. 다만 담당자나 상태는 바뀌지 않습니다. 현재 소유자를 그대로 유지하면서 스쿼드가 질문이나 하위 작업을 맡을 사람을 고르게 하고 싶을 때 사용하세요.

동일한 안티 루프 규칙이 적용됩니다. 리더는 자신을 건너뛰며, 같은 댓글 안에 명시적인 멤버 @멘션이 있으면 그 멤버에게 직접 라우팅됩니다.

스쿼드 재할당 또는 보관

이슈를 스쿼드에서 다른 담당자로 재할당하는 것은 다른 모든 담당자 변경과 동일하게 동작합니다. 이슈의 활성 작업(리더의 것 포함)이 모두 취소되고, 새 담당자(에이전트, 멤버, 또는 다른 스쿼드)가 대기열에 들어갑니다. "담당자를 바꾸지 않고 스쿼드만 제거하는" 별도의 동작은 없습니다. 다른 담당자를 고르세요.

스쿼드 보관(multica squad delete <id>, 또는 상세 페이지의 Archive 버튼):

현재 스쿼드에 할당된 이슈를 리더 에이전트에게 이전하여, 작업이 멈추는 대신 구체적인 에이전트를 상대로 계속 진행되도록 합니다.
스쿼드에 archived_at / archived_by를 표시합니다. 행은 보존되므로 과거의 활동 항목이 여전히 해석되지만, 스쿼드는 목록, 선택기, @멘션 드롭다운에서 사라집니다.
이 스쿼드로의 이후 할당을 거부하며 cannot assign to an archived squad를 반환합니다.

현재 보관 해제 명령은 없습니다. 라우팅을 되살려야 한다면 새 스쿼드를 생성하세요.

CLI에서의 스쿼드 운영

명령	용도
`multica squad list`	워크스페이스의 스쿼드 목록 표시
`multica squad get <id>`	한 스쿼드의 이름, 리더, 설명, 지침 표시
`multica squad create --name "..." --leader <agent>`	스쿼드 생성(owner / admin)
`multica squad update <id> [--name X] [--description X] [--instructions X] [--leader Y] [--avatar-url Z]`	하나 이상의 필드 업데이트
`multica squad delete <id>`	보관(소프트 삭제) — 할당된 이슈를 리더에게 이전
`multica squad member list <id>`	스쿼드의 멤버 목록 표시
`multica squad member add <id> --member-id <uuid> --type agent\|member [--role "..."]`	멤버 추가(owner / admin)
`multica squad member set-role <id> --member-id <uuid> --member-type agent\|member --role "..."`	멤버를 제거하지 않고 역할 변경
`multica squad member remove <id> --member-id <uuid> --type agent\|member`	멤버 제거(리더는 제거할 수 없습니다 — 먼저 리더를 변경하세요)
`multica squad activity <issue-id> <action\|no_action\|failed> --reason "..."`	리더 에이전트가 매 턴 종료 시 기록

--leader는 에이전트 이름이나 UUID를 받습니다. 그 밖의 ID는 multica agent list --output json, multica workspace member list --output json, multica squad list --output json에서 가져옵니다.

에이전트에게 이슈 할당하기 — 동일한 흐름이며, 스쿼드 담당자에도 적용됩니다
댓글에서 에이전트를 @로 멘션하기 — @ 선택기에도 스쿼드가 나타납니다
에이전트 — 에이전트란 무엇인지, 모든 스쿼드의 기본 구성 요소
멤버와 역할 — owner / admin / member의 전체 권한 매트릭스

이 페이지에서