From 3a06881634bef56f79a899982079697c854bac7c Mon Sep 17 00:00:00 2001 From: corpi Date: Tue, 17 Mar 2026 20:52:27 +0900 Subject: [PATCH] docs(ui): codify view reuse rule --- docs/README.md | 3 +++ docs/foundation/08_premium_uiux_guideline.md | 9 +++++++++ 2 files changed, 12 insertions(+) diff --git a/docs/README.md b/docs/README.md index 2e09957..d3204d0 100644 --- a/docs/README.md +++ b/docs/README.md @@ -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) diff --git a/docs/foundation/08_premium_uiux_guideline.md b/docs/foundation/08_premium_uiux_guideline.md index 9cdaf01..c9ff431 100644 --- a/docs/foundation/08_premium_uiux_guideline.md +++ b/docs/foundation/08_premium_uiux_guideline.md @@ -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를 임의로 만들지 않았는가?