docs(docs): 문서를 화면과 용도별 폴더로 재구성
This commit is contained in:
41
docs/ops/07_session_recovery.md
Normal file
41
docs/ops/07_session_recovery.md
Normal file
@@ -0,0 +1,41 @@
|
||||
# 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.md`의 `NEXT` 1순위 확인
|
||||
3. `git show <최근 커밋>`로 세부 diff 확인
|
||||
|
||||
## 커밋 예시
|
||||
|
||||
```text
|
||||
docs(session): 세션 복구 워크플로우와 커밋 템플릿 추가
|
||||
|
||||
맥락:
|
||||
- codex cli 중단 시 작업 맥락 손실을 줄이기 위해
|
||||
|
||||
변경사항:
|
||||
- docs/foundation/06_commit_convention.md 추가
|
||||
- docs/ops/07_session_recovery.md 추가
|
||||
- scripts/session/recover-context.sh 추가
|
||||
|
||||
검증:
|
||||
- bash scripts/session/recover-context.sh
|
||||
|
||||
세션-상태: 복구 문서와 스크립트가 준비됨
|
||||
세션-다음: 다음 기능 커밋부터 동일 포맷 적용
|
||||
세션-리스크: 과거 커밋에는 세션 트레일러가 없음
|
||||
```
|
||||
Reference in New Issue
Block a user