세션 재개

언제 쓰나

작업을 중단했다가 이어서 하고 싶을 때

---
description: ~/.claude/session-data/에서 가장 최근 세션 파일을 로드하고 마지막 세션이 끝난 지점부터 전체 컨텍스트로 작업을 재개합니다.
---

# Resume Session 명령어

마지막으로 저장된 세션 상태를 로드하고 작업을 시작하기 전에 완전히 방향을 잡습니다.
이 명령어는 `/save-session`의 상응하는 명령어입니다.

## 언제 사용해야 하나요

- 이전 날부터 작업을 계속하기 위해 새 세션을 시작할 때
- 컨텍스트 제한으로 인해 새 세션을 시작한 후
- 다른 소스에서 세션 파일을 인계받을 때 (파일 경로만 제공하세요)
- 세션 파일이 있고 Claude가 진행하기 전에 완전히 흡수하기를 원할 때

## 사용법

```
/resume-session                                                      # ~/.claude/session-data/에서 가장 최근 파일을 로드합니다.
/resume-session 2024-01-15                                           # 해당 날짜의 가장 최근 세션을 로드합니다.
/resume-session ~/.claude/session-data/2024-01-15-abc123de-session.tmp  # 현재 짧은 ID 세션 파일을 로드합니다.
/resume-session ~/.claude/sessions/2024-01-15-session.tmp               # 특정 레거시 형식 파일을 로드합니다.
```

## 프로세스

### 단계 1: 세션 파일 찾기

인수가 제공되지 않은 경우:

1. `~/.claude/session-data/`를 확인합니다.
2. 가장 최근에 수정된 `*-session.tmp` 파일을 선택합니다.
3. 폴더가 없거나 일치하는 파일이 없으면 사용자에게 다음을 알립니다:
   ```
   ~/.claude/session-data/에서 세션 파일을 찾을 수 없습니다.
   세션 종료 시 /save-session을 실행하여 파일을 생성하세요.
   ```
   그런 다음 중지합니다.

인수가 제공된 경우:

- 날짜처럼 보이면 (`YYYY-MM-DD`), 먼저 `~/.claude/session-data/`를 검색하고, 그런 다음 레거시
  `~/.claude/sessions/`에서 `YYYY-MM-DD-session.tmp` (레거시 형식) 또는
  `YYYY-MM-DD-<shortid>-session.tmp` (현재 형식)와 일치하는 파일을 검색하여
  해당 날짜의 가장 최근 수정된 변형을 로드합니다.
- 파일 경로처럼 보이면 해당 파일을 직접 읽습니다.
- 찾을 수 없으면 명확하게 보고하고 중지합니다.

### 단계 2: 전체 세션 파일 읽기

파일 전체를 읽습니다. 아직 요약하지 마세요.

### 단계 3: 이해 확인

정확히 이 형식으로 구조화된 브리핑으로 응답하세요:

```
SESSION LOADED: [파일의 실제 해결된 경로]
════════════════════════════════════════════════

PROJECT: [파일의 프로젝트 이름 / 주제]

WHAT WE'RE BUILDING:
[자신의 말로 2-3 문장 요약]

CURRENT STATE:
PASS: Working: [항목 수] 개 확인됨
 In Progress: [진행 중인 파일 목록]
 Not Started: [계획되었지만 아직 시작되지 않은 항목 목록]

WHAT NOT TO RETRY:
[실패한 접근 방식과 그 이유를 모두 나열하세요. 이것이 중요합니다]

OPEN QUESTIONS / BLOCKERS:
[차단 사항이나 답변되지 않은 질문 목록]

NEXT STEP:
[파일에 정의된 정확한 다음 단계]
[정의되지 않은 경우: "다음 단계가 정의되지 않았습니다. 시작하기 전에 '시도하지 않은 것들'을 함께 검토하는 것을 권장합니다."]

════════════════════════════════════════════════
계속할 준비가 되었습니다. 무엇을 하시겠습니까?
```

### 단계 4: 사용자 대기

자동으로 작업을 시작하지 마세요. 파일을 만지지 마세요. 사용자가 다음에 무엇을 할지 말할 때까지 기다립니다.

다음 단계가 세션 파일에 명확하게 정의되어 있고 사용자가 "계속" 또는 "예"와 유사한 말을 하면 해당 정확한 다음 단계를 진행합니다.

다음 단계가 정의되어 있지 않으면 사용자에게 어디서부터 시작할지 묻고, "시도하지 않은 것들" 섹션의 접근 방식을 선택적으로 제안합니다.

---

## 엣지 케이스

**동일 날짜에 대한 여러 세션** (`2024-01-15-session.tmp`, `2024-01-15-abc123de-session.tmp`):
해당 날짜의 수정된 파일 중 가장 최근에 수정된 일치하는 파일을 로드합니다. 레거시 ID 없음 형식인지 현재 짧은 ID 형식인지 여부에 관계없이 로드합니다.

**세션 파일이 더 이상 존재하지 않는 파일을 참조하는 경우**:
브리핑 중에 이 사실을 기록하세요 — "경고: 세션에서 `path/to/file.ts`를 참조했지만 디스크에서 찾을 수 없습니다."

**세션 파일이 7일보다 오래된 경우**:
간격을 기록하세요 — "경고: 이 세션은 N일 전 것입니다 (임계값: 7일). 상황이 변경되었을 수 있습니다." — 그런 다음 정상적으로 진행합니다.

**사용자가 직접 파일 경로를 제공하는 경우 (예: 팀 동료로부터 전달받은 경우)**:
읽고 동일한 브리핑 프로세스를 따르세요 — 형식은 출처에 관계없이 동일합니다.

**세션 파일이 비어 있거나 잘못된 형식인 경우**:
보고하세요: "세션 파일을 찾았지만 비어 있거나 읽을 수 없는 것으로 보입니다. `/save-session`을 사용하여 새 파일을 만들어야 할 수 있습니다."

---

## 예시 출력

```
SESSION LOADED: /Users/you/.claude/session-data/2024-01-15-abc123de-session.tmp
════════════════════════════════════════════════

PROJECT: my-app — JWT 인증

WHAT WE'RE BUILDING:
httpOnly 쿠키에 저장된 JWT 토큰을 사용한 사용자 인증입니다.
등록 및 로그인 엔드포인트는 부분적으로 완료되었습니다. 미들웨어를 통한 라우트 보호는 아직 시작되지 않았습니다.

CURRENT STATE:
PASS: Working: 3 items (register endpoint, JWT generation, password hashing)
 In Progress: app/api/auth/login/route.ts (토큰은 작동하지만 쿠키가 아직 설정되지 않았습니다)
 Not Started: middleware.ts, app/login/page.tsx

WHAT NOT TO RETRY:
FAIL: Next-Auth — 사용자 정의 Prisma 어댑터와 충돌하며 모든 요청에서 어댑터 오류 발생
FAIL: JWT용 localStorage — SSR hydration 불일치 발생, Next.js와 호환되지 않음

OPEN QUESTIONS / BLOCKERS:
- cookies().set()이 Route Handler 내에서 작동하나요, 아니면 Server Actions에서만 작동하나요?

NEXT STEP:
app/api/auth/login/route.ts에서 JWT를 httpOnly 쿠키로 설정하세요: cookies().set('token', jwt, { httpOnly: true, secure: true, sameSite: 'strict' }).
그런 다음 Postman을 사용하여 응답에서 Set-Cookie 헤더를 테스트하세요.

════════════════════════════════════════════════
계속할 준비가 되었습니다. 무엇을 하시겠습니까?
```

---

## 참고 사항

- 세션 파일을 로드할 때 절대 수정하지 마세요 — 읽기 전용 기록입니다.
- 브리핑 형식은 고정되어 있으므로 비어 있더라도 섹션을 건너뛰지 마세요.
- "What Not To Retry"는 "None"이라고만 되어 있어도 항상 표시해야 합니다. 놓치기에는 너무 중요합니다.
- 재개 후 사용자는 새 날짜 파일을 생성하기 위해 세션이 끝날 때 `/save-session`을 다시 실행하기를 원할 수 있습니다.

1. 1

   SKILL.md 저장

   아래 버튼으로 복사 → 다음 경로로 저장.

   SKILL.md 복사

   macOSLinuxWindows

   ~/.claude/skills/everything-claude-code-156/SKILL.md경로 복사
2. 2

   호출

   Claude Code 채팅창에서 자연어로 부르면 자동 발동:

   예) 작업을 중단했다가 이어서 하고 싶을 때

   트리거가 안 잡히면 SKILL.md의 description 줄에 더 구체적인 한국어 키워드를 추가해보세요.