save-session

---

name: save-session description: 현재 세션 상태를 docs/sessions/에 저장해서 다음 세션이 완전한 컨텍스트로 이어갈 수 있게 한다. /save로 호출. 컨덕터 워크스페이스 컨텍스트 리셋이나 문맥 한계 직전에 필수. origin: affaan-m/everything-claude-code@4e66b28 (commands/save-session.md, 275→110줄 압축) adapted: 2026-04-24 (school_back: docs/sessions/ 경로, 한국어 템플릿)

/save — 세션 상태 저장

이번 세션에서 일어난 모든 것(만든 것, 작동한 것, 실패한 것, 남은 것)을 날짜 파일로 기록해서 다음 세션이 정확히 이어갈 수 있게 한다.

언제 사용

• 작업 세션 종료 직전 (Claude Code 닫기 전)
• 컨텍스트 한계 근접 시 → 먼저 /save 후 새 세션
• 복잡한 문제를 해결한 직후
• 워크스페이스 전환 / 컨텍스트 핸드오프 필요 시

SDD와의 차이

• /sdd status: 공식 워크플로우 단계(1~5) 진행 상태
• /save: 자유형 작업 메모 — 디버깅, 연구, 시도했다가 실패한 것, 미확정 결정

서로 보완재다. SDD 중간이어도 /save는 가능.

실행 순서

1. 컨텍스트 수집

파일 쓰기 전에 모으기:

• git status / git diff 로 변경된 파일 전부 확인
• 이번 세션 대화에서 무엇이 논의·시도·결정됐는지 복기
• 마주친 에러와 해결(혹은 미해결) 여부
• 현재 test/build 상태

2. 저장 폴더 확인

mkdir -p docs/sessions

3. 세션 파일 작성

경로: docs/sessions/YYYY-MM-DD-<slug>.md

slug 규칙: 소문자 + 숫자 + 하이픈, 8자 이상 권장 (예: race-toctou-fix, onboarding-flow-v2). 당일 충돌 방지.

4. 모든 섹션 정직하게 작성

내용 없는 섹션은 "없음" 또는 "N/A"로 명시. 비어있는 것보다 거짓말이 더 나쁘다.

5. 사용자에게 보여주고 확인 요청

"세션이 docs/sessions/{파일명}에 저장되었습니다. 누락/수정할 부분 있나요?"

---

세션 파일 템플릿

# 세션: YYYY-MM-DD — <주제 한 줄>

**시작 시각:** HH:MM
**마지막 갱신:** HH:MM
**브랜치:** <git branch>
**주제:** <한 줄 요약>

## 무엇을 만들고 있나

<한 단락. 목표와 현재 단계>

## 작동 확인된 것 (증거 포함)

> **할루시네이션 가드**: ✓ 표시 전 증거를 검증한다. 증거는 셋 중 하나로 한정:
>
> - 테스트 출력의 실제 줄 (`pnpm test` 통과 메시지 인용)
> - 커밋 SHA (`git log --oneline -1`)
> - 파일:줄 (구현 위치 + 동작 검증 방식)
>
> 기억 기반("아마 됐을 것", "방금 고쳤음")으로 ✓ 표시 금지. 검증 못 하면 "아직 시도 안 한 것" 또는 "블로커"로 이동.

- ✓ <기능/변경>: <테스트/수동 확인/로그>
- ✓ <기능/변경>: <증거>

## 시도했지만 실패한 것 (이유 명시)

- ✗ <접근>: <왜 실패했나>
- ✗ <접근>: <왜 실패했나>

> 이 섹션이 가장 중요하다. 다음 세션이 같은 실패를 반복하지 않도록.

## 아직 시도 안 한 것

- [ ] <접근/아이디어>: <왜 안 해봤는지>

## 파일별 현재 상태

| 파일                       | 상태    | 다음 할 일          |
| -------------------------- | ------- | ------------------- |
| apps/api/src/router/foo.ts | 수정 중 | input 검증 Zod 추가 |
| apps/web/src/pages/bar.tsx | 완료    | —                   |

## 결정사항

- <결정>: <근거>

## 블로커

- <블로커>: <누구/무엇을 기다리는지>

## 정확한 다음 한 걸음

<다음 세션이 바로 타이핑할 명령 또는 열어야 할 파일:줄>

---

짝이 되는 명령

/resume-session — 가장 최근 세션 파일을 자동 로드해서 어디서 멈췄는지 요약.