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
This commit is contained in:
2026-02-27 13:27:20 +09:00
parent d2be0b866a
commit ecb17a485a
14 changed files with 519 additions and 1 deletions

View File

@@ -0,0 +1,32 @@
# 05. Handoff Checklist
Codex CLI가 중단되거나 컨텍스트가 초기화된 뒤 재개할 때 사용하는 체크리스트.
## 재개 시작 (5분)
1. `docs/README.md`에서 우선 읽기 5개 문서를 순서대로 확인
2. `git status --short`로 작업 트리 상태 파악
3. `docs/90_current_state.md``NEXT` 1순위부터 착수
## 구현 중 체크
1. 뷰 로직 누수 여부 확인 (`page.tsx` 조합 유지)
2. 레이어 import 방향 위반 여부 점검
3. 파일 500줄 초과 여부 점검
4. UI 톤(감성/저자극)과 CTA 위계 유지 확인
## 종료 전 체크
1. 타입체크 또는 빌드 최소 1회 실행
2. 변경 파일 경로/의도 요약 정리
3. `docs/90_current_state.md` 갱신:
- DONE
- NEXT
- RISKS
- CHANGED FILES
## 커밋 단위 가이드
- 1커밋 1의도 원칙
- 구조 변경(FSD)과 스타일 변경(UI)은 가능하면 분리
- 커밋 메시지는 "무엇을 왜 바꿨는지" 중심으로 작성