docs: cli 용 문서 업로드 (runbook: 개발, runbook_planner: 기획)

This commit is contained in:
2026-02-14 02:05:07 +09:00
parent 99c996b20e
commit 8e9ba0431b
41 changed files with 2818 additions and 1 deletions

View File

@@ -0,0 +1,66 @@
# .cli/current.md
## TASK_META (수정 금지)
- TASK_TITLE: Lobby 별자리 3개 고정 + 별 반짝임 구현 + 불필요 별/문구 제거
- TASK_SLUG: lobby-constellation-twinkle-fix
## 작업 목표
`@src/app/page.tsx` 로비 화면에서 아래 문제를 해결한다:
- “정거장 3명이 대기 중” 문구가 다시 나타나는 현상 제거(재발 방지)
- 배경 별자리는 **3개만 유지**(오리온/마차부/북두칠성)
- 각 별자리의 “별(점)”이 주기적으로 은은하게 반짝이도록(twinkle) **실제 구현**
- 별자리 외 **추가 별(랜덤 스타필드 등) 생성 금지** 및 기존에 생긴 불필요 별 제거
## 작업 요구사항
1. 문구 재발 방지(필수)
- 로비 화면에서 아래 문구가 렌더링되지 않도록 제거하고, 재도입되지 않게 한다:
- "정거장 3명 대기 중"
- "정거장 3명이 대기중"
- "대기 중" 관련 유사 문구(정거장 대기 인원 표현 포함)
- 주의: 하드코딩/데이터/컴포넌트 어디에 있든 **최종 UI에 나오면 실패**.
2. 배경 별자리 3개 고정(필수)
- 배경에는 아래 3개 별자리만 존재해야 한다(이름/레이블은 내부 코드에서만 사용해도 됨):
- 오리온
- 마차부(Auriga)
- 북두칠성(큰곰자리 일부 / Big Dipper)
- 기존에 있던 다른 별자리(거문고 등) 또는 별자리 외 요소는 제거한다.
3. 별 반짝임(twinkle) 실제 구현(필수)
- 반짝임은 **오리온/마차부/북두칠성의 별(점) 요소에만** 적용한다.
- “별자리 외 별(랜덤 점/스타필드)”에는 반짝임 적용 금지(애초에 생성 금지).
- 방식 권장:
- opacity 0.6~1.0 사이 미세 변화 + scale 0.98~1.03 미세 변화
- duration 2~6초 범위로 분산
- delay를 별마다 다르게(랜덤/고정 배열 모두 가능)
- `prefers-reduced-motion: reduce` 환경에서는 반짝임을 **정지 또는 매우 약화**.
4. 불필요 별(추가 생성 요소) 제거(필수)
- 별자리 3개 외의 별/점이 대량으로 추가되는 코드(랜덤 생성, 루프 생성, Canvas 스타필드 등)가 있다면 제거한다.
- 결과적으로 화면에 보이는 “별(점)”은 **3개 별자리를 구성하는 별(점)만**이어야 한다.
## Non-scope
- /flight 등 다른 페이지 로직/구조 변경 금지
- 신규 기능 추가 금지(로그인/채팅/윈도우 출항 등)
- 과도한 번쩍임/강한 플래시/깜빡임(고주파 점멸) 금지
## 적용 파일
- 필수: `@src/app/page.tsx`
- 필요 시(최소 변경): 공통 스타일/컴포넌트(별자리 SVG/스타 컴포넌트 분리하는 경우만)
## 완료 조건(AC)
- [ ] 로비 화면에서 “정거장 3명 대기 중/대기중” 및 정거장 대기 인원 문구가 **절대 표시되지 않는다**
- [ ] 배경 별자리는 **오리온/마차부/북두칠성 3개만** 존재한다
- [ ] 반짝임(twinkle)이 **각 별자리의 별(점)에 실제로 적용**되어 보인다(별마다 타이밍이 다름)
- [ ] 별자리 외 “추가 별(스타필드/랜덤 점)”이 **생성되지 않는다**