viberoom-web/docs/work.md

Work Order

이 파일은 이번 세션에서 처리할 작업을 적는 실행 입력서다.

작성 규칙

• 작업은 가능한 한 "주제별"로 분리해서 작성한다.
• 한 주제는 가능하면 한 커밋으로 끝낼 수 있게 범위를 좁힌다.
• finding -> fix -> docs -> validation -> commit까지 한 라운드에서 닫는다.
• browser QA가 필요한 작업은 반드시 완료 조건에 명시한다.

우선순위

• 위에서 아래 순서대로 높은 우선순위로 간주한다.
• 작업 1을 먼저 처리하고, 완료 시 다음 작업으로 넘어간다.

---

작업 1

• 제목: Paused Session Re-entry Session Routing Contract
• 목적:
  • 18_paused_session_reentry_spec.md 기준으로 running / paused / break 상태의 route policy를 코드에 고정한다.
  • /app과 /space가 같은 session state를 두고 서로 다른 해석을 하지 않게 만든다.
• 변경 범위:
  • current session route gating
  • /app 진입 정책
  • /space direct re-entry 정책
• 제외 범위:
  • visual redesign 직접 착수 금지
  • takeover flow UI 구현 금지
  • weekly review 집계 확장 금지
• 완료 조건:
  • running focus -> /space
  • running break -> /space
  • paused focus -> /app
  • no session -> /app 규칙이 코드와 문서에서 일치한다
• 진행 상태:
  • 다음 작업
• 검증:
  • source-of-truth 문서 대조
• 커밋 힌트:
  • feat(flow): session routing contract 정리

작업 2

• 제목: /app Paused Resume Gate
• 목적:
  • paused session 사용자가 /app에서 현재 상태를 이해하고, 한 번의 결정으로 다시 들어가게 만든다.
• 변경 범위:
  • paused resume card
  • 이어서 몰입하기
  • 한 조각 다시 잡기
  • quiet 주간 review 보기
• 제외 범위:
  • new start takeover flow 금지
  • bulk visual redesign 금지
• 완료 조건:
  • paused 사용자가 2초 안에 다음 행동을 이해할 수 있다
  • review는 보이지만 resume보다 앞서지 않는다
• 검증:
  • /app paused state browser QA
• 커밋 힌트:
  • feat(app): paused resume gate 추가

작업 3

• 제목: /space Auto-Resume Handoff
• 목적:
  • /app에서 explicit continue를 눌렀다면 /space에서 다시 start를 누르지 않게 만든다.
• 변경 범위:
  • /app -> /space handoff
  • resume trigger
  • re-entry transition
• 제외 범위:
  • takeover flow 금지
  • break semantics 재정의 금지
• 완료 조건:
  • /app -> /space -> start 이중 클릭이 사라진다
  • explicit continue 이후에는 /space에서 바로 실행 상태로 들어간다
• 검증:
  • paused -> continue 브라우저 QA
• 커밋 힌트:
  • feat(space): paused auto-resume handoff 연결

작업 4

• 제목: Paused Session Takeover Flow
• 목적:
  • paused session 위에서 새 목표를 시작하고 싶을 때 상태 오염 없이 명시적으로 전환하게 만든다.
• 변경 범위:
  • takeover confirm sheet
  • close-and-start-new 경로
  • silent abandon 방지
• 제외 범위:
  • weekly review 확장 금지
  • visual redesign 직접 착수 금지
• 완료 조건:
  • paused 상태에서 direct new start는 불가능하다
  • 사용자는 기존 paused session을 어떻게 처리할지 먼저 고른다
• 검증:
  • paused -> new start 브라우저 QA
• 커밋 힌트:
  • feat(app): paused session takeover flow 추가

작업 5

• 제목: Core Loop Alignment Audit browser slice
• 목적:
  • paused re-entry까지 포함한 핵심 흐름을 브라우저에서 실제로 검증한다.
• 변경 범위:
  • /app first entry
  • /app paused resume
  • /app -> /stats -> /app
  • /space pause / return / next beat / complete
  • /space complete -> setup -> weekly review teaser
• 제외 범위:
  • bulk visual redesign 금지
  • new feature 추가 금지
• 완료 조건:
  • browser QA findings가 ledger에 반영된다
  • P1/P2 mismatch는 수정 대상 라운드로 분리된다
• 검증:
  • manual browser QA
• 커밋 힌트:
  • docs(qa): core-loop browser audit 기록