Skip to main content
블로그로 돌아가기
Mission Control: 개입이 필요한 에이전트를 절대 놓치지 않는 방법
블로그

Mission Control: 개입이 필요한 에이전트를 절대 놓치지 않는 방법

캔버스에서 대여섯 개의 에이전트를 동시에 실행할 때 가장 중요한 질문은 '지금 누가 내 결정을 기다리고 있는가'입니다. Fleet 패널이 상태 분류와 터미널 질문 미리보기로 이 문제를 해결한 방식을 소개합니다.

캔버스 위에서 두 개의 에이전트를 관리하는 것은 쉽습니다. 하지만 그 수가 대여섯 개, 혹은 그 이상으로 늘어나면 이야기가 달라집니다. 무한 캔버스는 본질적으로 공간 기반 레이아웃입니다. 타일은 당신이 배치한 좌표에 자유롭게 흩어져 있습니다. 하지만 다중 에이전트를 지휘할 때 정작 필요한 질문은 "각 타일이 어디에 있는가"가 아니라 **"지금 당장 어떤 에이전트가 내 결정을 기다리며 멈춰 있는가"**입니다.

단순한 공간 레이아웃은 런타임 상태를 대변해주지 못합니다. 결국 개발자는 캔버스를 이리저리 이동하며 타일을 하나씩 육안으로 훑어볼 수밖에 없으며, 에이전트 수가 늘어날수록 이러한 방식은 인지적 과부하를 초래합니다.

이는 단일 에이전트 도구에서 '다중 에이전트 오케스트레이션'으로 넘어가는 순간 마주하는 전형적인 주의력 관리(Attention Management) 문제입니다. 세 화면 떨어진 곳에서 권한 입력을 기다리며 멈춰 있는 프롬프트는, 눈앞의 타일에 집중하는 동안 아무런 존재감을 드러내지 않습니다. 그러다 10분이 지난 뒤에야 중요한 에이전트가 사소한 yes/no 질문 하나에 묶여 공회전하고 있었다는 사실을 뒤늦게 깨닫게 됩니다.

MadoHub의 해법은 **Mission Control (Fleet 패널)**입니다. 이 기능의 세부 설계는 이러한 주의력 관리 문제를 해결하는 데 정확히 맞춰져 있습니다.

MadoHub의 설계 접근법

1. 공간 좌표가 아닌, 상태 우선순위로 그룹화

Mission Control의 핵심 원칙은 공간적 배치를 걷어내고 런타임 상태에 따라 에이전트를 재구성하는 것입니다. 모든 에이전트 타일은 엄격하게 다음 6가지 상태 중 하나로 분류되며, 항상 고정된 우선순위 순서로 렌더링됩니다.

그룹의미인디케이터 색상
Needs input즉각적인 개입 필요 (권한 승인, 질문 대기 등)주황색 (호흡 애니메이션)
Working활발히 실행 중 (도구 실행 또는 토큰 생성)테마 강조색
Done현재 턴 완료 (결과물 검토 대기)녹색
Failed오류 발생 (예외 또는 비정상 종료)경고 적색
Idle대기 중 (실행 중인 작업 없음)저대비 회색
Exited프로세스 종료 (세션 완전히 종료됨)어두운 회색

비어 있는 그룹은 헤더 자체가 숨겨지므로 Failed (0)처럼 불필요한 시각적 노이즈가 남지 않습니다. 정렬 순서 자체가 하나의 **트리아지 프로토콜(Triage Priority)**입니다. 권한 확인 프롬프트에 10분째 멈춰 있는 에이전트가 가장 상단에 위치하고, 순조롭게 작업 중인 에이전트와 이미 완료된 에이전트가 그 뒤를 잇습니다. 목록을 위에서부터 차례대로 확인하기만 하면 에이전트 플릿 전체의 작업 흐름이 원활하게 유지됩니다.

패널이 접혀 있을 때의 배지 숫자도 단순한 전체 타일 수가 아닙니다. 입력을 기다리는(Needs Input) 타일의 개수를 주황색 배지로 최우선 표시합니다. 이는 지금 하던 일을 잠시 멈추고 살펴볼 가치가 있는 유의미한 인터럽트 신호입니다. 모든 타일이 정상 작동 중일 때에만 전체 실행 수가 은은하게 표시됩니다.

2. 터미널 출력 끝단 노출: 질문의 본질을 즉시 확인

상태 그룹화는 에이전트가 입력을 기다리고 있다는 사실만 알려줄 뿐, 구체적으로 무엇을 묻고 있는지까지는 알려주지 못합니다. 만약 질문을 읽기 위해 매번 해당 타일로 화면을 이동해야 한다면 통합 패널의 실효성이 크게 떨어집니다.

Mission Control은 이 간극을 메웁니다. Needs Input 그룹의 각 항목 아래에는 해당 타일 터미널의 마지막 출력 줄이 깔끔한 주황색 테두리 블록으로 직접 표시됩니다. 대개의 경우 (y/n) 선택지나 Allow once / Allow always / Deny 같은 구체적인 질문이 바로 나타납니다.

이것은 "에이전트 3이 대기 중"이라는 모호한 알림과 "에이전트 3이 rm -rf node_modules 실행을 요청 중"이라는 구체적인 정보를 아는 것의 결정적인 차이입니다. 후자의 경우 패널을 벗어나지 않고도 머릿속에서 즉시 승인 여부를 판단할 수 있어 불필요한 컨텍스트 스위칭 비용을 없애줍니다.

3. 원클릭 캔버스 뷰포트 이동

특정 에이전트에 개입하기로 결정했다면, 패널에서 해당 항목을 클릭하기만 하면 됩니다. 캔버스 뷰포트가 해당 타일로 즉시 부드럽게 이동하고 확대됩니다. 패널의 목록에서 실제 타일의 터미널 화면까지 단 한 번의 클릭으로 도달할 수 있어, 넓은 캔버스에서 타일을 찾아 헤맬 필요가 없습니다.

4. Dynamic Workflows 진행 상황 집계

Claude Code 등에서 단일 세션이 여러 동시 서브에이전트로 분기될 때, MadoHub은 서브에이전트마다 별도의 알림을 난사하는 대신 부모 타일 아래에 컴팩트한 진행 상황 표시줄로 집계합니다.

workflow · 3/5 agents

이 표시는 5개의 서브에이전트 중 3개가 완료되었음을 뜻합니다. 복잡한 멀티 프로세스의 현황을 명확히 전달하면서도 모니터링 화면이 무수히 많은 배지로 뒤덮이는 것을 방지합니다.

실무 가이드라인

  • 상단부터 순서대로 확인하세요: Needs input 항목을 먼저 해소하여 병목을 없앤 뒤 Working과 Done을 검토하세요.
  • 질문 미리보기를 활용하세요: 터미널 미리보기에 표시된 질문이 단순 읽기 권한 등 통상적인 내용이라면, 마음속으로 승인을 결정한 뒤 타일로 이동해 바로 진행할 수 있습니다.
  • 접힌 배지를 인터럽트 트리거로 삼으세요: 주황색 숫자가 뜰 때만 패널을 열어 확인하세요. 숫자가 0이라면 현재 코딩 작업에 온전히 몰입하셔도 좋습니다.
  • 일반 셸은 제외됩니다: 단순 명령어 실행을 위한 일반 터미널 타일은 Mission Control에 표시되지 않으며, 오직 AI 에이전트 CLI만 집중적으로 관제됩니다.

여러 에이전트의 진행 상태를 개발자의 기억에 의존하지 않고 시스템에 온전히 맡기는 것—이것이 Mission Control의 존재 이유입니다.

관련 문서