Holmes LabAgentic Software Engineering Architect

서로 다른 AI CLI 세션의 협업을 어떻게 이어갈까?

검토 요청을 다른 CLI에 보냈는데 답이 없다면 다시 보내도 될까요? 한 번의 설명용 요청을 따라가며 전달·수신·작업 완료의 증거와 불확실할 때의 판단을 분리합니다.

사례판 발행 수정

Bridge의 대상과 제한 확인

사례판 기준: 2026-11-08. 아래 메시지와 상태 변화는 설명용이며 실제 세션의 전달 로그가 아닙니다. 배포 안내는 Agent Bridge 0.1.0-alpha.1의 공개 문서 기준으로 읽어야 합니다. 이번 글 보강을 위해 실제 Claude·Codex·AGY 왕복이나 모델 호출을 새로 실행하지 않았고, 공개 문서에 기록된 제한된 시험을 모든 환경의 지원으로 확대하지 않습니다.

상황: 구현 대신 검토 한 번을 부탁한다면

송신 세션 A가 수신 세션 B에게 인사 함수 변경안을 읽기 전용으로 검토해 달라고 요청한다고 가정합니다. 두 세션이 같은 폴더를 본다는 사실만으로 상대, 대화 또는 권한이 정해지지 않습니다. 실제 세션 등록, canonical workspace, 허용 route를 먼저 확인해야 합니다.

이 사례의 작업 범위는 검토 의견 한 번입니다. 파일 수정·설치·배포·추가 모델 사용 권한을 메시지에서 만들어내지 않습니다. 실제 시험을 할 때는 요청 수, 시간·비용 한도와 종료 조건을 사람이 먼저 정합니다.

전달 상태와 작업 상태를 따로 읽기

아래는 서로 다른 계층의 증거를 비교한 표입니다. completed는 작업 수신 기록의 상태이며 전송 수락 다음에 자동으로 따라오는 보증이 아닙니다. 전송 API 성공을 검토 완료로 표시하면 하지 않은 작업을 완료로 보고하게 됩니다.

한 요청에서 관찰해야 할 서로 다른 사실
계층·상태말할 수 있는 것아직 말할 수 없는 것
전달 · queued대기열에 요청이 있음수신자가 읽었다는 사실
전달 · transport_accepted전송 계층이 수락함에이전트의 수신·작업 완료
전달 · agent_acknowledged수신 측 수신 확인이 기록됨검토가 끝났다는 사실
작업 · completed별도의 작업 완료 기록이 있음결과의 정확성·독립 검증
전달 · delivery_unknown보냈을 수 있으나 결과가 불확실함미전달 확정·안전한 재전송

설명용 메시지와 수신 기록

아래 내용은 읽기 위한 설명용 표기이며 실제 Bridge API 요청 형식이나 실행 로그가 아닙니다. 실제 수신 측은 bridge_inbox로 내용을 읽고 bridge_ack로 확인하며, 작업 완료는 bridge_work_receipt와 결과 내용으로 별도 확인합니다.

설명용 시나리오 · 실제 전달 로그 아님

A → B: 공백·기본값 동작만 검토해 주세요. 파일은 수정하지 마세요.
전달 상태: transport_accepted
B가 inbox를 읽고 수신 확인: agent_acknowledged
B의 보고: 기존 이름 동작과 공백·빈 이름 테스트 검토
별도 작업 기록: completed
A가 보고 내용과 그 검증 근거를 확인합니다.

응답이 없을 때의 불확실성 판단

답이 없다는 사실만으로 미전달을 판단할 수 없습니다. 전달 뒤 응답만 사라졌다면 재전송이 중복 작업을 만들 수 있습니다. 먼저 수신 기록과 상대 세션의 상태를 확인하고, 공식 reconcile 절차가 필요한지 판단합니다.

confirmed_not_sent 같은 판단은 실제 미전달 근거가 있을 때만 검토합니다. 이 판단이 재전송을 유발할 수 있으므로 화면을 진행하기 위해 임의로 선택하지 않습니다. 운영자가 판단할 수 없으면 중지와 미확인 보고가 올바른 결과입니다.

불확실할 때 먼저 확인할 것
관찰다음 판단
transport_accepted만 있음수신 측 inbox·ack를 확인한다
ack는 있지만 검토 결과가 없음작업 상태와 별도 완료 보고를 확인한다
delivery_unknown자동 재전송하지 않고 수신 증거부터 조사한다

현재 배포에서 확인할 범위

기존 첫 사용 안내의 기준은 0.1.0-alpha.1이며 macOS·Node 버전·라이선스 제한이 있습니다. 실제 설치에서는 선택한 릴리스의 공식 README와 설치된 도움말을 대조하세요. Windows/Linux나 관리형 AGY의 지원 범위를 다른 릴리스의 설명에서 가져오지 않습니다.

공개 문서의 제한된 왕복 시험은 장시간 운영, 모든 장애 경계 또는 실제 여러 세션 쌍의 격리를 보증하지 않습니다. Bridge는 exactly-once 원격 실행을 약속하지 않으며, 이 글도 새 호환성 인증이나 릴리스 발표가 아닙니다.

Kit과 함께 쓸 때도 권한은 별도

Kit은 변경의 이유·명세·검증을 연결하고 Bridge는 명시적인 메시지 전달을 다룹니다. Bridge 메시지가 도착했다고 명세가 승인되거나 훅이 활성화되지 않습니다. 수신 작업 역시 그 프로젝트의 실제 사용자 권한과 명세 절차를 따릅니다.

첫 왕복을 시작하기 전 체크리스트

먼저 실행 지시가 없는 인사 한 개로 범위를 좁힙니다. 성공하면 등록·허용 route·수신 확인 근거를 남기고, 종료 후 pause·stop 등 선택한 안내의 정리 절차를 수행합니다. 실제 세션 ID, credential 또는 비공개 경로를 공개 글에 올리지 않습니다.

  • 실제 등록된 수신자와 workspace route를 확인했는가?
  • 사람이 요청 수·시간·비용·종료 조건을 정했는가?
  • 전달 수락과 수신 확인을 따로 기록했는가?
  • 작업 완료 기록과 결과 근거를 확인했는가?
  • 불확실한 전달을 자동 재시도하지 않는가?

출처와 검증

기존 소개글을 사례형으로 확장한 버전입니다. 위 검증 근거와 출처의 버전이 이 글의 확인 범위를 정합니다.

이 자료 공유하기

링크나 소개문을 복사하세요. 외부 서비스에 자동 게시하지 않습니다.

외부 게시용 소개문 초안
서로 다른 AI CLI 세션의 협업을 어떻게 이어갈까?

검토 요청을 다른 CLI에 보냈는데 답이 없다면 다시 보내도 될까요? 한 번의 설명용 요청을 따라가며 전달·수신·작업 완료의 증거와 불확실할 때의 판단을 분리합니다.

https://holmes-lab.web.app/ko/notes/cli-agent-handoff/

다음으로 이어가기