서로 다른 AI CLI 세션의 협업을 어떻게 이어갈까?
검토 요청을 다른 CLI에 보냈는데 답이 없다면 다시 보내도 될까요? 한 번의 설명용 요청을 따라가며 전달·수신·작업 완료의 증거와 불확실할 때의 판단을 분리합니다.
사례판 발행 수정
사례판 기준: 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를 확인했는가?
- 사람이 요청 수·시간·비용·종료 조건을 정했는가?
- 전달 수락과 수신 확인을 따로 기록했는가?
- 작업 완료 기록과 결과 근거를 확인했는가?
- 불확실한 전달을 자동 재시도하지 않는가?
출처와 검증
기존 소개글을 사례형으로 확장한 버전입니다. 위 검증 근거와 출처의 버전이 이 글의 확인 범위를 정합니다.
이 자료 공유하기
링크나 소개문을 복사하세요. 외부 서비스에 자동 게시하지 않습니다.
https://holmes-lab.web.app/ko/notes/cli-agent-handoff/
외부 게시용 소개문 초안
서로 다른 AI CLI 세션의 협업을 어떻게 이어갈까? 검토 요청을 다른 CLI에 보냈는데 답이 없다면 다시 보내도 될까요? 한 번의 설명용 요청을 따라가며 전달·수신·작업 완료의 증거와 불확실할 때의 판단을 분리합니다. https://holmes-lab.web.app/ko/notes/cli-agent-handoff/