Files
viberoom-web/docs/07_session_recovery.md
corpi 583837fb8d docs(session): 커밋 메시지 한국어 규칙을 명시
맥락:

- 커밋 메시지는 한국어로 작성해야 한다는 팀 규칙을 문서와 템플릿에 반영하기 위해

변경사항:

- docs/06_commit_convention.md에 한국어 작성 필수 규칙 추가

- docs/07_session_recovery.md의 커밋 예시를 한국어로 교체

- .gitmessage-session.txt 템플릿 본문 항목을 한국어로 변경

검증:

- 변경 파일 수동 검토

세션-상태: 한국어 커밋 규칙과 템플릿이 반영됨

세션-다음: 기능 커밋에도 동일한 한국어 템플릿을 적용

세션-리스크: 기존 과거 커밋 메시지는 영어가 포함될 수 있음
2026-02-27 13:28:57 +09:00

1.2 KiB

07. Session Recovery

결론

커밋 이력 기반 복구는 가능하다.
다만 커밋만 의존하면 "왜/다음 할 일/리스크"가 누락되기 쉬우므로 아래 하이브리드 방식을 기본으로 쓴다.

권장 방식 (Hybrid)

  1. 커밋 메시지: Conventional + 세션 트레일러(한국어)
  2. 상태판: docs/90_current_state.md 유지
  3. 복구 커맨드: npm run session:recover

이 3가지를 함께 쓰면, 새 세션에서 3~5분 안에 맥락 복구가 가능하다.

복구 절차

  1. npm run session:recover
  2. docs/90_current_state.mdNEXT 1순위 확인
  3. git show <최근 커밋>로 세부 diff 확인

커밋 예시

docs(session): 세션 복구 워크플로우와 커밋 템플릿 추가

맥락:
- codex cli 중단 시 작업 맥락 손실을 줄이기 위해

변경사항:
- docs/06_commit_convention.md 추가
- docs/07_session_recovery.md 추가
- scripts/session/recover-context.sh 추가

검증:
- bash scripts/session/recover-context.sh

세션-상태: 복구 문서와 스크립트가 준비됨
세션-다음: 다음 기능 커밋부터 동일 포맷 적용
세션-리스크: 과거 커밋에는 세션 트레일러가 없음