viberoom-web/docs/09_app_entry_detailed_spec.md

09. /app Entry Detailed Spec

Last Updated: 2026-03-14

이 문서는 /app을 single-goal commitment gate로 구현할 때의 상세 기준 문서다.

관련 상위 기준:

• ../../product_principles.md
• ../../current_context.md
• 08_app_reframe_strategy.md

---

1. 한 줄 정의

/app은 planner나 setup wizard가 아니라,
사용자가 지금 할 일 한 가지를 정하고 가장 낮은 마찰로 /space에 들어가게 만드는 입구다.

---

2. 화면 역할

/app이 해야 하는 일

• 현재 세션이 있으면 이어가기를 제안한다
• 현재 세션이 없으면 goal 1개 + optional microStep 1개만 받는다
• 주 행동은 항상 지금 시작 하나다
• 시작 전에 많은 설정을 요구하지 않는다

/app이 하면 안 되는 일

• 여러 목표를 관리하게 하기
• planner / to-do / list app처럼 보이게 하기
• scene / sound / timer 선택을 메인 결정으로 끌어올리기
• 진입 전에 정리, 관리, 저장을 강요하기

---

3. 정보 구조

상태 A. Current Session Exists

• eyebrow: Resume
• 현재 goal
• optional microStep
• primary CTA: 이어서 들어가기
• 보조 정보: 현재 ritual 요약
• 설명:
  • 새 목표는 현재 세션을 마무리한 뒤 시작할 수 있다고만 안내

상태 B. No Current Session

• 제목
• 설명
• goal input 1개
• optional microStep input 1개
• suggestion chips 3~4개
• primary CTA: 지금 시작
• 하단 보조 정보:
  • 기본 ritual · scene · timer · sound
  • 공간과 사운드는 들어간 뒤에도 바꿀 수 있어요.

---

4. 상호작용 원칙

Goal

• 필수
• 한 줄 입력
• enter로 바로 시작 가능

MicroStep

• 선택
• checklist가 아니라 지금 할 한 조각
• 1개만 허용

Suggestions

• 계획 리스트가 아니라 start friction reducer 역할
• 클릭 시 goal input을 빠르게 채움

Start

• 현재 세션이 없을 때만 가능
• goal + microStep + default ritual로 세션 시작
• 성공 시 /space 이동

Resume

• 현재 세션이 있으면 start UI 대신 resume UI를 우선 노출
• 클릭 시 /space로 이동

---

5. UX 원칙

• /app은 start surface여야지 setup surface가 아니어야 한다
• 한 화면 안에서 결정할 것은 최대 2개(goal, optional microStep)
• visual hierarchy는 goal > CTA > microStep > suggestions > ritual helper 순서
• paywall은 메인 CTA가 아니라 Plan Pill에서만 여는 수준으로 제한

---

6. 구현 범위

이번 slice에 포함

• 2-step ritual flow 제거
• manage/list UI를 메인 경로에서 제거
• current session resume path 추가
• single-goal + optional microStep direct start
• default ritual만 사용

이번 slice에 포함하지 않음

• multi-goal manage 복구
• entry 단계 scene/sound/timer 직접 선택
• planner/dashboard 요소 복구
• goal 저장과 session start의 backend atomic endpoint 신규 도입

---

7. 검증 기준

• 사용자가 10초 안에 goal을 입력하고 /space로 들어갈 수 있다
• /app 첫 인상이 planner나 setup wizard처럼 보이지 않는다
• current session이 있으면 resume이 주 행동으로 읽힌다
• 현재 세션이 없을 때는 지금 시작이 유일한 dominant CTA다
• scene / sound / timer는 entry의 주 의사결정으로 느껴지지 않는다