viberoom-web/docs/work.md

Work Order

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

작성 규칙

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

우선순위

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

---

작업 1

• 제목: /app Atmosphere Entry Shell
• 목적:
  • 19_app_atmosphere_entry_spec.md 기준으로 /app no-session 상태를 goal + duration + atmosphere 중심의 premium entry screen으로 재설계한다.
  • entry에서 scene/sound의 감각 품질을 다시 살리되 planner/dashboard 톤으로 흐르지 않게 만든다.
• 변경 범위:
  • no-session /app shell
  • atmosphere dummy 12개
  • goal input
  • duration input
  • 4x3 atmosphere grid
  • primary CTA
• 제외 범위:
  • paused resume gate 재설계 금지
  • weekly review 상세 IA 변경 금지
  • server contract 변경 금지
• 완료 조건:
  • current session이 없을 때만 새 entry shell이 보인다
  • goal + duration + selected atmosphere가 start surface 안에서 명확히 읽힌다
  • 12개 dummy atmosphere가 4열 그리드로 배치된다
• 진행 상태:
  • 대기
• 검증:
  • /app no-session browser QA
• 커밋 힌트:
  • feat(app): atmosphere entry shell 1차 구현

작업 2

• 제목: Custom Duration Contract
• 목적:
  • /app의 분 단위 duration 입력을 실제 세션 길이로 반영한다.
• 변경 범위:
  • web start payload
  • server startSession contract
  • break duration 정책
  • /space timer 연동
• 제외 범위:
  • weekly review recommendation 확장 금지
  • atmosphere personalization 금지
• 완료 조건:
  • 70분 같은 값이 실제 focus duration으로 반영된다
  • break duration이 정책 기준으로 계산된다
• 진행 상태:
  • 대기
• 검증:
  • start -> /space -> timer duration 확인
• 커밋 힌트:
  • feat(flow): custom duration contract 연결

작업 3

• 제목: Weekly Review Dock Reposition
• 목적:
  • 새 /app entry shell 안에서 weekly review를 start를 방해하지 않는 quiet secondary dock로 재배치한다.
• 변경 범위:
  • /app review teaser placement
  • desktop/mobile responsive placement
  • review return hint placement
• 제외 범위:
  • /stats IA 변경 금지
  • paused resume gate 재설계 금지
• 완료 조건:
  • review entry는 항상 발견 가능하지만 start보다 앞서지 않는다
  • no-session shell과 paused gate에서 위계가 일관된다
• 진행 상태:
  • 대기
• 검증:
  • /app no-session / paused browser QA
• 커밋 힌트:
  • fix(app): review dock 위치 재정렬

작업 4

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