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

44
docs/00_project_brief.md Normal file
View File

@@ -0,0 +1,44 @@
# 00. Project Brief
## 프로젝트 목적
VibeRoom Web은 몰입 공간 경험을 빠르게 실험하기 위한 프론트엔드 목업 프로젝트다.
핵심 목표는 실제 기능 완성보다 UX 흐름, 화면 구조, 상호작용 톤을 안정적으로 검증하는 것이다.
## 기술 스택
- Next.js (App Router)
- TypeScript
- TailwindCSS
- 상태: React state + 일부 Zustand
## 유지보수 역할 정의
이 프로젝트에서 엔지니어의 역할:
- FSD 구조를 지키며 화면/기능을 지속적으로 리팩터링한다.
- View 계층을 조합 중심으로 유지하고 로직이 새지 않게 막는다.
- 감성/저자극 톤을 유지하며 과한 강조 UI를 억제한다.
- 실제 서비스 로직은 구현하지 않고, 더미 데이터와 토스트로 흐름만 검증한다.
## 범위와 비범위
범위:
- 라우트/위젯/피처 단위 UI 개선
- 더미 데이터 기반 상태 표현
- 모달, 토글, 탭, 선택, 토스트
비범위:
- 실시간 인원수/presence 정확도 보장
- 타이머 카운트다운 실제 동작
- 오디오 재생 엔진
- 서버/DB/API 연동 완성
## Definition of Done
- 요구사항 화면이 동작하고, 기존 톤과 충돌하지 않는다.
- FSD, 뷰 무로직, 500줄 분리 규칙을 지킨다.
- `/app`, `/space` 등 관련 라우트에서 UX 흐름이 깨지지 않는다.
- `docs/90_current_state.md`에 DONE/NEXT/RISKS/CHANGED FILES가 갱신된다.