Show GN: 친구들과 Claude Code로 작업할 때 쓰려고 만든 세션 공유 플러그인

claudeSpread: 팀원과 'AI의 작업 문맥(Context)'을 동기화하는 Claude Code 플러그인

"Git이 코드를 공유하게 해준다면, claude-spread는 AI와의 개발 과정과 문맥 자체를 팀원과 공유하게 해줍니다."

최근 로컬 환경에서 Claude Code와 같은 AI 에이전트를 활용하는 개발자가 늘고 있습니다. 하지만 팀 협업 관점에서 보면 큰 문제가 하나 발생합니다. 코드는 Git으로 푸시해서 공유할 수 있지만, AI가 나와 작업하며 파악한 '프로젝트 아키텍처, 코딩 컨벤션, 디버깅 히스토리, 현재 세션의 진행 상황'은 내 로컬 PC에만 갇혀 있다는 점입니다.

claudeSpread는 이 파편화된 AI의 기억과 맥락을 팀원들에게 안전하고 매끄럽게 전달하기 위해 개발된 플러그인입니다.

핵심 협업 유즈케이스 (Core Collaboration Use Cases)

1. 비동기 페어 프로그래밍 (세션 핸드오프)

팀원에게 작업을 인계할 때, 단순히 "여기까지 커밋했어요"라고 말하는 대신, AI의 사고 흐름과 다음 할 일까지 통째로 넘길 수 있습니다.

• 기능 (/claude-spread:distill-share): 현재 세션에서 무엇을 달성했고, 어떤 아키텍처 결정을 내렸으며, 남은 TODO는 무엇인지 Claude가 자동으로 구조화된 마크다운 문서로 요약(Distill)하여 공유합니다.
• 효과 (/claude-spread:distill-receive): 인계받은 팀원의 Claude는 이 요약본을 읽고 즉시 상황을 파악하여, "요약 데이터를 받았습니다. 이어서 어떤 작업을 진행할까요?"라며 이전 작업자의 흐름을 끊김 없이 이어갑니다.

2. 새로운 팀원 온보딩 (프로젝트 메모리 동기화)

기존 팀원들이 Claude와 작업하며 축적한 프로젝트 전용 지식을 새로운 팀원에게 단 한 줄의 명령어로 주입할 수 있습니다.

• 기능 (/claude-spread:memory-share): 로컬의 자동 메모리 디렉토리(.claude/projects/.../memory)에 쌓인 패턴, 컨벤션, 노하우를 번들로 묶어 팀원에게 전송합니다. AI가 이 정보들을 한 번 더 정제(Distilled Mode)하여 깔끔한 문서로 만들거나, 전체 원본 파일(--raw)을 그대로 넘겨줄 수도 있습니다.
• 효과 (/claude-spread:memory-receive): 새 팀원의 Claude는 곧바로 해당 프로젝트의 규칙과 히스토리를 이해한 상태에서 코딩을 시작하게 됩니다.

3. 리모트 환경의 팀원과도 완벽한 호환

• 사내망(LAN) 모드: 사무실 안에서는 mDNS(Bonjour/Avahi)를 이용해 Zero-config로 팀원을 자동 발견하고 P2P로 즉시 전송합니다.
• 원격(Relay) 모드: 재택근무 중이거나 외부 네트워크에 있는 팀원과는 --relay 옵션을 사용하여 6자리 룸 코드(Room code)를 통해 방화벽을 우회하여 연결합니다.

팀의 코드를 보호하는 강력한 보안 (Security)

사내 프로젝트의 컨텍스트(코드 요약, 구조 등)를 외부 서버를 거쳐 팀원에게 보낸다는 것에 보안 우려가 있을 수 있습니다. claudeSpread는 종단간 암호화(E2E Encryption) 로 이 문제를 해결했습니다.

• 전송되는 모든 데이터는 공유된 Passphrase(비밀번호)를 기반으로 AES-256-GCM 암호화가 적용됩니다.
• Challenge-response (HMAC) 방식의 인증을 거쳐야만 데이터를 복호화할 수 있습니다.
• 원격 모드에서 사용되는 WebSocket Relay 서버는 패킷을 단순 전달(Dumb Pipe)만 할 뿐, 비밀번호를 알 수 없어 데이터를 절대 해독할 수 없습니다. (조직 내부에 자체 릴레이 서버를 구축하는 것도 매우 쉽습니다.)