docs(ui): codify view reuse rule

This commit is contained in:
2026-03-17 20:52:27 +09:00
parent bdbcf3c3f1
commit 3a06881634
2 changed files with 12 additions and 0 deletions

View File

@@ -79,6 +79,7 @@ review 구조와 BM 연결을 볼 때 읽는다.
- [08_premium_uiux_guideline.md](./foundation/08_premium_uiux_guideline.md) `source-of-truth`
- 세계 최고급(LifeAt, Portal 수준) UI/UX 톤앤매너, 글래스모피즘, 모션 등 프리미엄 디자인 절대 원칙
- 중요: UI 작업 시 AI가 새 view를 임의로 그리지 않고, 사용자가 만든 현재 view를 source of truth로 재사용/확장해야 한다
- [01_ui_guidelines.md](./foundation/01_ui_guidelines.md) `source-of-truth`
- UI 톤, CTA 위계, premium 품질 기준 (일반 가이드)
- [02_arch_fsd_rules.md](./foundation/02_arch_fsd_rules.md) `source-of-truth`
@@ -120,6 +121,8 @@ review 구조와 BM 연결을 볼 때 읽는다.
- [10_refocus_system_spec.md](./flows/current/10_refocus_system_spec.md)
- [11_away_return_recovery_spec.md](./flows/current/11_away_return_recovery_spec.md)
- [13_space_intent_card_collapsed_expanded_spec.md](./screens/space/current/13_space_intent_card_collapsed_expanded_spec.md)
- [08_premium_uiux_guideline.md](./foundation/08_premium_uiux_guideline.md)
- 현재 사용자가 만든 `/space` view를 그대로 재사용/확장하고, 새 shell을 임의로 만들지 않는다
- `/stats`를 수정한다:
- [screens/stats/README.md](./screens/stats/README.md)
- [14_weekly_review_reframe_spec.md](./screens/stats/current/14_weekly_review_reframe_spec.md)

View File

@@ -7,6 +7,14 @@
## 1. 핵심 철학 (Core Philosophy)
### 1-0. View Reuse First (사용자 뷰 우선 재사용)
- **절대 원칙:** 사용자가 직접 다듬어 둔 현재 화면의 view, spacing, motion, hierarchy는 곧 source of truth입니다.
- AI 에이전트나 개발자는 UI 작업 시 새로운 shell, 새로운 visual language, 새로운 레이아웃을 임의로 다시 그리면 안 됩니다.
- 기능 추가/상태 분기 변경이 필요해도 **기존 view를 재사용하고, 그 내부에 stage/state만 확장**하는 방식으로 처리합니다.
- "더 좋아 보인다", "더 premium해 보인다"는 이유만으로 현재 사용 중인 view를 갈아엎는 것은 금지합니다.
- 새 화면이 필요할 때도 먼저 기존 화면의 shell, typography, spacing, animation을 복제/재사용할 수 있는지부터 검토합니다.
- 특히 `/space`처럼 사용자가 직접 premium tone을 반복적으로 조정한 화면에서는, **현재 구현된 컴포넌트가 디자인 시스템 그 자체**라고 보고 수정 범위를 최소화해야 합니다.
### 1-1. 무대 우선주의 (Stage-first & Immersive)
- **절대 원칙:** 사용자가 선택한 **배경(Atmosphere/Scene) 자체가 곧 앱의 정체성이자 무대**입니다.
- 배경을 가리거나 시야를 방해하는 거대한 대시보드 형태의 레이아웃(Split-screen, 거대한 Solid Card Grid)은 절대 금지합니다.
@@ -125,3 +133,4 @@ AI가 흔한 폼 인풋(`border rounded px-4`)을 만들지 못하게 하세요.
3. **Hierarchy Check:** 화면 내에서 가장 눈에 띄는 것이 "현재 사용자가 해야 할 단 하나의 액션"인가? 부가 정보가 너무 커서 메인 액션을 압도하지 않는가?
4. **Motion Check:** 화면 진입 시 모든 요소가 우아하고 부드럽게 등장하는가? 깜빡이거나 투박하게 나타나는 요소는 없는가?
5. **Glass Check:** 모든 팝오버, 시트, 위젯이 뒷 배경을 우아하게 투영(backdrop-blur)하고 있으며, 테두리가 지나치게 두껍지 않은가?
6. **Reuse Check:** 이번 작업이 기존 사용자가 만든 view를 재사용/확장한 것인가? 새 shell이나 새 visual language를 임의로 만들지 않았는가?