session-handover v0.5: 크로스 하네스 압축 시맨틱 매트릭스 (Claude Code, Codex, Gemini, Aider
요약
v0.5 버전의 session-handover는 Claude Code, Codex, Gemini 등 여러 AI 도구 간 세션 전달(session handover) 시 발생하는 데이터 손실을 감사하는 기능을 확장했습니다. 이 도구는 크로스 하네스 비교를 통해 어떤 정보가 압축 과정에서 유실되는지, 그리고 상태를 고정해야 하는 '내구성 있는 앵커'를 식별할 수 있게 합니다.
핵심 포인트
- 여러 AI 도구 간 세션 전달 시 데이터 손실을 감사하는 기능 제공
- 크로스 하네스 비교를 통해 압축 과정의 유실 정보 분석 가능
- 도구 사용자가 직접 개발한 CLI 형태로, 경량화된 워크플로우에 적합
- Claude Code와 Codex 등 다양한 도구의 압축 메커니즘을 인식하고 감사함
v0.5 버전의 session-handover (PyPI)는 압축 감사(compaction audit) 범위를 Claude Code에서 제가 세션을 전달하는 모든 하네스(harness)로 확장했습니다.
pip install session-handover를 실행한 후 다음 명령어를 사용합니다:
session-handover compact-matrix
이 명령어는 크로스 하네스 비교 결과를 출력합니다: 무엇이 압축을 유발하는지, 어떤 메커니즘을 사용하는지, 무엇이 살아남는지, 무엇이 손실되는지, 그리고 — 제가 실제로 사용하는 부분인 — 압축이 발생하기 전에 상태를 고정해야 하는 **내구성 있는 앵커(durable anchor)**입니다.
이유 (Why)
v0.2에서는 Claude Code의 /compact가 내구성 있는 항목들을 교체 요약과 비교하여 무엇을 손실하는지 감사했습니다. 하지만 저는 여러 도구 사이를 오가며 작업하는데, 모든 하네스가 다르게 압축합니다. 다른 도구에 전달된 동일한 세션은 서로 다른 것들을 잃습니다:
- Claude Code — 프로젝트 루트의 CLAUDE.md 파일이 디스크에서 재주입됩니다 (rulestack의 연구에서 측정된 8개 중 8개의 압축 사례). 경로 범위 규칙(path-scoped rules)과 중첩된 CLAUDE.md는 일치하는 파일을 다시 읽을 때까지 손실됩니다; 호출된 스킬 본체(invoked skill bodies)는 편집 후에도 오래된(stale) 텍스트와 함께 8개 중 6번 돌아왔습니다.
- Codex CLI — 원격 v2 압축은 암호화된 블롭에 보존된 사용자 메시지를 반환합니다; 로컬 폴백(local fallback)은 모든 어시스턴트 메시지를 삭제하고 요약은
audit-compact는 bare 마커 문자열을 가진 Codex 압축(compaction)을 감지하는 데 사용되었습니다. 이제 이 도구는 실제 체크포인트 형태를 인식합니다: 원격 v1의 **CONTEXT CHECKPOINT** 어시스턴트 메시지, 로컬 폴백 접두사인 "another language model started to solve this problem…", 그리고 type=compaction 응답 항목입니다. 단독 /compact 명령줄은 트리거일 뿐이며, 더 이상 자체적으로 경계를 만들지는 않습니다.
항상과 동일한 경계
여전히 stdlib 전용이며 의존성이 없습니다. 감사(audit)는 절대 중단하지 않습니다 (종료 코드 0; CI의 경우 --fail-on-drop 사용). 추출은 휴리스틱 회상 하한선(heuristic recall floor)이며 매칭은 의미론적(semantic)이 아닌 토큰 오버랩입니다. 매트릭스에서 "community"로 표시된 항목들은 광범위하게 보고되었지만 공식적으로 검증되지는 않았습니다. 신뢰하기 전에 반드시 검증하십시오.
18개의 새로운 테스트가 모두 녹색으로 통과했습니다. 차별점은 이전과 같습니다: 저는 크로스 툴 핸드오버(cross-tool handover) 작성자이지, 스펙 우선 워크플로우(spec-first workflow)를 만든 사람은 아닙니다. SpecWeave가 무거운 프로세스 측면을 처리하며, 이 도구는 압축-차이점 경계(compaction-diff boundary)에 있는 가벼운 CLI로 남아 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Dev.to AI tag의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기