docs(docs): 문서 인덱스와 화면별 가이드 재정리

docs/context_core.md

@@ -1,43 +1,56 @@
-# Context Core (Token-Saving)
+# Context Core
 
-세션 시작 시 가장 먼저 읽는 핵심 요약본이다.
+세션 시작 시 빠르게 읽는 **초단기 핵심 요약본**이다.
 
-## 제품/범위
+전체 문서 구조는 [README.md](./README.md)에서 본다.
 
-- VibeRoom Web은 UI 목업 중심 프로젝트다.
-- 실제 기능(타이머 카운트다운, 오디오 엔진, 서버/DB)은 구현하지 않는다.
-- 더미 데이터 + 토스트 + 화면 상호작용 중심으로 구현한다.
+## 제품 핵심
 
-## FSD 핵심 규칙
+- VibeRoom Web은 ADHD와 프리랜서를 위한 premium focus service다.
+- 핵심 루프는 `commit -> enter -> immerse -> pause/return -> complete -> review`다.
+- `/app`은 planning dashboard가 아니라 **entry stage**다.
+- `/space`는 dashboard가 아니라 **execution sanctuary**다.
+- `/stats`는 summary page가 아니라 **다음 세션 성공률을 높이는 review**다.
 
-- `app/page.tsx`는 조합만 담당한다.
-- 비즈니스 로직은 `features` 또는 `entities`로 이동한다.
-- UI 상태(토글/선택)만 최소 허용한다.
-- 파일이 500줄 이상이면 분리한다.
-- import 방향:
+## 현재 화면 기준
+
+### `/app`
+
+- current session이 `running`이면 `/space`가 우선이다.
+- current session이 `paused`이면 `/app` resume gate가 우선이다.
+- no-session 상태의 source-of-truth는 `goal + duration + atmosphere` entry shell이다.
+- `microStep`은 `/app`에서 입력하지 않는다.
+
+### `/space`
+
+- goal card는 collapsed / expanded rail 구조다.
+- `pause`, `return`, `next beat`, `goal complete`는 한 번에 하나만 열린다.
+- active session에서는 closure 경로가 항상 남아 있어야 한다.
+
+### `/stats`
+
+- review는 `snapshot / start quality / recovery quality / completion quality / carry forward` 구조다.
+- primary entry는 `/app`, secondary entry는 `/space` complete 이후 setup이다.
+
+## 구현 규칙 요약
+
+- `page.tsx`는 조합만 담당한다.
+- 레이어 규칙:
   - `app -> widgets/features/entities/shared`
   - `widgets -> features/entities/shared`
   - `features -> entities/shared`
   - `entities -> shared`
-  - `shared -> shared/external`
+- UI는 premium ambient focus 톤을 유지한다.
+- 한 화면에는 primary CTA를 1개만 둔다.
 
-## UI 핵심 규칙
+## 작업 시작 순서
 
-- 톤: 감성/저자극, 과한 대비/강조 금지
-- CTA 위계: Primary 1개 중심, Secondary/Tertiary는 무게 낮게
-- 모바일은 접근성 우선, 데스크톱은 과한 풀폭 버튼 지양
+1. [work.md](./work.md)
+2. [session_brief.md](./session_brief.md)
+3. [90_current_state.md](./90_current_state.md)
+4. 지금 건드릴 화면의 source-of-truth spec
 
-## 커밋 규칙 (요약)
+## 주의
 
-- 주제별 1커밋
-- 한국어 Conventional Commit
-- 본문 형식:
-  - `맥락`
-  - `변경사항`
-  - `검증`
-  - `세션-상태 / 세션-다음 / 세션-리스크`
-
-## 세션 복구 규칙
-
-- 시작: `npm run session:recover`
-- 상태판: `docs/90_current_state.md` 기준으로 다음 작업 결정
+- 오래된 `/app` single-goal gate 문서는 legacy다.
+- 문서가 충돌하면 [README.md](./README.md)의 `source-of-truth` 분류가 우선이다.