세션이관 선언 — 어디서든·언제든 같은 세션 작업 이어가기

선언일 2026-06-17. 모든 Claude/크라우니코드 세션 공통 프로토콜. SSOT 대장: ~/.claude/knowledge/세션이관대장.psv · 한선씨 코어: ~/CrownyOS/crownyc/libs/세션이관.한선 · 래퍼: ~/.claude/scripts/세션이관.sh

원칙 (이식성 3원칙)

1. 경로는 HOME 상대(~/...)로만 기록한다. 절대경로(/Users/ef/...) 금지. → 사용자폴더명이 달라도(/Users/ef→/Users/다) 로컬 $HOME에 자동 리매핑된다.
2. IP를 매칭에 쓰지 않는다. 접속·동기화는 도메인(*.crowny.org)+게이트웨이+crowny-hub로. 고정IP/사설IP 하드코딩 금지.
3. 세션=주제+잔여작업+매칭파일. 세션ID는 PC-로컬(트랜스크립트용)이지만, 주제·잔여·파일목록은 PC를 넘어 이식된다. 다른 PC에서는 "같은 주제·같은 잔여"로 이어간다.

일상 사용 (한 PC 안)

bash세션이관.sh list                 # 전 세션 잔여작업 + 매칭파일 존재검증(한선씨 엔진)
세션이관.sh resume <ID|키워드>    # 한 세션 재개카드(파일/잔여/재개지침)
세션이관.sh record <ID> <주제> <상태> <잔여> "<경로들;구분>" <재개> <문서>   # 기록/갱신(멱등)
세션이관.sh portable <절대경로>   # 절대경로 -> ~ 상대

• 별칭 권장: alias 세션='~/.claude/scripts/세션이관.sh'

다른 컴퓨터로 이어가기 (사용자폴더명/IP 달라도)

bash# [원본 PC] 매칭파일 전체를 HOME상대 번들로 묶기 (대장+코어 동봉)
세션이관.sh bundle ~/세션번들.tgz

# 번들을 대상 PC로 전송 (crowny-hub / scp / USB 등 — 외부CDN/Cloudflare 안씀)

# [대상 PC] 자기 $HOME에 풀기 → 사용자폴더명 자동 리매핑
세션이관.sh restore ~/세션번들.tgz          # 기본 $HOME
세션이관.sh restore ~/세션번들.tgz /Users/다  # 대상 HOME 지정 가능

# [대상 PC] 복원 검증 → 누락 0이면 즉시 이어작업
세션이관.sh list

검증 완료: /Users/ef 번들 → /tmp/다른PC-홈 복원 시 한선씨 엔진이 19개 파일 전부 새 HOME으로 리매핑·[OK] 확인.

원격 동기화

bash세션이관.sh sync "메모"   # 대장+문서를 crowny-hub로 커밋 + handover 기록
세션이관.sh pull          # 다른 PC 수신 절차 안내
crowny-hub context        # 이전 세션 인수인계 확인

세션ID 주의

• claude --resume <세션ID>는 원본 PC에서만 대화 컨텍스트까지 복원(트랜스크립트가 그 PC에 있음).
• 다른 PC에서는 트랜스크립트가 없으므로 대장의 주제+잔여+문서+매칭파일로 "같은 작업"을 이어간다(컨텍스트는 문서로 대체). 이게 이식의 정의.

새 세션을 대장에 올리는 습관

의미있는 작업을 하는 세션은 종료 전 세션이관.sh record ...로 한 줄 등록 → 다음에 어느 PC서든 list로 잔여 확인. (docs.crowny.org 문서화 규칙과 병행)