# 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의 주 의사결정으로 느껴지지 않는다