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,73 @@
# .cli/current.md
## TASK_META (수정 금지)
- TASK_TITLE: Lobby twinkle를 “반짝임만”으로 고정(이동 제거) + 별자리 3개 유지
- TASK_SLUG: lobby-twinkle-only-no-move
## 작업 목표
`@src/app/page.tsx` 로비 배경에서 “반짝임(twinkle)”이 **이동 없이** 빛만 변하도록 수정한다.
또한 배경 별자리는 **오리온/마차부/북두칠성 3개만** 유지하고, 별자리 외 추가 별(스타필드)을 제거/금지한다.
## 작업 요구사항
1. 별자리 3개 고정(필수)
- 배경에는 아래 3개 별자리만 존재해야 한다:
- 오리온
- 마차부(Auriga)
- 북두칠성(Big Dipper)
- 다른 별자리(또는 별자리 외 장식 요소)가 있으면 제거한다.
2. “반짝임만” 구현(필수)
- 반짝임은 **별자리의 별(점) 요소에만** 적용한다.
- 반짝임 방식:
- `opacity` 변화만 허용(권장 범위: 0.6 ~ 1.0)
- (선택) `scale`은 0.99 ~ 1.01 이내에서만 허용(없어도 됨)
- 별마다 타이밍이 다르게:
- duration 2~6초 분산
- delay도 별마다 분산(랜덤 또는 고정 배열)
3. 이동/드리프트/패럴럭스 금지(최우선)
- 아래는 **전부 금지**이며, 존재하면 제거한다:
- translate / rotate / position 이동(left/top/x/y 변화)
- Canvas 스타필드/별 이동 애니메이션
- 배경 스크롤링/드리프트/패럴럭스(별이 흐르는 연출)
- 별(점)의 좌표는 시간에 따라 **절대 변하지 않아야 한다.**
4. 추가 별(스타필드) 금지(필수)
- 별자리 외의 랜덤 점/별을 생성하는 코드가 있으면 제거한다.
- 결과적으로 화면에 보이는 별(점)은 **3개 별자리를 구성하는 점들만**이어야 한다.
5. 모션 접근성(필수)
- `prefers-reduced-motion: reduce` 환경에서는 반짝임을 **정지**하거나 매우 약하게 만든다(정지 우선).
## Non-scope
- 로비의 버튼 구성/CTA/항로 구성 변경 금지(이번 작업은 배경 twinkle 품질/제약 정리 중심)
- /flight 등 다른 페이지 변경 금지
- 신규 기능 추가 금지
## 적용 파일
- 필수: `@src/app/page.tsx`
- 필요 시(최소 변경): 공통 스타일/컴포넌트 파일(별자리 SVG/스타 컴포넌트를 분리하는 경우만)
- (권장) 별자리 점 요소에는 식별 가능한 class/data-attribute를 부여해 twinkle 대상이 명확하도록 한다.
## 완료 조건(AC)
- [ ] 배경 별자리는 오리온/마차부/북두칠성 **3개만** 존재한다
- [ ] 별(점)은 **위치 이동이 전혀 없고**, 빛(opacity)만 변한다(반짝임만)
- [ ] translate/rotate/드리프트/패럴럭스/스타필드(Canvas 포함) 코드가 존재하지 않는다
- [ ] 별자리 외 “추가 별(랜덤 점/스타필드)”이 생성되지 않는다
- [ ] prefers-reduced-motion에서 반짝임이 정지(또는 매우 약화)된다
## 완료 후 출력(최소)
- 수정된 파일 경로 목록
- AC 항목별 체크 결과(OK/NO)