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:
44
docs/00_project_brief.md
Normal file
44
docs/00_project_brief.md
Normal 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가 갱신된다.
|
||||
Reference in New Issue
Block a user