세션 종료 (/cs)

워크플로우

사용자가 /cs 또는 "세션 종료"를 요청하면 아래 4단계를 순서대로 수행한다.

사전 준비

1. docs/status/current.md를 읽어 마지막 세션 번호 파악 (다음 세션 번호 = +1)
2. 이번 세션에서 수행한 작업을 대화 히스토리에서 수집
3. 레퍼런스 동기화 검증 (3단계): a. 이번 세션에서 변경된 소스 파일 목록 추출 (git diff --name-only 또는 대화 히스토리) b. 변경된 파일이 도메인 엔티티, enum, 컨트롤러, DTO라면 → 해당 레퍼런스 파일을 Read하여 코드 변경 사항이 반영되어 있는지 확인 → 미반영 시 갱신 c. docs/references/ 내 파일 중 이번 세션에서 직접 수정된 것이 있으면 최신 상태인지 추가 확인

1단계: current.md 세션 요약표 1행 추가

docs/status/current.md의 ## 세션 기록 요약표 테이블 맨 아래에 1행 추가:

| {N} | {YYYY-MM-DD} | {세션 제목 (작업 요약)} | [로그](../logs/{YYYY-MM}.md) | [handover](../handover/{YYYY-MM-DD}-session{N}-{slug}.md) |

• 세션 제목: 핵심 작업을 간결하게 (예: "food 모듈 전체 구현")
• slug: 세션 핵심 키워드 (예: food, medical-api, bug-fix)
• ## 이슈/메모 섹션도 필요 시 업데이트

2단계: logs/ 아카이브에 상세 기록

docs/logs/{YYYY-MM}.md 파일에 상세 기록 추가 (없으면 생성):

### {YYYY-MM-DD} (세션 {N}) — {세션 제목}
- {변경 내용 1}
- {변경 내용 2}
- ...

기존 프로젝트 로그 형식을 따른다. 신규/수정 파일 목록, 주요 변경사항 포함.

3단계: handover/ 인수인계서 작성

docs/handover/{YYYY-MM-DD}-session{N}-{slug}.md 파일 생성:

# 인수인계서 — 세션 {N} ({세션 제목})

> 작성일: {YYYY-MM-DD}
> 이전 세션: [session{N-1}](./이전파일.md)

---

## 작업 요약
{1~2줄 요약}

## 수정 파일 ({개수}개)

| # | 파일 | 변경 내용 |
|---|------|-----------|
| 1 | `path/to/file` | 변경 설명 |

## 상세 변경 사항
### 1. {파일/기능} — {변경 요약}
- 상세 내용

## 검증 결과
- `npx tsc --noEmit` — 에러 {N}개
- (기타 검증 결과)

## 터치하지 않은 영역
- {미수정 영역}

## 알려진 이슈
- {이슈 또는 "없음"}

## 다음 작업 제안
- {제안 사항}

---
[← handover/_index.md](./_index.md)

docs/handover/_index.md에 새 인수인계서 링크 추가 (파일이 있을 경우).

4단계: next-dev-prompt.md 갱신

docs/handover/next-dev-prompt.md의 다음 섹션 업데이트:

• 최근 완료된 작업: 이번 세션 1줄 추가
• 추천 다음 작업: 우선순위 재정렬
• 알려진 이슈 및 주의사항: 해결된 이슈 취소선, 새 이슈 추가
• 기타 변경된 상태 반영 (빌드 상태, 모듈 상태 등)

마무리 체크

• .env, .env.local 파일이 git에 포함되지 않았는지 git status로 확인 (git 초기화된 경우만)
• 모든 4단계 문서가 서로 정합성 있는지 확인 (세션 번호, 날짜, 링크)

5단계: 자동 커밋 & 푸시 (git 연결 시)

git 초기화된 프로젝트에서 리모트가 설정되어 있으면 자동으로 커밋 & 푸시를 수행한다.

1. 리모트 확인: git remote -v로 리모트 존재 여부 확인
   • 리모트 없음 → 이 단계 건너뜀
2. 커밋 대상 확인: git status --porcelain으로 변경사항 감지
   • 변경 없음 → "변경사항 없음, 커밋 생략" 보고 후 건너뜀
3. .env 안전 체크: 스테이징 대상에 .env* 파일이 포함되지 않도록 확인
4. 스테이징: 변경된 파일을 git add로 스테이징 (.env* 제외)
5. 커밋: 세션 내용을 요약한 커밋 메시지 자동 생성
   • 형식: feat: 세션 {N} — {세션 제목} ({변경 파일 수}개 파일)
   • Co-Authored-By 포함
6. 푸시: git push로 현재 브랜치를 리모트에 푸시
   • 업스트림 미설정 시 git push -u origin {branch} 사용
   • 푸시 실패 시 에러 보고 (강제 푸시는 절대 사용하지 않음)

완료 보고

• 4단계 문서 + 커밋/푸시 결과를 사용자에게 요약 보고

관련 스킬/에이전트