Files
viberoom-web/docs/07_session_recovery.md
corpi ecb17a485a docs(session): add restart-safe recovery workflow
Context:

- codex cli 중단 후에도 작업 품질과 맥락을 안정적으로 복구하기 위해

Changes:

- docs/00~07, 90 문서 세트 추가/정리

- commit convention 문서 및 .gitmessage-session.txt 템플릿 추가

- scripts/session/recover-context.sh 추가

- package.json에 session:recover 스크립트 추가

Validation:

- npm run session:recover

Session-State: session recovery docs, template, and script are in place

Session-Next: apply this commit format to feature and refactor commits

Session-Risks: legacy commits before this change do not include session trailers
2026-02-27 13:27:20 +09:00

1.1 KiB

07. Session Recovery

결론

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

권장 방식 (Hybrid)

  1. 커밋 메시지: Conventional + Session trailer
  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): add recovery workflow and commit template

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

Changes:
- docs/06_commit_convention.md 추가
- docs/07_session_recovery.md 추가
- scripts/session/recover-context.sh 추가

Validation:
- bash scripts/session/recover-context.sh

Session-State: recovery docs and script are in place
Session-Next: apply workflow to next feature commit
Session-Risks: legacy commits have no trailers