Session Persistence

Session Persistence (v1.2)

개요

v1.2부터 KIP 큐는 프로젝트 루트의 .kip.json 파일에 자동 저장됩니다. 새 세션을 시작해도 이전 큐가 그대로 복원됩니다.

---

동작 방식 (Hook-Driven)

읽기 (자동)

kip-hook.js가 UserPromptSubmit 훅으로 매 프롬프트마다 실행됩니다:

1. .kip.json을 프로젝트 루트에서 읽음
2. 큐 내용을 [KIP] 접두사로 컨텍스트에 주입
3. 사용자 메시지에서 EN/KR 지연 의도 신호 감지
4. 캡처 필요 시 리마인드 메시지 주입

→ 세션 시작 시 수동으로 읽을 필요 없음

쓰기 (Core Rule #6)

큐가 변경될 때마다 Write tool로 .kip.json을 저장합니다:

이벤트	동작
캡처	새 항목 추가 후 전체 큐 저장
kip done {x}	항목 제거 후 전체 큐 저장
kip! {x}	처리 후 항목 제거, 전체 큐 저장
kip clear	{"queue": []} 저장
오버플로우 퇴출	퇴출 후 전체 큐 저장

---

파일 형식

{
  "queue": [
    {
      "label": "test",
      "original": "auth 끝나면 테스트도 추가해야 하는데",
      "condition": "⊕",
      "context": "auth"
    },
    {
      "label": "docs",
      "original": "나중에 문서 업데이트 해야 함",
      "condition": "⚑",
      "context": ""
    }
  ]
}

---

주의사항

• .kip.json은 .gitignore에 추가 권장 — 개인 작업 상태이므로
• 파일이 깨지면 빈 큐로 자동 복구
• 전체 파일 재작성 (atomic write) — append 아님