# 에이전트 런타임을 옮겨도 역할·기억·승인 경계가 섞이지 않게 한 방법
## 한줄 요약
에이전트 간 역할 이관을 전체 기억 복사가 아니라 역할표, 선별된 안정 정보, 최소정보 handoff, 백업과 새 세션 검증으로 수행하도록 스킬화했다.
## 바쁘시면 이것만 보세요
Persona 파일을 복사했다고 역할 이관이 끝난 것이 아니다. 공유할 가치, 목적지 전용 책임, 안정적 사용자 선호, 절대 옮기지 않을 비밀을 먼저 나눈다. 수정 전 백업을 만들고, 양쪽 새 독립 세션에서 역할과 승인 경계를 다시 말하게 하며, 채널 연결과 실제 Persona 적용을 별도로 판정한다.
## 이런 분께 추천합니다
- 개인 비서와 업무 오케스트레이터의 책임을 나누려는 분
- 에이전트 런타임이나 프로필을 바꾸면서 기억을 선별 이관하려는 분
- 외부 실행 권한이 두 에이전트에 겹치지 않게 하고 싶은 분
## 제작 배경
파일 복사만 하면 오래된 지시와 불필요한 개인 정보까지 따라간다. 두 시스템의 외부 연락·최종 승인 책임도 겹칠 수 있다. 현재 세션은 이전 Persona를 보여줄 수 있어 정보 분류, 승인 경계, 백업, 새 세션 검증을 한 절차로 고정했다.
## 어떤 스킬인가
`cross-agent-role-migration`은 런타임에 독립적인 상위 절차다. 실제 시스템과 파일을 조사하고, 공유 가치·목적지 전용 의무·안정 정보·이관 금지 항목으로 나눈다. `hermes-openclaw-role-migration`은 두 런타임 사이의 구체적인 역할 구조, 지원 도구를 통한 정체성 동기화, 독립 세션 검증, 채널·기능 준비 상태 분리를 보완한다. 둘 다 사용자를 최종 승인자로 두고 외부 행동을 별도 게이트로 유지한다.
## 어떻게 만들었나
먼저 각 시스템의 주 책임, 금지 행동, 도메인별 진실 원천, 사람 승인 항목을 역할표로 만들었다. 전체 대화와 기억을 양방향 복제하지 않고 업무마다 목표, 산출물, 기한, 승인 범위, 검증 요구를 담은 최소정보 요청과 결과 영수증을 정의했다. 수정 전에는 비밀 저장소를 제외한 대상 파일을 그대로 백업하고 무결성 목록을 만든다. 변경 후에는 파일 재확인과 별개로 양쪽 새 세션을 열어 역할을 실제로 읽는지 검증한다.
## 어떻게 사용하는가
1. 대상 런타임·프로필·작업공간과 수정 범위를 확인한다.
2. Persona, 사용자, 기억, 운영 파일과 라우팅 상태를 읽는다.
3. 공유·전용·안정·이관 금지 정보로 분류한다.
4. 중복 소유가 없는 역할표와 승인표를 만든다.
5. 비밀정보를 제외하고 수정 전 백업을 남긴다.
6. Persona와 최소정보 handoff 계약을 보수적으로 수정한다.
7. 지원되는 동기화 도구를 실행한다.
8. 양쪽 새 독립 세션과 기능·채널 상태를 따로 검증한다.
## 검증과 시행착오
파일 내용이 맞아도 런타임이 새 값을 읽지 않을 수 있었다. 그래서 현재 세션이 아닌 새 격리 세션에서 이름, 책임, 상대 에이전트 경계, 승인 행동을 말하게 했다. 채널 상태가 정상이어도 실제 대화가 새 Persona를 채택했다는 증거는 아니며, 일정비서라고 말해도 일정 기능 준비가 끝난 것은 아니다. 이 층들을 하나의 성공으로 합치지 않는다. 부분 완료나 외부 미검증은 조건부 상태로 남긴다.
## 효과 / Before-After
**Before:** 전체 기억 복사와 Persona 문서 수정이 역할 이관으로 간주돼 책임 중복과 비밀정보 전이 위험이 있었다.
**After:** 정보는 최소 범위로 선별되고 두 에이전트의 소유권과 사용자 승인권이 명시된다. 백업과 새 세션 영수증으로 적용과 복구 가능성을 확인한다. 외부 응답이나 기능 준비가 미검증이면 완료로 쓰지 않는다.
## 한계와 중단 조건
자격증명, 결제정보, 전체 대화는 이관하지 않는다. 대상이 불명확하거나 백업이 없거나 역할이 겹치면 중단한다. 외부 메시지·라우팅 변경·재시작·배포는 명시적 승인 없이는 실행하지 않는다.
## 다른 업무에 적용하는 법
팀 업무와 봇 분업에 적용한다. 원문 전체 대신 역할별 최소 사실과 검증 가능한 영수증을 주고받는다.
## 재사용 체크리스트
- [ ] 대상과 비밀정보 제외 범위를 확인했는가
- [ ] 역할과 최종 승인자가 겹치지 않는가
- [ ] 백업과 최소정보 handoff가 있는가
- [ ] 양쪽 새 세션에서 검증했는가
- [ ] 채널·기능·Persona를 분리했는가
