환경 이전 센터

ClinicOS의 최초 핸드오프와 기존 개발환경 이전을 한곳에서 안내합니다. 두 흐름은 목적과 패키지를 만드는 주체가 다르지만, 새 환경에서 계정을 다시 연결하고 실제 동작을 검증한 뒤 승인한다는 원칙은 같습니다.

다운로드만으로 완료되지 않습니다. 새 환경의 GitHub·Cloudflare·선택한 메인 에이전트 연결과 사이트 검증을 통과한 뒤 최종 승인해야 합니다.

1. 최초 핸드오프

제작팀이 운영 배포, 브랜드 자산, 콘텐츠, 지도, 데이터 연결 상태를 검사하고 인수 패키지를 ClinicOS HQ에 올립니다. 클라이언트는 HQ 환경 이전 센터에 표시된 명령으로 패키지를 내려받습니다.

인수 후에는 다음 항목을 클라이언트 본인 계정으로 연결합니다.

자동 검증이 끝나면 환경 이전 센터에서 최종 인수 승인을 진행합니다.

일반 ZIP이나 공개 다운로드 링크를 만들지 않습니다. 기존 환경의 에이전트가 전송 가능한 코드와 로컬 상태만 선별하고, 비밀정보를 제외한 뒤 AES-256-GCM 암호화 일회용 묶음을 HQ에 업로드합니다.

에이전트에게 다음처럼 요청합니다.

환경 이전 센터로 새 컴퓨터 이전을 준비해줘.

에이전트가 내부적으로 다음 절차를 실행합니다.

npm run workspace:transfer

30분 동안 유효한 전송 코드가 한 번만 표시됩니다. 이 코드는 인수 비밀값과 복호화 키를 포함하므로 비밀번호처럼 취급합니다.

새 환경에서 프로젝트를 연 에이전트에게 다음처럼 요청합니다.

기존 환경에서 받은 전송 코드로 개발환경을 인수하고 끝까지 검증해줘.

에이전트는 대상 폴더, 도구, 디스크, Cloudflare 접근 권한을 먼저 검사한 뒤 다음 인수 절차를 실행합니다.

npm run workspace:claim

전송 코드는 화면에 보이지 않는 입력창에 붙여 넣습니다. 명령 인자, 파일, 채팅 로그에 기록하지 않습니다. 대상은 같은 사이트의 owner 또는 workspace_move 권한을 가진 장치여야 합니다.

새 환경에서 코드, 바인딩, 선택한 로컬 상태와 비밀정보 재인증을 확인합니다. 대상 검증이 완료된 뒤에만 기존 환경에서 다음 절차로 이전을 확정합니다.

npm run workspace:transfer -- --finalize

이 시점에 새 설치가 활성화되고 기존 설치 권한이 종료됩니다. 검증 전에는 기존 컴퓨터를 초기화하거나 접근 권한을 해제하지 않습니다.

전송 코드가 노출되었다고 의심되면 사용하지 말고 기존 환경의 에이전트에게 즉시 취소와 새 전송 생성을 요청하세요.

일회용 코드를 무작정 다시 소비하지 않습니다. 에이전트가 저장된 인수 상태를 진단한 뒤 재개·재시도·취소 중 하나를 선택합니다.

npm run workspace:claim -- --resume
npm run workspace:claim -- --retry
npm run workspace:claim -- --revoke

--retry는 실패한 대상 폴더를 삭제하지 않습니다 , 같은 위치에 <대상 폴더>.partial-<전송 ID> 이름으로 옮겨 보존한 뒤 새로 받습니다. 실패한 폴더 안의 내용을 확인하거나 옮겨 담아야 한다면 재시도 전에 먼저 살펴보세요.

문제가 계속되면 기존 환경을 보존한 채 오류 문구와 전송 상태만 지원팀에 전달하세요. 전송 코드 자체는 전달하지 않습니다.

관련 실행 기준은 에이전트 내장 environment-transfer 스킬과 workspace-migrate 절차가 관리합니다.