feat: Knowledge Gardening Milestone 380 (Batches #17-19)

2026-04-26 19:56:45 +09:00
parent 2c6f410d99
commit 26e19dae54
61 changed files with 1754 additions and 60 deletions
@@ -0,0 +1,89 @@
+# Skybound Combat HUD Information Hierarchy Onboarding
+
+작성일: 2026-04-26 17:06 KST
+
+## 요청 요약
+
+- 전투 HUD를 정보 패널이 아니라 플레이 보조 장치로 줄이는 방향으로 진행한다.
+- 항상 보이는 정보는 최소화하고, Stage 1 초반에는 핵심 행동을 자연스럽게 안내하는 온보딩이 필요하다.
+
+## 핵심 판단
+
+Skybound는 전술 시뮬레이션이 아니라 `Survivor-like horde survival shooter`에 가깝다.
+
+따라서 전투 중 HUD는 모든 정보를 보여주는 것이 아니라 다음 판단만 빠르게 도와야 한다.
+
+- 지금 몇 스테이지인가
+- 내 체력이 위험한가
+- Tactical Level이 얼마나 찼는가
+- 폭탄과 Lock-on을 쓸 수 있는가
+- 초반 사용자는 지금 무엇을 해야 하는가
+
+점수, 베스트런, 세부 상태 정보는 전투 판단보다 결과/성장 확인에 더 적합하므로 전투 중 상시 노출에서 제외하는 것이 맞다.
+
+## 적용한 변경
+
+### 전투 HUD 상시 정보 축소
+
+기존에는 전투 중 HUD에서 점수/베스트런 같은 정보도 함께 노출되었다.
+
+변경:
+
+- `ScoreBoard`를 전투 HUD 상시 노출에서 제거
+- `Tactical Level` 라벨을 `Tac Level`로 축약
+- Mastery 상태는 전투 중 상시 HUD에서 숨김
+- 기존 Stage, HP, Tac Level, Bomb, Lock-on, 설정 버튼 중심으로 정리
+
+의도:
+
+- 전투 화면을 덜 가리게 한다.
+- 사용자의 시선을 생존과 성장 루프에 집중시킨다.
+- 점수 확인은 결과 화면에서 더 명확하게 하도록 역할을 분리한다.
+
+### Stage 1 Flight Plan 카드 추가
+
+Stage 1 초반에만 작은 목표 카드가 나타나도록 했다.
+
+목표 단계:
+
+- Move: WASD로 거리 유지
+- Collect: 청록 크리스탈과 안전 픽업 회수
+- Upgrade: Tac Level 상승 시 모듈 선택
+- Survive: 포위되면 Space Bomb 사용
+
+표시 조건:
+
+- Stage 1
+- 전투 시작 후 약 75초 이내
+- Tactical Upgrade 선택 화면이 아닐 때
+- 아직 완료되지 않은 목표가 있을 때
+
+의도:
+
+- 긴 튜토리얼 문장 대신 실제 플레이 중 해야 할 행동만 짧게 안내한다.
+- 사용자가 시스템을 “읽어서” 배우는 것이 아니라 “하면서” 배우게 한다.
+- 전투 흐름을 방해하지 않도록 작은 사이드 카드로 처리한다.
+
+### Desktop/Small 화면 배치 대응
+
+Desktop에서는 기존 side dock 철학을 유지하고, Flight Plan 카드는 반대편 사이드 레일에 배치했다.
+
+작은 화면에서는 카드가 플레이 필드 밖에 나가지 않도록 상단 아래쪽에 배치된다.
+
+## 수정 파일
+
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/HUDOverlay.tsx`
+- `/Volumes/Data/project/Antigravity/Skybound/src/features/game/ui/HUDOverlay.css`
+
+## 검증
+
+- `npm run build` 성공
+- 출력 디렉터리: `dist/42`
+
+## 후속 플레이테스트 체크 포인트
+
+- 전투 중 HUD가 이전보다 덜 부담스럽게 느껴지는지 확인한다.
+- Stage 1 초반 Flight Plan 카드가 플레이를 가리지 않는지 확인한다.
+- 목표 카드가 너무 오래 남거나 너무 빨리 사라지지 않는지 확인한다.
+- 점수/베스트런이 빠진 것이 전투 중 불편하지 않은지 확인한다.
+- 결과 화면에서 점수 확인 역할이 충분히 보완되는지 확인한다.