서브에이전트 실행을 감독하는 관측·중단 아키텍처

하위 에이전트가 잘못된 경로로 작업을 시작했는데 완료될 때까지 알 수 없다면, 이미 사용한 시간과 토큰은 되돌릴 수 없다. Claude Code가 포그라운드 서브에이전트의 툴 호출과 결과를 Remote Control로 스트리밍하게 되면서, 멀티 에이전트 운영은 최종 결과만 받는 블랙박스 방식에서 실행을 감독하고 필요할 때 멈추는 방식으로 바뀌고 있다.

같은 파일을 반복해서 조회하거나 도구 실패가 이어지고, 허용한 범위를 벗어나는 접근이 발생하는 일은 조기에 포착할 수 있는 신호다. 이 신호를 볼 수 있어도 실행을 중단할 수 없다면 감독이 아니라 단순한 구경에 머문다.

실행 이벤트를 감독 가능한 형태로 만든다

관측 체계의 출발점은 실행 이벤트 스트림이다. 이벤트 유형, 발생 시각, 서브에이전트 식별자, 상위 작업 상관 식별자를 공통 필드로 고정해야 한다. 자유 형식 로그를 그대로 내보내면 화면 표시와 자동 감지 모두 일관성을 잃는다.

툴 호출은 도구 이름, 핵심 인자 요약, 소요 시간, 성공 여부 정도로 한 줄에 압축해 보여주는 편이 낫다. 인자 전체를 기본 화면에 올리면 화면이 빠르게 넘치고, 사람이 이상 징후를 찾기 어려워진다.

중간 산출물도 기본 노출 범위를 정해야 한다. 파일 변경 diff, 검색 결과 건수, 생성 텍스트 요약 수준까지만 기본으로 제공하고 상세 정보는 요청 시 열 수 있게 한다. 모든 내용을 상시로 펼쳐 두면 민감 정보가 노출될 면적도 함께 커진다.

⤢✕

이상 신호와 중단을 연결하는 운영 설계

동일 도구의 연속 실패, 같은 경로의 반복 조회, 허용 범위 밖 경로 접근, 예산 소진 속도 이상은 규칙으로 정의할 수 있다. 빠른 이벤트 스트림을 사람이 계속 주시하는 방식만으로는 대부분의 신호를 놓치므로, 감지 규칙과 경보 계층이 필요하다.

중단 신호는 감독자에게서 실행 중인 서브에이전트까지 전달돼 다음 툴 호출 전에 멈출 수 있어야 한다. 프로세스를 강제로 종료하는 방식만 사용하면 중간 상태가 정리되지 않은 채 남는다.

멈춘 실행의 결과를 일괄 폐기할 필요는 없다. 중단 시점까지 변경한 내용을 유지할지, 원복할지, 상위 작업으로 전달할지를 정책으로 정한다. 유효한 진척까지 버리게 되면 운영자는 중단 자체를 망설이게 된다.

도입 시 합의할 운영 항목

관측 대상은 도구 호출의 시작과 종료, 파일 변경, 외부 호출, 예산 소모부터 우선 정한다. 내부 단계를 모두 추적하면 이벤트가 늘어나 신호가 잡음에 묻힌다.

기본 화면에 보일 항목과 펼쳐서 확인할 항목을 나누고, 팀 전체의 표기 방식도 통일해야 한다. 표시 방식이 사람마다 다르면 인수인계 시 판단 맥락이 끊긴다.

중단 권한은 역할별로 배정하고, 긴급 중단 경로를 별도로 둔다. 실행 시작자만 중단할 수 있도록 제한하면 담당자가 자리를 비운 동안 낭비가 계속될 수 있다.

연속 실패 횟수, 반복 조회 임계, 허용 경로 범위처럼 이상 판정에 쓰이는 기준은 숫자로 정해 규칙에 넣는다. 모호한 표현만 남아 있으면 경보가 발생하지 않거나 반대로 매번 발생한다. 정당한 반복 작업이 경보를 일으킬 때는 예외 등록 경로로 처리한다. 오탐을 그냥 무시하는 관행이 굳어지면 실제 경보도 함께 넘기게 된다.

도구 구성이 바뀌면 감지 규칙과 표시 항목도 먼저 낡는다. 새 도구가 추가될 때 이벤트 규격을 갱신하고, 감지 규칙과 표시 정보를 주기적으로 점검할 운영 주기가 필요하다.

이벤트 규격, 노출 범위, 마스킹 대상, 중단 권한, 이력 보존 기간은 조직 표준으로 등록할 수 있다. 중단 발생 건수, 이상 감지 정확도, 중단으로 절감된 실행 시간도 정기 보고 항목으로 편성한다.

관측 수준과 실행 통제의 선택

구분	실시간 스트리밍 관측	완료 후 로그 검토
개입 가능 시점	실행 중	없음
전송 부하	큼	작음
낭비 절감	가능	불가
인지 부하	큼	작음
구현 복잡도	큼	작음
사후 분석	가능	가능

실시간 스트리밍은 잘못된 경로를 초기에 발견해 남은 실행 시간과 토큰을 아끼고, 감독자가 맥락을 보며 방향을 교정할 수 있게 한다. 이상 신호에 즉시 경보를 걸 수도 있다. 반면 이벤트 전송과 렌더링에 부하가 들고, 감독자가 화면을 계속 봐야 하며, 스트림 자체가 장애 지점이 될 수 있다.

완료 후 로그 검토는 실행 부담이 작고 필요한 시점에만 확인하면 되며 구현도 단순하다. 하지만 발견은 항상 사후에 이뤄진다. 잘못된 산출물이 이미 하류로 전달됐을 수 있고, 긴 작업일수록 손실도 커진다. 중요 작업만 스트리밍으로 감독하고 나머지는 이상 신호 경보와 사후 로그로 처리하는 등급 구분은 부하와 통제를 절충하는 방법이다.

중간 중단은 잘못된 방향을 확인한 즉시 자원 소모를 끊고 감독자의 판단을 실행에 반영할 수 있어 긴 작업에서 특히 유효하다. 다만 파일이나 외부 시스템의 상태가 어중간해져 정합성을 잃을 수 있으며, 부분 결과 처리 정책과 성급한 중단에 대한 대응이 필요하다.

완주 후 폐기는 상태가 완결돼 정합성 문제가 없고, 완성된 결과를 기준으로 판단할 수 있다. 대신 잘못된 실행에도 끝까지 자원을 쓰고 결과를 버리게 된다. 외부 부작용이 없는 구간에서만 중단을 허용하고, 부작용 구간은 완주시키는 경계 설정이 절감과 정합성을 함께 지킨다.

전체 이벤트를 노출하면 인자와 결과를 그대로 볼 수 있어 진단력과 사후 재현성이 높다. 그러나 사람이 읽기 어려울 정도로 화면이 빠르게 흐르고, 민감 정보의 노출 면적과 저장 용량이 커진다. 요약 노출은 흐름과 이상 패턴을 파악하기 쉽고 저장 부담이 작지만, 원인이 요약에서 빠진 항목에 있을 때 추적이 끊길 수 있다. 기본 화면은 요약으로 두고, 필요할 때 원본을 조회하는 계층형 노출이 두 방식의 부담을 관리한다.

운영 통제와 품질 관리에 연결되는 지점

중단 권한 배정과 긴급 중단 경로는 시스템 운영의 통제 권한 체계에 해당한다. 부분 결과 처리 정책은 실행 중단 시 상태 정합성을 유지하기 위한 절차다.

이벤트 스트림 규격과 이상 감지 규칙은 감시 대상을 정의하고 임계를 설정하는 활동이다. 오탐 대응 절차는 경보 운영 품질을 관리하는 수단이 된다.

중간 산출물을 관측하면 결과가 완성되기 전에도 검증할 기회가 생긴다. 이력 보관은 사후 검토와 개선의 근거를 확보하는 요건이지만, 실시간 스트림과 보관 이력은 분리해야 한다. 이력에는 보존 기간과 접근 권한을 정하고, 중간 산출물을 무기한 보관하지 않는다. 이력은 빠르게 커지며 민감도도 높다.

실행 스트리밍이 기본 기능이 될 때

서브에이전트 실행 스트리밍은 에이전트 도구의 기본 기능으로 편입되는 방향이다. 이상 신호 자동 감지는 사람 감독을 대체하지 않지만, 경보 계층으로 정착하는 흐름이 나타나고 있다.

중단 시 부분 결과를 어떻게 처리할지에 대한 규약도 오케스트레이션 표준의 한 항목으로 다뤄지는 방향이다. 중간 산출물 마스킹은 규제 대응 요건으로 요구되며 기본값이 되는 흐름이다.

관측은 실행 기록을 남기는 기능에 그치지 않는다. 이벤트 규격, 요약 표시, 이상 감지, 중단 전달, 부분 결과 처리와 마스킹을 함께 설계해야 실제 개입 수단으로 작동한다. 마스킹 없이 중간 산출물을 스트리밍하면 감독을 얻는 대신 자격 증명 노출 면적을 넓히게 되며, 그 손실은 관측 화면만으로는 드러나지 않는다.