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

docs/README.md

@@ -1,28 +1,119 @@
 # Docs Index
 
-Codex CLI가 중간에 끊겨도 같은 품질로 작업을 이어가기 위한 운영 문서 모음입니다.
+이 문서는 `web/docs`의 **메인 인덱스**다.
+문서를 찾을 때는 항상 여기서 시작한다.
 
-## 우선 읽기 순서
+문서 상태는 3가지로 본다.
 
-1. [work.md](./work.md)
-2. [session_brief.md](./session_brief.md)
-3. [90_current_state.md](./90_current_state.md)
-4. [context_core.md](./context_core.md)
+- `source-of-truth`: 현재 기획/구현의 기준 문서
+- `ops`: 작업 운영, 핸드오프, 세션 복구용 문서
+- `legacy`: 과거 맥락을 이해할 때만 보는 참고 문서
 
-## 추가 실무 가이드
+## 가장 먼저 읽기
 
-- [04_coding_rules.md](./04_coding_rules.md)
-- [05_handoff_checklist.md](./05_handoff_checklist.md)
-- [06_commit_convention.md](./06_commit_convention.md)
-- [07_session_recovery.md](./07_session_recovery.md)
-- [work.md](./work.md)
-- [workFlow.md](./workFlow.md)
-- [session_brief.md](./session_brief.md)
+새 세션이나 새 에이전트가 들어오면 이 순서로 읽는다.
 
-## 운영 원칙
+1. [work.md](./work.md) `source-of-truth`
+2. [session_brief.md](./session_brief.md) `source-of-truth`
+3. [90_current_state.md](./90_current_state.md) `source-of-truth`
+4. [context_core.md](./context_core.md) `ops`
+5. 이 문서에서 지금 다루는 화면 섹션 확인
 
-- 구현 범위는 항상 UI 목업 + 더미 데이터 + 토스트 수준으로 유지한다.
-- `page.tsx`는 조합만 담당하고 비즈니스 로직은 `features/widgets/entities`로 이동한다.
-- 작업 종료 시 `90_current_state.md`를 반드시 업데이트한다.
-- 세션 복구는 `npm run session:recover`로 시작한다.
-- `workFlow.md` 실행 시 기본은 `work + session_brief` 2파일만 로드한다.
+## 제품 전체 기획
+
+화면 하나가 아니라 제품 전체 방향을 볼 때 읽는다.
+
+- [00_project_brief.md](./00_project_brief.md) `source-of-truth`
+  - 프로젝트 목적, 범위, 현재 제품 성격
+- [12_core_loop_execution_roadmap.md](./12_core_loop_execution_roadmap.md) `source-of-truth`
+  - 어떤 순서로 구현할지 정리한 로드맵
+- [16_product_alignment_audit_plan.md](./16_product_alignment_audit_plan.md) `source-of-truth`
+  - 기획-구현 불일치 점검 계획
+- [17_product_alignment_findings.md](./17_product_alignment_findings.md) `source-of-truth`
+  - 실제 불일치 ledger
+- [08_app_reframe_strategy.md](./08_app_reframe_strategy.md) `legacy`
+  - 초반 `/app` 방향 논의용 아이디어 문서
+
+## 화면별 기획 문서
+
+### `/app`
+
+`/app` 진입 경험, paused gate, review entry를 볼 때 읽는다.
+
+- [19_app_atmosphere_entry_spec.md](./19_app_atmosphere_entry_spec.md) `source-of-truth`
+  - `goal + duration + atmosphere` 중심의 새 `/app` 설계
+- [18_paused_session_reentry_spec.md](./18_paused_session_reentry_spec.md) `source-of-truth`
+  - paused/running 상태에 따른 `/app <-> /space` 재진입 정책
+- [15_app_stats_entry_flow_spec.md](./15_app_stats_entry_flow_spec.md) `source-of-truth`
+  - `/app -> /stats -> /app` review 진입/복귀 플로우
+
+### `/space`
+
+`/space` HUD, refocus, break/return, goal card를 볼 때 읽는다.
+
+- [10_refocus_system_spec.md](./10_refocus_system_spec.md) `source-of-truth`
+  - pause/refocus/next-beat/goal-complete 구조
+- [11_away_return_recovery_spec.md](./11_away_return_recovery_spec.md) `source-of-truth`
+  - away/return 감지와 복귀 UX
+- [13_space_intent_card_collapsed_expanded_spec.md](./13_space_intent_card_collapsed_expanded_spec.md) `source-of-truth`
+  - 좌상단 목표 카드 구조
+
+### `/stats`
+
+review 구조와 BM 연결을 볼 때 읽는다.
+
+- [14_weekly_review_reframe_spec.md](./14_weekly_review_reframe_spec.md) `source-of-truth`
+  - weekly review를 행동 시스템으로 재정의한 문서
+- [15_app_stats_entry_flow_spec.md](./15_app_stats_entry_flow_spec.md) `source-of-truth`
+  - `/stats` 진입/복귀 플로우
+
+## 개발 시 참고 문서
+
+구현 규칙이나 구조를 볼 때 읽는다.
+
+- [01_ui_guidelines.md](./01_ui_guidelines.md) `source-of-truth`
+  - UI 톤, CTA 위계, premium 품질 기준
+- [02_arch_fsd_rules.md](./02_arch_fsd_rules.md) `source-of-truth`
+  - FSD/레이어 구조 규칙
+- [03_routes_map.md](./03_routes_map.md) `source-of-truth`
+  - 라우트와 주요 화면 진입점
+- [04_coding_rules.md](./04_coding_rules.md) `source-of-truth`
+  - 코드 작성 규칙
+- [06_commit_convention.md](./06_commit_convention.md) `source-of-truth`
+  - 커밋 규칙
+
+## 운영 / 핸드오프 문서
+
+작업 재개, 세션 복구, handoff용 문서다.
+
+- [05_handoff_checklist.md](./05_handoff_checklist.md) `ops`
+- [07_session_recovery.md](./07_session_recovery.md) `ops`
+- [context_core.md](./context_core.md) `ops`
+- [workFlow.md](./workFlow.md) `ops`
+- [work.template.md](./work.template.md) `ops`
+
+## 실시간 상태 문서
+
+지금 무엇을 하고 있고, 다음 작업이 무엇인지 볼 때 읽는다.
+
+- [work.md](./work.md) `source-of-truth`
+- [session_brief.md](./session_brief.md) `source-of-truth`
+- [90_current_state.md](./90_current_state.md) `source-of-truth`
+
+## 빠른 선택 가이드
+
+- `/app`을 수정한다:
+  - [19_app_atmosphere_entry_spec.md](./19_app_atmosphere_entry_spec.md)
+  - [18_paused_session_reentry_spec.md](./18_paused_session_reentry_spec.md)
+  - [15_app_stats_entry_flow_spec.md](./15_app_stats_entry_flow_spec.md)
+- `/space` recovery를 수정한다:
+  - [10_refocus_system_spec.md](./10_refocus_system_spec.md)
+  - [11_away_return_recovery_spec.md](./11_away_return_recovery_spec.md)
+  - [13_space_intent_card_collapsed_expanded_spec.md](./13_space_intent_card_collapsed_expanded_spec.md)
+- `/stats`를 수정한다:
+  - [14_weekly_review_reframe_spec.md](./14_weekly_review_reframe_spec.md)
+  - [15_app_stats_entry_flow_spec.md](./15_app_stats_entry_flow_spec.md)
+- 지금 다음 작업이 뭔지 본다:
+  - [work.md](./work.md)
+  - [session_brief.md](./session_brief.md)
+  - [90_current_state.md](./90_current_state.md)