values.md

Session Pod Platform 제품 가치 문서

⚠️ 확인 필요: 제품명("Session Pod Platform")은 임시 작업명이며, 제품 소유자는 아직 미지정입니다. 실제 제품명/소유자에 맞게 수정이 필요합니다.

✅ 확정됨 (2026-07-01, 2026-08-08 갱신): 이전까지 미확정이던 **"세션의 정체"**가 확정되었습니다 — 세션은 전용 pod 안에서 실행되는 하나의 선택된 워크로드입니다. V1~V5는 이 세션을 격리·회수·복원·전환·일관 처리하기 위한 품질 속성입니다. 타입별 구체 명세는 prd/shell-workload.md와 prd/claude-code-workload.md를 참고합니다.

✅ 개정됨 (2026-08-08): 세션 워크로드가 단수에서 복수(타입)로 확장되었습니다. 워크로드 타입은 shell(기본)과 claude-code 두 가지이며, 세션 생성 시 선택합니다(prd/claude-code-workload.md AC-E1). 이에 따라 V2·V3의 동결·복원 메커니즘 서술이 타입 중립으로 바뀌었습니다 — 쉘은 CRIU 체크포인트, 클로드 코드 CLI는 파일시스템 아카이브로 같은 가치를 달성합니다.

📌 갱신 (2026-11-01): CRIU가 모든 워크로드에서 퇴역해 동결·복원 메커니즘은 이제 모든 타입이 파일시스템 아카이브 하나입니다. 타입별로 다른 것은 아카이브가 보존하는 상태뿐이며, 쉘은 사용자 결정으로 그 범위가 홈 디렉터리 파일 + 누적 출력으로 좁아졌습니다(prd/shell-workload.md AC-D4 — 복원된 쉘은 새 쉘). 가치(V2·V3)의 문장은 바뀌지 않았고, 아래 설명의 메커니즘 서술만 갱신했습니다.

📌 개정됨 (2026-08-08, 2차): 워크로드 타입 자체를 가치로 올렸던 V6(인터랙티브 쉘 세션)·V7(클로드 코드 CLI)을 삭제했습니다. "pod 안에서 무엇이 도는가"는 사용자가 얻는 가치가 아니라 그 가치를 제공하는 수단이므로, 가치 문서가 아니라 PRD(prd/shell-workload.md, prd/claude-code-workload.md)에서 다룹니다.

📌 개정됨 (2026-08-08, 3차): V6·V7 삭제로 "워크로드 타입을 고를 수 있다"(AC-E1)를 뒷받침할 가치가 사라져 미연결 AC가 발생했고, 이를 해소하기 위해 V8(목적에 맞는 작업 환경 선택) 을 신설했습니다. V8은 선택할 수 있다는 사실만 가치로 담고, 어떤 환경을 제공하는지와 각 환경의 동작은 계속 PRD 소관입니다 — 이것이 V6·V7과의 차이입니다.

제품 소유자

• [미지정 — 확인 필요] (소유자가 지정되지 않아 모든 가치가 현재 고아 가치 상태입니다. 상태 추적 문서 참고)

제품 가치

V1: 세션 격리

• 유형: 구체적
• 설명: 모든 세션은 전용 data plane pod에서 독립적으로 실행되어, 한 세션의 장애·부하·보안 이슈가 다른 세션으로 전파되지 않는다. (1 세션 = 1 워크로드 pod — AC-A2)

V2: 유휴 자원 회수

• 유형: 구체적
• 설명: 최대 60분 이상 사용되지 않은 세션은 스냅샷으로 동결하고 pod 자원을 회수하여, 활성 세션에만 컴퓨팅 자원을 집중한다. 동결 메커니즘은 모든 워크로드 타입이 같은 파일시스템 아카이브이고(2026-11-01 갱신 — 이전에는 shell만 CRIU 체크포인트였다), 아카이브에 담기는 상태가 타입별로 다르다 — shell은 홈 디렉터리 파일과 출력 버퍼(AC-D4), claude-code는 작업 디렉터리·대화 기록·출력 버퍼(AC-E5), approval-gated는 거기에 공유 볼륨 내용(AC-F5). 회수되는 자원과 관측되는 상태 전이는 타입과 무관하게 동일하다.

V3: 끊김 없는 세션 연속성

• 유형: 추상적
• 설명: 스냅샷으로 동결된 세션도 다시 접근하면 동결 직전 상태 그대로 재개된다. 사용자는 세션이 멈췄다는 사실을 거의 인지하지 못한 채 작업을 이어간다. 복원 메커니즘은 모든 타입이 파일시스템 아카이브이고, "보존되는 상태"의 정체는 워크로드 타입에 따라 다르다 — shell은 홈 디렉터리 파일과 출력 이력(복원된 쉘은 그 홈에서 시작하는 새 쉘이라 실행 중이던 프로세스·환경 변수·cwd는 이어지지 않는다, AC-D4 2026-11-01 개정), claude-code는 아카이브에서 복원한 대화 기록·작업 디렉터리(AC-E5), approval-gated는 거기에 공유 볼륨 파일(AC-F5). 모두 디스크 상태다. 사용자가 보는 연속성(보존 대상 위에서 이어짐, 커서 유효성)은 타입과 무관하게 동일하다.

V4: 자유로운 멀티세션 전환

• 유형: 추상적
• 설명: 사용자는 보유한 여러 세션 사이를 제약 없이 오갈 수 있으며, 전환 대상 세션의 상태(active/idle/snapshot)와 무관하게 일관된 경험으로 접근한다.

V5: 일관된 세션 상태

• 유형: 구체적
• 설명: 세션 상태 전이와 동시 접근은 ConfigMap(resourceVersion CAS) + Lease 기반 atomic operation으로 처리되어, 경쟁 상황에서도 세션 상태가 깨지거나 중복 처리되지 않는다.

V8: 목적에 맞는 작업 환경 선택

• 유형: 추상적
• 설명: 사용자는 세션을 만들 때 자신의 목적에 맞는 작업 환경(워크로드)을 선택할 수 있다. 플랫폼이 제공하는 격리·회수·복원·전환·일관성(V1~V5)은 어떤 환경을 골랐든 동일하게 적용되므로, 사용자는 환경을 바꾸려고 다른 도구나 다른 플랫폼으로 옮겨갈 필요가 없다.
• 비고: 이 가치가 담는 것은 선택 가능하다는 사실과 그 선택이 플랫폼 보장을 훼손하지 않는다는 점뿐이다. 어떤 환경을 제공하는지(현재 인터랙티브 쉘, 클로드 코드 CLI)와 각 환경이 어떻게 동작하는지는 수단이므로 PRD에서 정의한다 — 삭제된 V6·V7은 바로 그 수단을 가치 자리에 올려서 문제였다. 새 워크로드 타입이 늘어나도 이 가치는 그대로 유지된다.

삭제된 가치 (식별자 재사용 금지)

식별자	이름	삭제 시점	사유
V6	인터랙티브 쉘 세션	2026-08-08	워크로드 타입은 가치가 아니라 수단 → prd/shell-workload.md(AC-D1~D5)로 이관
V7	에이전트 세션 — 클로드 코드 CLI	2026-08-08	동일 → prd/claude-code-workload.md(AC-E1~E6)로 이관

변경 이력과 하류 문서(여정·mockup·테스트)가 옛 V6·V7을 그 의미로 참조하므로 두 식별자는 재사용하지 않는다. 새 가치는 V8부터 부여한다.