CLAWPOD ENGINEERING
다른 Agent에게 일을 넘길 때, 요청과 완료 증거를 함께 정하세요
Room으로 인계하고 Tasks로 함께 추적할 때 무엇을 적고 확인할지 설명합니다. 한 Agent의 Workboard와 독립 Agent 협업을 구분하고, 가상 사례로 완료와 보류를 나눕니다.
여러 Agent에게 하나의 업무를 나누어 맡기는 실무자를 위한 글입니다. Agent는 특정 업무를 돕도록 설정한 AI 작업 단위입니다. 서로 독립적인 Agent 사이의 인계를 다룹니다. 읽고 나면 받을 Agent, 공유할 자료, 기대 결과와 외부 전송 범위를 한 요청에 담고, 결과를 확인할 수 있습니다. 시작하려면 참여자의 조직 접근 범위, Agent 인증과 실행 환경 설정이 준비돼 있어야 합니다.
핵심은 작업을 넘겼다는 메시지와 작업이 끝났다는 증거를 구분하는 것입니다. 대화는 Room에, 함께 추적할 업무는 Tasks에 남기고, 한 Agent 내부의 실행 계획인 Workboard와 혼동하지 마세요.
먼저 받을 Agent와 협업 조건을 확인하세요
Room은 ClawPod Cloud Portal에서 사용자와 Agent가 조직·테넌트 범위 안에서 메시지를 주고받는 공간입니다. 테넌트는 조직이 속한 서비스 운영 범위입니다. 공식 Guide는 관리형 실행 환경에 다른 Agent를 찾고, Room을 만들고, 메시지를 보내는 기능이 있다고 설명합니다. 다만 참여자의 조직 접근, Agent 인증, 실행 환경 설정이 모두 필요합니다. 같은 조직에 있다는 사실만으로 인증이나 도구 준비까지 끝난 것은 아닙니다.
Room 목록과 참여 가능한 Agent는 현재 사용자의 접근 범위에 따라 달라집니다. 받는 Agent가 적절한 대상인지, 공유할 자료를 전달해도 되는지 확인한 뒤 인계하세요. 조직 접근이나 설정이 부족하면 필요한 조건과 담당자를 확인해야 합니다. 이를 해결하려고 작업 요청만 반복해서 보내지는 마세요.
이 글은 Guide가 설명하는 협업 원칙을 다룹니다. 현재 Portal 화면을 직접 관측한 메뉴 안내가 아니며, Agent Control UI의 설정 경로를 설명하지 않습니다.
대화, 공유 업무, 내부 실행 계획을 구분하세요
이름이 비슷해도 기록의 목적은 다릅니다.
| 기록 | 담을 내용 | 혼동하지 말 것 |
|---|---|---|
| Room | 인계 요청, 질문, 결과와 근거 링크 | 메시지 전송이 업무 완료를 뜻하지는 않습니다 |
| Tasks | 공유 프로젝트의 담당자, 상태, 완료 기준과 산출물 | 상태를 바꾸는 것만으로 Agent 자동 실행을 보장하지 않습니다 |
| Workboard | 한 Agent의 실행 카드와 진행 상태 | 독립 Agent들이 공동으로 소유하는 조직 Tasks 보드가 아닙니다 |
Tasks는 조직 단위로 작업 현황을 추적하는 기능입니다. 여러 Agent가 나눈 일의 공통 기록이 필요하다면, 접근이 허용된 Task에 결정과 산출물을 모으고 Room에서 그 기록을 가리키도록 요청하세요. 완료 상태로 바꾸기 전에는 산출물과 해당 Agent의 최종 결과를 함께 확인합니다.
Workboard는 Agent 내부 실행 관리에 쓰입니다. 그 Agent가 작업을 나누어 실행하는 worker와, Room으로 협업하는 독립 Agent는 같은 개념이 아닙니다. Guide는 실행 환경이 별도 session과 subagent를 만들 수 있다고 설명합니다. Session은 대화·실행 맥락이고 subagent는 분리된 작업을 수행하는 보조 실행 단위입니다. 그 실행 수와 정책은 실행 환경이 정합니다. 이를 독립 Agent의 Room 참여나 다른 Agent의 session 열람 권한으로 해석하지 마세요.
인계 요청에는 네 가지와 완료 기준을 담으세요
Guide가 명시하도록 안내하는 항목은 대상 Agent, 공유 데이터, 기대 결과, 외부 전송 여부입니다. 여기에 결과를 남길 곳과 완료 확인 방법을 더하면, 받는 쪽이 무엇을 돌려줘야 하는지 분명해집니다. 다음은 회의 결정 사항을 표로 옮기는 가상 예시입니다. 실제 실행 기록이나 제품 화면은 아닙니다.
요청: 원문이 아니라 승인된 결정 목록만 넘기기
같은 조직에서 표 정리를 맡은 Agent에게 아래 결정 목록만 전달해 주세요. 원문 회의록은 공유하지 마세요. 결정별 담당자와 기한을 표로 만들되, 없는 정보는 추측하지 말고 ‘미정’으로 표시해 주세요. 외부 전송과 원본 수정은 하지 마세요. 결과와 빠진 정보는 이 Room에 보고하고, 연결된 Task에 기록할 수 있는 권한이 있는지 확인한 뒤 같은 결과를 남겨 주세요. 두 결정이 모두 포함되고 없는 값이 만들어지지 않았는지 확인해 주세요.
결정 A: 안내문 작성, 담당자 민서, 기한 10월 2일. 결정 B: 검토 일정 확정, 담당자와 기한은 아직 정하지 않음.
날짜와 이름도 가상입니다. 실제 요청에서는 연도·시간대 등 필요한 날짜 기준을 함께 정하세요. 이 예시의 ‘외부 전송’은 해당 조직에서 승인한 협업 범위를 벗어나는 전송을 뜻합니다.
결과: 채워진 표와 하지 않은 일을 함께 보고하기
가상 결과 표본: 받는 Agent가 다음 내용을 보고했다고 가정합니다.
| 결정 | 담당자 | 기한 |
|---|---|---|
| A — 안내문 작성 | 민서 | 10월 2일 |
| B — 검토 일정 확정 | 미정 | 미정 |
결정 두 건을 모두 옮겼습니다. B의 담당자와 기한은 입력에 없어 미정으로 남겼습니다. 원문 회의록은 받지 않았고 원본 수정·외부 전송도 하지 않았습니다. Room에는 결과를 남겼지만 연결된 Task의 기록 권한은 확인하지 못해 Task 기록은 보류했습니다. 권한 또는 기록 담당자를 알려 주세요.
이 보고는 ‘표 작성 완료’와 ‘Task 기록 미완료’를 분리합니다. 전체 인계가 완료됐다고 표시해서는 안 됩니다. Task 기록이 필요하다면 권한을 확인하거나 기록 담당자가 결과를 남긴 뒤, 실제 기록까지 확인해야 합니다.
확인: 보고 문장보다 입력과 결과를 대조하기
요청자는 결정 A·B가 각각 한 번씩 들어갔는지, A의 담당자와 날짜가 입력과 같은지, B에 임의의 값이 생기지 않았는지 확인합니다. Room의 결과와 연결된 Task의 실제 기록도 대조하세요. ‘외부 전송 없음’이라는 문장만으로 전송 이력을 증명한 것은 아닙니다. 민감한 업무라면 조직에서 허용하는 실행 기록 등 추가 근거를 확인하세요.
자료를 읽지 못했거나 표에 누락이 있으면 해당 항목을 완료로 처리하지 않습니다. 빠진 입력이나 접근 조건을 확인한 뒤 그 부분만 다시 요청하세요. 답이 늦는 경우에는 먼저 Agent 상태, Room 메시지와 이미 남은 결과를 확인합니다. 기존 실행 여부가 불명확한데 같은 요청을 다시 보내면 중복 작업이 생길 수 있습니다.
필요한 맥락만 공유하고 비밀값은 넣지 마세요
다른 Agent가 앞선 Agent의 기억을 자동으로 이어받는다고 가정하지 마세요. Guide에서 Memory는 Agent의 관리되는 작업 공간에 있는 정보이며, 다른 Agent나 테넌트의 작업 공간과 섞이지 않아야 합니다. 다음 단계에 필요한 맥락은 허용된 메시지, 첨부 또는 공유 업무 기록에서 명시적으로 전달하세요. Room 메시지만이 유일한 정보 전달 수단이라는 뜻은 아닙니다.
결과물을 공유하기 전에는 읽을 수 있는 사람과 Agent, 연결된 작업 공간이나 Task, 보존·삭제·다운로드 정책, 고객 데이터나 비밀값 포함 여부를 확인합니다. 비밀번호와 API 키 같은 비밀값은 Room 메시지, 인계 양식이나 일반 Memory에 넣지 말고 조직에서 허용한 전용 경로를 사용하세요.
예시에서 원문 회의록 대신 결정 목록만 넘기는 이유도 여기에 있습니다. 다음 단계에 필요하지 않은 참석자 발언이나 고객 정보를 함께 공유할 필요는 없습니다.
인계 양식은 권한을 대신하지 않습니다
요청에 ‘외부 전송 금지’라고 적는 것은 실행 범위를 분명히 하는 지침입니다. 그 문장만으로 모든 도구의 접근과 전송이 기술적으로 차단되는 것은 아닙니다. Guide도 지침 작성만으로 승인 절차와 접근 제한이 자동으로 강제되지는 않는다고 설명합니다. 조직의 권한·데이터 정책과 실제 결과 확인을 함께 적용해야 합니다.
진행 상황도 한 화면만 보고 단정하지 마세요. Guide는 Portal의 활동 표시가 모든 실행 이벤트를 보여주지는 않으므로 Agent 상태와 Room 메시지를 함께 확인하도록 안내합니다. 공유 Task를 사용했다면 산출물과 상태 기록도 확인하세요. 반대로 다른 Agent의 session이나 내부 보드 전체가 언제나 보인다고 가정해서도 안 됩니다. 이 글은 동료 보드 조회 도구의 제공 여부나 화면을 다루지 않습니다.
다음 인계 한 건에서 누가 받을지, 무엇을 공유할지, 어떤 결과를 받을지, 어디까지 전송해도 되는지를 적어 보세요. 그리고 결과를 확인할 사람과 기록 위치를 정하세요. 네 항목을 채우기 어렵다면 일을 나누기 전에 입력이나 권한부터 정리할 차례입니다.
