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

46
docs/03_routes_map.md Normal file
View File

@@ -0,0 +1,46 @@
# 03. Routes Map
## 라우트 개요
- `/` -> `src/app/(landing)/page.tsx`
- `/login` -> `src/app/(auth)/login/page.tsx`
- `/app` -> `src/app/(app)/app/page.tsx`
- `/space` -> `src/app/(app)/space/page.tsx`
- `/stats` -> `src/app/(app)/stats/page.tsx`
- `/settings` -> `src/app/(app)/settings/page.tsx`
## 주요 라우트 조합
### `/app` (허브)
- Page: `src/app/(app)/app/page.tsx`
- Core Widget: `src/widgets/app-hub/ui/AppHubWidget.tsx`
- 주요 구성:
- `StartRitualWidget`
- `RoomsGalleryWidget`
- `CustomEntryWidget`
- 데이터 소스:
- room 목록: `entities/room`
- 목표/타이머/사운드 프리셋: `entities/session`
### `/space` (집중 화면)
- Page: `src/app/(app)/space/page.tsx`
- Core Widget: `src/widgets/space-shell/ui/SpaceSkeletonWidget.tsx`
- 주요 구성:
- `SpaceTimerHudWidget`
- `SpaceToolsDockWidget`
- `features/restart-30s` (HUD 내 조합)
## `/space` 쿼리 파라미터
- `room`: 공간 id
- `sound`: 사운드 preset id
- `timer`: 타이머 라벨
- `goal`: 목표 한 줄 (선택)
## 변경 시 체크포인트
- 라우팅 변경 시 `/app -> /space` 진입 흐름이 깨지지 않는지 확인
- query param 기본값 처리 유지
- page 파일에 로직 누수 여부 확인