Agent Teams.
진짜 테크 크루를, 스크립트로.

Claude subagents는 단일 부모 Claude 세션의 인라인 위임입니다. 부모가 언제 subagent를 호출할지 결정하고, subagent는 격리된 컨텍스트 윈도우에서 실행되고, 결과를 반환하고, 부모가 계속합니다. AgentsRoom Teams는 한 단계 위입니다: 각 노드는 자신의 터미널, 자신의 상태, 자신의 스크롤백을 가진 톱레벨 Claude Code 세션입니다. 모든 에이전트 런을 자신의 탭에서 실시간으로 보고, 언제든 어느 것과도 대화할 수 있고, 팀을 일시정지하고, 워크플로우를 변경하고, 재개할 수 있습니다. Claude subagents의 대체가 아니며, 둘 다 절대 사용할 수 있습니다. 팀 노드가 내부적으로 subagents를 사용할 수 있습니다.

AgentsRoom이 지원하는 에이전트 CLI 17개(Claude Code, Codex CLI, GitHub Copilot CLI, Cursor 및 그 외 13개) 전부와 작동합니다. 각 팀 노드는 자신의 프로바이더와 모델을 고릅니다. MCP 기반 팀 코디네이션 도구는 표준 Model Context Protocol을 통해 노출되므로 프로바이더 간에 동일하게 작동합니다. 예산과 지연시간에 맞으면 무거운 백엔드 노드에 Codex, QA 노드에 Haiku를 사용하는 팀을 실행할 수 있습니다.

한 에이전트에서 다음으로 이동하는 구조화된 객체입니다. 필드: featureSummary(방금 출시한 것의 짧은 설명), changedFiles(git diff name-status), touchedAreas(UI, API, DB, config), risks(다음 에이전트가 걱정해야 할 것), testHints(QA 우선순위), flags(조건부 엣지가 사용하는 qaPassed 같은 boolean). 에이전트가 이 페이로드로 team_complete_step을 호출하고, 러너가 서버 사이드에서 검증하고, 다음 에이전트가 시작 컨텍스트로 받습니다.

네. 노드가 다시 들어갈 때(cycle이 1보다 큼), AgentsRoom은 새 에이전트를 스폰하지 않습니다. cycle 1의 원래 에이전트를 재사용하고, 새 핸드오프 페이로드를 기존 터미널에 직접 작성하고, 에이전트는 이전 사이클의 전체 Claude 세션 메모리를 유지합니다. 이건 중요합니다: QA가 지난번 무엇을 플래그했는지 이미 아는 Dev 에이전트가 버그를 고칩니다. 메모리 없는 새 Dev 에이전트는 같은 실수를 반복할 뿐입니다.

팀 설정에 max-cycles 가드가 있습니다, 기본 3. 상한에 도달하면, 런이 'blocked' 상태로 일시정지하며 마지막 핸드오프 보고서를 보여줍니다: 사이클을 한두 개 추가로 부여하면 팀은 멈췄던 바로 그 지점에서 다시 이어갑니다. 런을 마무리하거나, 모든 걸 취소할 수도 있습니다. 무한 루프 없음, 야간 깜짝 청구서 없음.

네. 기본적으로 팀은 단일 워크스페이스와 단일 브랜치(또는 AgentsRoom Worktrees 기능을 사용하면 worktree)에서 실행됩니다. 각 에이전트는 git을 통해 이전 에이전트의 작업을 봅니다. 핸드오프 페이로드는 런 베이스라인 대비 git diff를 포함하므로 다음 에이전트는 정확히 무엇이 새로운지 압니다. 단계는 자기만의 일회용 체크아웃을 가질 수도 있습니다: 단계에서 '전용 체크아웃'을 체크하면 그 단계는 커밋되지 않은 작업까지 포함한 런 워크스페이스의 스냅샷에서 잘라낸 git worktree 안에서 실행되므로, 측정하거나 검토하는 병렬 단계(커버리지 런, 테스트 프로브)가 더 이상 서로의 파일을 덮어쓰지 않습니다. 거기에 쓰인 것은 런의 브랜치에 닿지 않고, 단계는 핸드오프와 노트를 통해 보고하며, 체크아웃은 의존성이 설치되지 않은 상태로 시작합니다. 병렬 단계 둘이 같은 트리를 공유하고 그중 하나가 쓸 수 있으면 에디터가 경고합니다.

아니요. Teams는 AgentsRoom의 일부입니다. 자신의 프로바이더 키(Claude, Codex, GitHub Copilot CLI, Cursor 및 그 외 에이전트 CLI 13개)를 가져오고 사용한 토큰만큼만 지불합니다, 단일 에이전트와 같이. 작은 티켓에서 Dev to QA 팀을 실행하는 것은 일반적으로 단일 Fullstack 에이전트를 실행하는 것과 같은 비용입니다, QA 단계의 Haiku/Sonnet이 저렴하기 때문입니다.

프로젝트 팀은 room과 함께 살며 계정과 동기화되고 {project}/.agentsroom/teams-cache.json (gitignored)에 캐시됩니다. 글로벌 팀도 계정과 동기화됩니다: 라이브러리가 머신을 옮겨도 따라오고, ~/.agentsroom/teams/가 오프라인 캐시입니다. 포함된 템플릿은 로컬에 남습니다: 각 머신이 자기 언어로 설치합니다.

실행 상태는 {workspace}/.agentsroom/team-runs/{runId}/에 디스크로 저장됩니다 (state.json, NOTES.md, inbox/, timeline.jsonl). 쓰기는 원자적이고 노트는 추가 전용입니다. 중단된 실행은 앱 재시작 시 재개됩니다: 오케스트레이터가 활성 단계로 다시 들어가고, 터미널을 다시 열고, 에이전트는 노트와 팀 도구에서 컨텍스트를 되찾습니다. 팀 정의가 삭제된 실행은 영원히 남는 대신 자동으로 닫힙니다.

네. 각 실행은 독립적이며 runId로 식별됩니다. 같은 프로젝트의 세 티켓에서 세 팀이 동시에 살아 있을 수 있습니다. 하나의 실행 안에서 흐름은 그래프를 따릅니다: 기본은 순차, 병렬 브랜치를 그린 곳에서는 병렬 (예: QA와 Security의 동시 리뷰), 언제나 결정적인 합류로 돌아옵니다.

네. 한 노드에서 조건 없는 연결 두 개를 그리면 두 대상이 병렬 브랜치로 돌아갑니다. 각자 자기 에이전트와 터미널을 가집니다. 브랜치는 노드 하나 깊이이며 공통 합류 노드로 수렴해야 하고, 에디터가 실행 전에 이를 검증합니다. 모든 브랜치가 끝나면 합류는 병합된 payload 하나를 받습니다: 역할이 표시된 요약, 중복 제거된 리스크와 테스트 힌트, 페일세이프 규칙으로 병합된 플래그 (불리언 충돌은 false로 해소)입니다.

노드에 셸 명령을 입력합니다. 예를 들어 npm test, 원하면 플래그 이름도 (기본 checkPassed). 에이전트가 단계 완료를 알리면 AgentsRoom이 5분 상한으로 워크스페이스에서 명령을 실행합니다. 종료 코드 0은 플래그에 true를, 그 외에는 false를 쓰며 에이전트의 자기 보고를 덮어씁니다. 실패하면 출력의 마지막 몇 킬로바이트가 다음 에이전트에게 전달됩니다: 루프백은 진짜 스택 트레이스와 함께 도착하고, 결과는 실행 타임라인에 표시됩니다.

네. 각 노드는 프로젝트든 글로벌이든 Skills Library의 스킬을 고정할 수 있습니다. 에이전트는 단계를 시작하기 전에 각각을 불러오라는 지시를 받습니다: 리뷰 체크리스트, 배포 런북, 테스트 절차가 에이전트의 기억에 의존하는 대신 매 실행마다 적용됩니다.

네. 에디터는 일련의 그래프 검사를 실행하고 실행을 막는 오류와 경고를 구분합니다. 오류는 실행을 멈춥니다: Start 또는 End 노드 누락, 중복 연결, 같은 조건을 가진 두 연결, 조건끼리 서로 모순되는 연결, 잘못된 팬아웃. 경고는 멈추지 않습니다: 앞뒤에 공백이 붙은 플래그 이름, Start에서 나가는 연결에 붙은 조건, 나가는 연결이 모두 조건부여서 실행이 멈출 수 있는 노드. 둘 다 검사 패널에 나열되고 문제가 되는 연결은 캔버스에서 색이 바뀌므로, 실행을 낭비하기 전에 그래프를 고칠 수 있습니다.

아니요, 의도적으로 막아 두었습니다. 실행이 살아 있는 동안 팀 정의는 MCP 도구에서 오는 쓰기에 대해 동결됩니다: 노드, 엣지, 최대 사이클, 단계 지시사항, 스킬, 검사 명령, 역할, 프로바이더, 모델은 에이전트에게 읽기 전용이고, 실행이 불러온 스킬도 다시 쓸 수 없으며, 팀을 지우고 다시 만드는 방법으로도 동결을 우회할 수 없습니다. 에이전트가 자신을 규율하는 규칙을 고쳐 써서는 안 되기 때문입니다. 인터페이스에서는 언제든 모든 것을 계속 편집할 수 있습니다.

네. 모바일 컴패니언에서 프로젝트의 팀을 시작할 수 있고, 각 단계의 진행 상황을 담은 실행 배너가 표시되며, 지금 작업 중인 에이전트의 터미널에 접근할 수 있습니다. 실행 자체는 여전히 데스크톱에서, 실제 CLI를 통해, 거기서 직접 시작한 것과 똑같이 돌아갑니다.

그 런이 무엇 때문에 실패할지를 물어보세요. 맥락을 놓쳐서 실패할 것 같으면 릴레이입니다. 세션 하나가 모든 역할을 수행하고, 자기 결정을 자신에게 다시 설명하는 일이 없습니다. 스스로에게 동의해서 실패할 것 같으면 팀입니다. 역할들이 별개의 에이전트로 돌아가므로, 코드를 검토하는 쪽은 그 코드를 쓴 쪽이 아닙니다. 릴레이가 기본값인 이유는 이 설정이 생기기 전에 만들어진 모든 팀이 이미 그렇게 돌기 때문이지, 더 낫기 때문이 아닙니다.

아니요. 동료는 처음 필요해진 순간에 시작합니다. 그래프가 그 단계에 도달했거나 다른 에이전트가 메시지를 보냈기 때문입니다. 그래서 네 역할짜리 팀이 둘에게만 해당하는 질문 하나에 네 세션을 태우지 않습니다. 단계가 작업을 넘겼고 런이 더 이상 그 단계로 돌아올 수 없으면, 메모리를 아끼기 위해 그 콘솔은 절전 상태가 되고, 누군가 메시지를 보내면 대화를 그대로 간직한 채 깨어납니다. 이후 사이클에서 다시 호출된 역할은 앞서 답했던 바로 그 에이전트입니다. 단, 단계가 작업을 넘기면 콘솔을 닫는 팀 옵션을 켜면 처음부터 새로 시작합니다.

읽을 수 있는 것만 압니다. 런 도중 합류한 동료는 자기 세션을 갖고 그 작업에 대한 기억이 없으며, 바로 그 점 때문에 그 의견에 값어치가 있습니다. 공유 메모, 런 타임라인, 런이 시작된 이후의 git diff로 따라잡고, 이 모두를 자기 도구로 직접 읽습니다. 그 읽기가 이 모드의 대가이고, 릴레이 모드가 여전히 남아 있는 이유입니다.

네, 그게 기본값입니다. 자유로운 대화를 끄면 동료는 그래프에서 자기 노드가 가리키는 역할에게만 쓸 수 있어서, 다른 쪽에 부탁해 게이트를 우회할 수 없습니다. 진짜 팀을 원할 때 켜세요. 누구나 누구에게나, 어느 방향으로든, 여러 명에게 동시에 쓸 수 있습니다. 어느 쪽이든 그래프가 런을 시작하고 끝내는 것은 그대로입니다.

네. 트리거는 에이전트 하나 대신 팀을 가리킬 수 있어서, 같은 파이프라인이 사람 없이 돌아갑니다. 달력의 리듬으로, AI 요금제의 할당량 기간으로, 또는 GitHub, GitLab, Slack, Linear, Sentry나 당신의 CI가 보낸 이벤트로. 프롬프트는 팀의 첫 단계로 가고, 런은 다른 런과 똑같이 당신 자신의 기기에서 일어나며, 트리거 기록에 쌓이고, 시작했다는 알림이 옵니다. 트리거는 프로젝트의 트리거 패널, 예약 작업 바로 옆에 있습니다.

당신을 기다립니다. 런을 마무리하면 커밋하고, worktree를 병합하고, 티켓을 닫게 되는데, 마지막 단계가 아직 작업을 되돌려 보낼 수도 있기 때문입니다. 굳이 다시 돌아오고 싶지 않다면 팀 설정에서 '비활성 후 완료'를 켜고 대기 시간을 고르세요(30분이 제안되며 최대 24시간). 런이 End에 있고 어떤 단계도 그 시간 동안 작업하지 않으면, AgentsRoom이 런을 마무리하고 콘솔을 해제합니다. 아무도 그 작업을 확인하지 않았으므로, 보드에 '검토 중' 열이 있으면 티켓이 그 열로 이동하고(없으면 '완료'로), 런이 자동으로 끝났다는 메모가 남습니다. 아직 작업 중이거나 당신의 답을 기다리는 런은 절대 취소하지 않으며, 기본값은 꺼짐입니다.

네. Wait for me 단계에서 결과마다 하나씩 조건부 연결을 그으세요. 예를 들어 approved = true는 Deploy로, approved = false는 Dev로 되돌아가게 합니다. 런이 거기서 멈추면 답변 상자의 '당신의 결정' 아래에 그 연결들이 나열됩니다. 고른 것이 자기 플래그를 설정하고, 런은 그 연결을 따라가며, 다음 단계에는 그 결정이 당신에게서 왔다고 전달됩니다. 메모는 선택 사항이 되고, 휴대폰에서도 같은 선택지가 제공됩니다.

네. 설정의 'Dynamic Island'에서 '팀 실행' 아래 '각 팀 실행을 하나의 팀 아이콘으로 표시'를 켜세요. 그러면 각 런이 한 자리만 차지하고, 팀 문장과 상태를 나타내는 점(런이나 그 에이전트 중 하나가 당신을 기다리면 빨간색)이 표시되며, 클릭하면 당신이 필요한 콘솔이 열립니다.