timelabs 0.1.0 → 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (138) hide show
  1. package/dist/index.js +30 -20
  2. package/package.json +1 -1
  3. package/skills/web-design/claude-code/SKILL.md +270 -0
  4. package/skills/web-design/claude-code/analyze/analyze-benchmark-rules.md +229 -0
  5. package/skills/web-design/claude-code/analyze/analyze-benchmark.md +302 -0
  6. package/skills/web-design/claude-code/analyze/analyze-mockup.md +572 -0
  7. package/skills/web-design/claude-code/collect/collect-app.md +258 -0
  8. package/skills/web-design/claude-code/collect/collect-desktop.md +231 -0
  9. package/skills/web-design/claude-code/collect/collect-hybrid.md +222 -0
  10. package/skills/web-design/claude-code/collect/collect-style.md +155 -0
  11. package/skills/web-design/claude-code/collect/collect-type.md +42 -0
  12. package/skills/web-design/claude-code/collect/collect-video.md +239 -0
  13. package/skills/web-design/claude-code/collect/collect-web.md +279 -0
  14. package/skills/web-design/claude-code/defs/ai-recommend/01-style-design-recommend.md +64 -0
  15. package/skills/web-design/claude-code/defs/ai-recommend.md +58 -0
  16. package/skills/web-design/claude-code/defs/app-layouts/02-utility.md +54 -0
  17. package/skills/web-design/claude-code/defs/app-layouts/03-social.md +71 -0
  18. package/skills/web-design/claude-code/defs/app-layouts/04-game.md +54 -0
  19. package/skills/web-design/claude-code/defs/app-layouts/05-fintech.md +62 -0
  20. package/skills/web-design/claude-code/defs/app-layouts/06-healthcare.md +66 -0
  21. package/skills/web-design/claude-code/defs/app-layouts/07-ecommerce.md +63 -0
  22. package/skills/web-design/claude-code/defs/app-layouts/08-education.md +88 -0
  23. package/skills/web-design/claude-code/defs/app-layouts/09-creative.md +86 -0
  24. package/skills/web-design/claude-code/defs/app-layouts.md +59 -0
  25. package/skills/web-design/claude-code/defs/app-motions/01-utility.md +51 -0
  26. package/skills/web-design/claude-code/defs/app-motions/02-social.md +55 -0
  27. package/skills/web-design/claude-code/defs/app-motions/03-game.md +52 -0
  28. package/skills/web-design/claude-code/defs/app-motions/04-fintech.md +52 -0
  29. package/skills/web-design/claude-code/defs/app-motions/05-healthcare.md +52 -0
  30. package/skills/web-design/claude-code/defs/app-motions/06-ecommerce.md +55 -0
  31. package/skills/web-design/claude-code/defs/app-motions/07-education.md +54 -0
  32. package/skills/web-design/claude-code/defs/app-motions/08-creative.md +53 -0
  33. package/skills/web-design/claude-code/defs/app-motions/10-intensity-preset-motion.md +12 -0
  34. package/skills/web-design/claude-code/defs/app-motions.md +64 -0
  35. package/skills/web-design/claude-code/defs/component-specs/01-set-component.md +24 -0
  36. package/skills/web-design/claude-code/defs/component-specs/02-features-flow.md +51 -0
  37. package/skills/web-design/claude-code/defs/component-specs/03-system-visual.md +193 -0
  38. package/skills/web-design/claude-code/defs/component-specs/04-interaction-pattern-visual.md +61 -0
  39. package/skills/web-design/claude-code/defs/component-specs/domains/admin.md +55 -0
  40. package/skills/web-design/claude-code/defs/component-specs/domains/dashboard.md +60 -0
  41. package/skills/web-design/claude-code/defs/component-specs/domains/erp.md +68 -0
  42. package/skills/web-design/claude-code/defs/component-specs/domains/saas.md +65 -0
  43. package/skills/web-design/claude-code/defs/component-specs.md +24 -0
  44. package/skills/web-design/claude-code/defs/design-guide-sections.md +37 -0
  45. package/skills/web-design/claude-code/defs/desktop-layouts/01-utility.md +69 -0
  46. package/skills/web-design/claude-code/defs/desktop-layouts/02-data.md +71 -0
  47. package/skills/web-design/claude-code/defs/desktop-layouts/03-creative.md +73 -0
  48. package/skills/web-design/claude-code/defs/desktop-layouts/04-communication.md +71 -0
  49. package/skills/web-design/claude-code/defs/desktop-layouts/05-game.md +73 -0
  50. package/skills/web-design/claude-code/defs/desktop-layouts/06-business.md +74 -0
  51. package/skills/web-design/claude-code/defs/desktop-layouts.md +49 -0
  52. package/skills/web-design/claude-code/defs/desktop-motions/01-utility.md +56 -0
  53. package/skills/web-design/claude-code/defs/desktop-motions/02-data.md +60 -0
  54. package/skills/web-design/claude-code/defs/desktop-motions/03-creative.md +60 -0
  55. package/skills/web-design/claude-code/defs/desktop-motions/04-communication.md +57 -0
  56. package/skills/web-design/claude-code/defs/desktop-motions/05-game.md +55 -0
  57. package/skills/web-design/claude-code/defs/desktop-motions/06-business.md +52 -0
  58. package/skills/web-design/claude-code/defs/desktop-motions.md +75 -0
  59. package/skills/web-design/claude-code/defs/hybrid-layouts/01-web_mobile.md +81 -0
  60. package/skills/web-design/claude-code/defs/hybrid-layouts/02-web_desktop.md +78 -0
  61. package/skills/web-design/claude-code/defs/hybrid-layouts/03-mobile_desktop.md +79 -0
  62. package/skills/web-design/claude-code/defs/hybrid-layouts/04-all.md +81 -0
  63. package/skills/web-design/claude-code/defs/hybrid-layouts.md +49 -0
  64. package/skills/web-design/claude-code/defs/hybrid-motions/01-web_mobile.md +69 -0
  65. package/skills/web-design/claude-code/defs/hybrid-motions/02-web_desktop.md +69 -0
  66. package/skills/web-design/claude-code/defs/hybrid-motions/03-mobile_desktop.md +74 -0
  67. package/skills/web-design/claude-code/defs/hybrid-motions/04-all.md +96 -0
  68. package/skills/web-design/claude-code/defs/hybrid-motions/07-intensity-preset-motion.md +16 -0
  69. package/skills/web-design/claude-code/defs/hybrid-motions.md +65 -0
  70. package/skills/web-design/claude-code/defs/ia-patterns/01-management-dashboard.md +37 -0
  71. package/skills/web-design/claude-code/defs/ia-patterns/05-video.md +33 -0
  72. package/skills/web-design/claude-code/defs/ia-patterns/06-video_saas-saas.md +37 -0
  73. package/skills/web-design/claude-code/defs/ia-patterns.md +85 -0
  74. package/skills/web-design/claude-code/defs/icon-mappings/04-mapping-design-system.md +25 -0
  75. package/skills/web-design/claude-code/defs/icon-mappings.md +49 -0
  76. package/skills/web-design/claude-code/defs/icon-usage.md +56 -0
  77. package/skills/web-design/claude-code/defs/illustration-guide.md +44 -0
  78. package/skills/web-design/claude-code/defs/image-strategies/01-landing.md +76 -0
  79. package/skills/web-design/claude-code/defs/image-strategies/02-dashboard.md +51 -0
  80. package/skills/web-design/claude-code/defs/image-strategies/03-ecommerce.md +47 -0
  81. package/skills/web-design/claude-code/defs/image-strategies/04-blog.md +58 -0
  82. package/skills/web-design/claude-code/defs/image-strategies/05-saas.md +56 -0
  83. package/skills/web-design/claude-code/defs/image-strategies/06-portfolio.md +62 -0
  84. package/skills/web-design/claude-code/defs/image-strategies/08-strategy-common-image.md +57 -0
  85. package/skills/web-design/claude-code/defs/image-strategies.md +58 -0
  86. package/skills/web-design/claude-code/defs/seo-guide.md +79 -0
  87. package/skills/web-design/claude-code/defs/styles/02-style-list.md +421 -0
  88. package/skills/web-design/claude-code/defs/styles/03-custom-animation-keyframes.md +39 -0
  89. package/skills/web-design/claude-code/defs/styles.md +50 -0
  90. package/skills/web-design/claude-code/defs/tokens/01-token-format.md +75 -0
  91. package/skills/web-design/claude-code/defs/tokens/02-token-scope.md +251 -0
  92. package/skills/web-design/claude-code/defs/tokens.md +24 -0
  93. package/skills/web-design/claude-code/defs/video-compositions/01-composition-single.md +66 -0
  94. package/skills/web-design/claude-code/defs/video-compositions/02-composition-multi.md +66 -0
  95. package/skills/web-design/claude-code/defs/video-compositions/03-composition-parametric.md +81 -0
  96. package/skills/web-design/claude-code/defs/video-compositions.md +37 -0
  97. package/skills/web-design/claude-code/defs/video-motions/01-animation-basic.md +49 -0
  98. package/skills/web-design/claude-code/defs/video-motions/02-animation.md +52 -0
  99. package/skills/web-design/claude-code/defs/video-motions/03-reference.md +17 -0
  100. package/skills/web-design/claude-code/defs/video-motions/05-pattern-composition.md +61 -0
  101. package/skills/web-design/claude-code/defs/video-motions/06-transition-effects.md +49 -0
  102. package/skills/web-design/claude-code/defs/video-motions/07-audio-sync.md +29 -0
  103. package/skills/web-design/claude-code/defs/video-motions.md +55 -0
  104. package/skills/web-design/claude-code/defs/web-layouts/01-landing.md +101 -0
  105. package/skills/web-design/claude-code/defs/web-layouts/02-dashboard.md +85 -0
  106. package/skills/web-design/claude-code/defs/web-layouts/03-ecommerce.md +73 -0
  107. package/skills/web-design/claude-code/defs/web-layouts/04-blog.md +69 -0
  108. package/skills/web-design/claude-code/defs/web-layouts/05-saas.md +83 -0
  109. package/skills/web-design/claude-code/defs/web-layouts/06-portfolio.md +62 -0
  110. package/skills/web-design/claude-code/defs/web-layouts.md +38 -0
  111. package/skills/web-design/claude-code/defs/web-motions/01-landing.md +91 -0
  112. package/skills/web-design/claude-code/defs/web-motions/02-dashboard.md +55 -0
  113. package/skills/web-design/claude-code/defs/web-motions/03-ecommerce.md +52 -0
  114. package/skills/web-design/claude-code/defs/web-motions/04-blog.md +57 -0
  115. package/skills/web-design/claude-code/defs/web-motions/05-saas.md +49 -0
  116. package/skills/web-design/claude-code/defs/web-motions/06-portfolio.md +73 -0
  117. package/skills/web-design/claude-code/defs/web-motions/08-intensity-preset-motion.md +14 -0
  118. package/skills/web-design/claude-code/defs/web-motions.md +55 -0
  119. package/skills/web-design/claude-code/gen/gen-design-guide/01-project-overview.md +304 -0
  120. package/skills/web-design/claude-code/gen/gen-design-guide-interaction/01-interaction-motion.md +129 -0
  121. package/skills/web-design/claude-code/gen/gen-design-guide-interaction/04-project-video.md +69 -0
  122. package/skills/web-design/claude-code/gen/gen-design-guide-interaction.md +45 -0
  123. package/skills/web-design/claude-code/gen/gen-design-guide.md +43 -0
  124. package/skills/web-design/claude-code/gen/gen-tokens/01-generate-process.md +318 -0
  125. package/skills/web-design/claude-code/gen/gen-tokens/02-structure-output-file.md +31 -0
  126. package/skills/web-design/claude-code/gen/gen-tokens/03-connect-frontend.md +150 -0
  127. package/skills/web-design/claude-code/gen/gen-tokens.md +54 -0
  128. package/skills/web-design/claude-code/gen/gen-video.md +73 -0
  129. package/skills/web-design/claude-code/verify/verify-components.md +52 -0
  130. package/skills/web-design/claude-code/verify/verify-motions.md +74 -0
  131. package/skills/web-design/claude-code/verify/verify-pipeline.md +69 -0
  132. package/skills/web-design/claude-code/verify/verify-report.md +75 -0
  133. package/skills/web-design/claude-code/verify/verify-responsive.md +49 -0
  134. package/skills/web-design/claude-code/verify/verify-tokens.md +84 -0
  135. package/skills/test-skill/claude-code/SKILL.md +0 -7
  136. package/skills/test-skill/cursor/test-skill.md +0 -7
  137. package/skills/test-skill/openclaw/SKILL.md +0 -13
  138. package/skills/test-skill/skill.json +0 -6
@@ -0,0 +1,55 @@
1
+ # 5. 게임 (`game`)
2
+
3
+
4
+ ### DG-M1. Immersive Desktop (몰입형 데스크톱)
5
+
6
+ ```
7
+ 기법: 풀스크린 전환, 파티클, 셰이더 이펙트
8
+ 포함: fullscreen-transition | particle-system | shader-effect | camera-shake
9
+
10
+ Fullscreen:
11
+ [windowed] ──F11→ [fullscreen] (zoom + fade, 500ms)
12
+
13
+ Impact: 💥 particle burst + screen shake
14
+ Ambient: ✨ floating particles (continuous)
15
+
16
+ 강도: dramatic
17
+ 적합: PC 게임, 인터랙티브 시뮬레이션
18
+ 특징: GPU 가속 필수, WebGL/Canvas 활용
19
+ ```
20
+
21
+ ### DG-M2. Menu & HUD (메뉴 & HUD)
22
+
23
+ ```
24
+ 기법: 게임 메뉴 애니메이션, HUD 전환
25
+ 포함: menu-cascade | hud-fade | health-bar | minimap-pulse
26
+
27
+ Main Menu:
28
+ [New Game] ─── 0ms ───→ slide-in
29
+ [Continue] ─── 80ms ──→ slide-in
30
+ [Settings] ─── 160ms ─→ slide-in
31
+ [Exit] ─── 240ms ─→ slide-in
32
+
33
+ HUD: fade-in on game start (500ms)
34
+ Health: smooth bar decrease (300ms)
35
+
36
+ 강도: moderate ~ dramatic
37
+ 적합: 모든 데스크톱 게임
38
+ ```
39
+
40
+ ### DG-M3. Casual & Light (캐주얼 경량)
41
+
42
+ ```
43
+ 기법: 가벼운 애니메이션, 보상 이펙트
44
+ 포함: bounce-tap | reward-confetti | score-popup | combo-flash
45
+
46
+ Score: +100 ← float up + fade (400ms)
47
+ Reward: 🎉 confetti burst (800ms)
48
+ Combo: x5! ← scale punch + glow (300ms)
49
+
50
+ 강도: moderate
51
+ 적합: 퍼즐, 캐주얼 게임, 교육용 게임
52
+ ```
53
+
54
+ ---
55
+
@@ -0,0 +1,52 @@
1
+ # 6. 비즈니스 (`business`)
2
+
3
+
4
+ ### DB-M1. Professional Polish (프로페셔널)
5
+
6
+ ```
7
+ 기법: 절제된 전환, 명확한 피드백
8
+ 포함: page-crossfade | form-validation | button-feedback | modal-scale
9
+
10
+ Page transition: crossfade (200ms, ease)
11
+ Modal: scale(0.95→1.0) + fade (250ms)
12
+ Form error: shake input (200ms) + red border
13
+
14
+ 강도: subtle
15
+ 적합: ERP, CRM, 회계 소프트웨어
16
+ 특징: 빈번한 조작에 방해 없는 수준
17
+ ```
18
+
19
+ ### DB-M2. Dashboard Live (대시보드 라이브)
20
+
21
+ ```
22
+ 기법: 실시간 데이터 업데이트, KPI 카운트
23
+ 포함: kpi-count-up | chart-update | status-badge | refresh-spin
24
+
25
+ KPI: $0 → $45,230 (count-up, 1.2s)
26
+ Chart: smooth data point transition (400ms)
27
+ Status: [Active] green pulse (infinite, subtle)
28
+ Refresh: ↻ spin (500ms)
29
+
30
+ 강도: moderate
31
+ 적합: 비즈니스 대시보드, 리포트 도구
32
+ ```
33
+
34
+ ### DB-M3. Workflow & Process (워크플로우)
35
+
36
+ ```
37
+ 기법: 단계별 프로세스 전환, 승인/반려 피드백
38
+ 포함: step-progress | approval-check | reject-shake | pipeline-flow
39
+
40
+ Workflow:
41
+ ①━━●━━②━━○━━③━━○━━④━━○
42
+ ████████████░░░░░░░░░░░░░░░
43
+
44
+ Approve: ✅ green flash + confetti (subtle)
45
+ Reject: ❌ red shake + return animation
46
+
47
+ 강도: subtle ~ moderate
48
+ 적합: 결재 시스템, 프로젝트 관리, 파이프라인
49
+ ```
50
+
51
+ ---
52
+
@@ -0,0 +1,75 @@
1
+ # PC앱 모션/인터랙션 패턴 정의
2
+
3
+ > 참조 위치: `stages/stage2-desktop-motion.md`에서 분기 사용
4
+ > app_type별 추천 모션 패턴 정의 (Electron / Tauri / Native)
5
+ > Dependencies: 없음 (독립 참조 데이터)
6
+
7
+ ---
8
+
9
+ ## 공통 모션 카테고리
10
+
11
+ | 카테고리 | 설명 |
12
+ |----------|------|
13
+ | **Window Transition** | 윈도우 열기/닫기, 최소화, 최대화 전환 |
14
+ | **Panel & Layout** | 사이드바, 탭, 분할 패널 전환 |
15
+ | **System Integration** | 트레이, 알림, 글로벌 단축키 피드백 |
16
+ | **Data & Content** | 데이터 로딩, 업데이트, 리스트 전환 |
17
+ | **Micro-interaction** | 버튼, 입력, 토글 등 소규모 피드백 |
18
+
19
+ ---
20
+
21
+ ## 1. 유틸리티/도구 (`utility`)
22
+
23
+ > 상세: `defs/desktop-motions/01-utility.md` 참조
24
+
25
+ 기법: 즉각적 피드백, 최소 딜레이
26
+ ## 2. 데이터 관리 (`data`)
27
+
28
+ > 상세: `defs/desktop-motions/02-data.md` 참조
29
+
30
+ 기법: 테이블 행/열 추가·삭제·정렬 애니메이션
31
+ ## 3. 크리에이티브 (`creative`)
32
+
33
+ > 상세: `defs/desktop-motions/03-creative.md` 참조
34
+
35
+ 기법: 캔버스 줌/팬, 레이어 전환, 도구 선택 피드백
36
+ ## 4. 커뮤니케이션 (`communication`)
37
+
38
+ > 상세: `defs/desktop-motions/04-communication.md` 참조
39
+
40
+ 기법: 메시지 등장, 타이핑 상태, 읽음 표시
41
+ ## 5. 게임 (`game`)
42
+
43
+ > 상세: `defs/desktop-motions/05-game.md` 참조
44
+
45
+ 기법: 풀스크린 전환, 파티클, 셰이더 이펙트
46
+ ## 6. 비즈니스 (`business`)
47
+
48
+ > 상세: `defs/desktop-motions/06-business.md` 참조
49
+
50
+ 기법: 절제된 전환, 명확한 피드백
51
+ ## 데스크톱 전용 시스템 모션
52
+
53
+ 모든 앱 유형에 공통 적용 가능:
54
+
55
+ | 모션 | 설명 | 구현 |
56
+ |------|------|------|
57
+ | **Window Open** | 창 열기 (scale 0.95→1.0 + fade) | CSS + Electron BrowserWindow |
58
+ | **Tray Animation** | 트레이 아이콘 펄스/뱃지 | Electron tray.setImage sequence |
59
+ | **Minimize to Tray** | 창 축소 → 트레이 (scale down) | BrowserWindow animate |
60
+ | **Splash Screen** | 스플래시 로딩 → 메인 전환 | Overlay fade-out |
61
+ | **Global Shortcut** | 단축키 호출 시 윈도우 등장 | slide-down or fade-in |
62
+
63
+ ---
64
+
65
+ ## 모션 강도 프리셋 (데스크톱)
66
+
67
+ | 프리셋 | `motion_intensity` | duration | easing | 설명 |
68
+ |--------|-------------------|----------|--------|------|
69
+ | **Subtle** | `subtle` | 100-250ms | ease-out | 빠르고 정확, 비즈니스/유틸 |
70
+ | **Moderate** | `moderate` | 250-500ms | ease-in-out | 균형, 범용 |
71
+ | **Dramatic** | `dramatic` | 500-1000ms | cubic-bezier | 임팩트, 게임/크리에이티브 |
72
+ | **None** | `none` | 0ms | - | 모션 없음, 성능 우선 |
73
+
74
+ > `prefers-reduced-motion` 자동 대응
75
+ > Electron: `systemPreferences.getAnimationSettings()` 활용
@@ -0,0 +1,81 @@
1
+ # 1. 웹 + 모바일 (`web_mobile`)
2
+
3
+
4
+ ### hybrid_wm_responsive — 반응형 적응 (Responsive Adaptive)
5
+
6
+ ```
7
+ Desktop (≥1024px) Tablet (768-1023px) Mobile (<768px)
8
+ ┌──────┬──────────┐ ┌──────────────────┐ ┌──────────────┐
9
+ │ │ │ │ [≡] Title [🔍] │ │ [≡] Title [🔍]│
10
+ │ Side │ Main │ ├──────────────────┤ ├──────────────┤
11
+ │ bar │ Content │ │ │ │ │
12
+ │ │ │ │ Main Content │ │ Main Content │
13
+ │ │ │ │ │ │ (풀 와이드) │
14
+ │ │ │ │ │ │ │
15
+ └──────┴──────────┘ └──────────────────┘ ├──────────────┤
16
+ │ [🏠][🔍][👤][⚙️]│
17
+ └──────────────┘
18
+
19
+ 웹: sidebar navigation 태블릿: hamburger menu 모바일: bottom tab
20
+ ```
21
+
22
+ - **특징**: 단일 코드베이스, 브레이크포인트별 레이아웃 전환
23
+ - **적합**: 콘텐츠 앱, 뉴스, 블로그, SaaS 대시보드
24
+ - **네비**: Desktop=sidebar → Tablet=hamburger → Mobile=bottom tab
25
+ - **구현**: CSS Grid/Flexbox + @media, React Responsive
26
+
27
+ ### hybrid_wm_shell — 공유 앱 셸 (Shared App Shell)
28
+
29
+ ```
30
+ Web Mobile (PWA/Native)
31
+ ┌─────────────────────────┐ ┌──────────────┐
32
+ │ [Logo] [Nav] [Nav] [👤] │ │ [←] Title │
33
+ ├─────────────────────────┤ ├──────────────┤
34
+ │ │ │ │
35
+ │ App Shell (공유) │ │ App Shell │
36
+ │ ┌───────────────┐ │ │ (공유 로직) │
37
+ │ │ Page Content │ │ │ │
38
+ │ │ (라우터 기반) │ │ │ │
39
+ │ └───────────────┘ │ │ │
40
+ │ │ ├──────────────┤
41
+ └─────────────────────────┘ │ [🏠][📋][💬][👤]│
42
+ └──────────────┘
43
+
44
+ 공유: Router, State, API Layer
45
+ 분리: Navigation Shell, Native Features
46
+ ```
47
+
48
+ - **특징**: 앱 셸 구조 공유, 네비게이션 셸만 플랫폼별 분리
49
+ - **적합**: PWA + 네이티브 앱, SaaS 멀티플랫폼
50
+ - **네비**: Web=top nav → Mobile=bottom tab + stack
51
+ - **구현**: Next.js + React Native / Capacitor / Expo
52
+
53
+ ### hybrid_wm_split — 플랫폼 특화 (Platform-Specific)
54
+
55
+ ```
56
+ Web (전용 레이아웃) Mobile (전용 레이아웃)
57
+ ┌─────────────────────────┐ ┌──────────────┐
58
+ │ [Top Navigation Bar ] │ │ [← Back] ≡ │
59
+ ├──────┬──────────────────┤ ├──────────────┤
60
+ │ │ Hero Section │ │ ┌──────────┐ │
61
+ │ Side │ ───────────── │ │ │ Card 1 │ │
62
+ │ bar │ Feature Grid │ │ └──────────┘ │
63
+ │ / │ ───────────── │ │ ┌──────────┐ │
64
+ │ TOC │ Content Area │ │ │ Card 2 │ │
65
+ │ │ ───────────── │ │ └──────────┘ │
66
+ │ │ Footer │ │ pull-refresh │
67
+ ├──────┴──────────────────┤ ├──────────────┤
68
+ │ [Footer] │ │ [🏠][🔍][+][💬][👤]│
69
+ └─────────────────────────┘ └──────────────┘
70
+
71
+ 공유: API, 데이터 모델, 비즈니스 로직
72
+ 분리: 레이아웃, 네비게이션, 인터랙션 전부
73
+ ```
74
+
75
+ - **특징**: 각 플랫폼 완전 독립 레이아웃, 데이터/API만 공유
76
+ - **적합**: 웹=정보 풍부, 모바일=핵심 기능 집중
77
+ - **네비**: 완전 독립 (각 플랫폼 최적)
78
+ - **구현**: Web(Next.js) + Mobile(React Native) 별도
79
+
80
+ ---
81
+
@@ -0,0 +1,78 @@
1
+ # 2. 웹 + PC (`web_desktop`)
2
+
3
+
4
+ ### hybrid_wd_unified — 통합 (Unified Web-Desktop)
5
+
6
+ ```
7
+ Web (브라우저) Desktop (Electron/Tauri)
8
+ ┌─────────────────────────┐ ┌─────────────────────────┐
9
+ │ [Tab] [Tab] [Tab] [+] │ │ [Custom Titlebar] ─ □ ✕ │
10
+ ├─────────────────────────┤ ├─────────────────────────┤
11
+ │ [Logo] [Nav] [Nav] [👤] │ │ [Logo] [Nav] [Nav] [👤] │
12
+ ├─────────────────────────┤ ├─────────────────────────┤
13
+ │ │ │ │
14
+ │ 동일한 레이아웃 │ │ 동일한 레이아웃 │
15
+ │ (웹 기술 기반) │ │ + 네이티브 윈도우 │
16
+ │ │ │ + 트레이 아이콘 │
17
+ │ │ │ + 파일시스템 접근 │
18
+ └─────────────────────────┘ └─────────────────────────┘
19
+
20
+ 차이점: Titlebar, System Tray, File Access, Global Shortcuts
21
+ ```
22
+
23
+ - **특징**: 동일 웹 UI를 데스크톱 래퍼로 감싸는 구조
24
+ - **적합**: Notion, Slack, Figma 스타일 (웹=데스크톱 동일)
25
+ - **네비**: 완전 동일 (데스크톱에서 커스텀 타이틀바만 추가)
26
+ - **구현**: Web + Electron/Tauri wrap
27
+
28
+ ### hybrid_wd_enhanced — 데스크톱 확장 (Desktop Enhanced)
29
+
30
+ ```
31
+ Web (기본 기능) Desktop (확장 기능)
32
+ ┌─────────────────────────┐ ┌─────────────────────────┐
33
+ │ [Nav Bar] │ │ [Custom Titlebar] ─ □ ✕ │
34
+ ├─────────────────────────┤ ├──────┬──────────────────┤
35
+ │ │ │ │ │
36
+ │ Core Features │ │ Ext │ Core Features │
37
+ │ (핵심 기능만) │ │ Side │ + Extended │
38
+ │ │ │ bar │ Features │
39
+ │ │ │ │ (파일 연동 등) │
40
+ └─────────────────────────┘ └──────┴──────────────────┘
41
+
42
+ 웹: 핵심 기능 (브라우저 제한 내)
43
+ 데스크톱: 핵심 + 파일시스템 + 플러그인 + 오프라인
44
+ ```
45
+
46
+ - **특징**: 웹 기본 기능 + 데스크톱에서 네이티브 기능 확장
47
+ - **적합**: 코드 에디터(VS Code), 디자인 도구, 문서 편집기
48
+ - **네비**: Web=간소화 → Desktop=확장 사이드바
49
+ - **구현**: Web Core + Electron/Tauri extension API
50
+
51
+ ### hybrid_wd_companion — 웹 대시보드 + 데스크톱 에이전트 (Dashboard & Agent)
52
+
53
+ ```
54
+ Web (대시보드/관리) Desktop (백그라운드 에이전트)
55
+ ┌─────────────────────────┐ ┌───────────────────┐
56
+ │ [Dashboard] │ │ [≡] Agent [─][✕]│
57
+ ├──────┬──────────────────┤ ├───────────────────┤
58
+ │ │ ┌──────┐┌──────┐ │ │ Status: Running │
59
+ │ Nav │ │ KPI ││ KPI │ │ │ ── ── ── ── ── │
60
+ │ │ └──────┘└──────┘ │ │ [Start] [Stop] │
61
+ │ │ ┌──────────────┐ │ │ ── ── ── ── ── │
62
+ │ │ │ Chart │ │ │ Log: │
63
+ │ │ └──────────────┘ │ │ > Task running...│
64
+ └──────┴──────────────────┘ │ > Complete │
65
+ └───────────────────┘
66
+ + System Tray Icon
67
+
68
+ 웹: 설정, 모니터링, 리포트
69
+ 데스크톱: 백그라운드 실행, 트레이 상주
70
+ ```
71
+
72
+ - **특징**: 웹=관리/모니터링, 데스크톱=에이전트/백그라운드 작업
73
+ - **적합**: 백업 도구, 동기화, CI/CD 모니터, 시스템 관리
74
+ - **네비**: Web=풀 대시보드 / Desktop=미니 UI + 트레이
75
+ - **구현**: Web Dashboard + Electron/Tauri background service
76
+
77
+ ---
78
+
@@ -0,0 +1,79 @@
1
+ # 3. 모바일 + PC (`mobile_desktop`)
2
+
3
+
4
+ ### hybrid_md_companion — 컴패니언 (Companion Pair)
5
+
6
+ ```
7
+ Mobile (경량) Desktop (풀 기능)
8
+ ┌──────────────┐ ┌─────────────────────────┐
9
+ │ [Title] ≡ │ │ [Titlebar] ─ □ ✕ │
10
+ ├──────────────┤ ├──────┬──────────────────┤
11
+ │ │ │ │ │
12
+ │ Quick View │ sync ↔ │ Full │ Full Feature │
13
+ │ (핵심만) │ │ Nav │ View │
14
+ │ │ │ │ │
15
+ │ [Quick Act] │ │ │ │
16
+ ├──────────────┤ └──────┴──────────────────┘
17
+ │ [🏠][📋][👤] │
18
+ └──────────────┘
19
+
20
+ 모바일: 조회 + 빠른 액션 중심
21
+ 데스크톱: 편집 + 관리 + 분석 중심
22
+ ```
23
+
24
+ - **특징**: 모바일=경량 조회/액션, 데스크톱=풀 기능/관리
25
+ - **적합**: 메신저(모바일) + 관리자(PC), 필드 앱 + 오피스 앱
26
+ - **네비**: Mobile=bottom tab / Desktop=sidebar
27
+ - **구현**: React Native + Electron (공유 API layer)
28
+
29
+ ### hybrid_md_mirrored — 미러링 (Mirrored Experience)
30
+
31
+ ```
32
+ Mobile Desktop
33
+ ┌──────────────┐ ┌─────────────────────────┐
34
+ │ [Title] [≡] │ │ [Nav Bar] [👤] │
35
+ ├──────────────┤ ├─────────────────────────┤
36
+ │ ┌──────────┐ │ │ ┌──────────┐┌─────────┐ │
37
+ │ │ Card A │ │ 동일 구조 │ │ Card A ││ Card B │ │
38
+ │ └──────────┘ │ ↔ │ └──────────┘└─────────┘ │
39
+ │ ┌──────────┐ │ │ ┌──────────┐┌─────────┐ │
40
+ │ │ Card B │ │ │ │ Card C ││ Card D │ │
41
+ │ └──────────┘ │ │ └──────────┘└─────────┘ │
42
+ ├──────────────┤ └─────────────────────────┘
43
+ │ [🏠][📋][💬][👤]│
44
+ └──────────────┘
45
+ 모바일: 1열 스택 데스크톱: 2-3열 그리드
46
+ ```
47
+
48
+ - **특징**: 동일 정보 구조, 화면 크기에 따라 그리드 재배치
49
+ - **적합**: 소셜 앱, 게임, 쇼핑, 학습 플랫폼
50
+ - **네비**: Mobile=bottom tab / Desktop=top nav (동일 구조)
51
+ - **구현**: 공유 컴포넌트 + 반응형 레이아웃
52
+
53
+ ### hybrid_md_role — 역할 분리 (Role-Based)
54
+
55
+ ```
56
+ Mobile (Consumer) Desktop (Producer)
57
+ ┌──────────────┐ ┌─────────────────────────┐
58
+ │ [Feed] │ │ [Menu] [Toolbar] │
59
+ ├──────────────┤ ├──────┬──────────────────┤
60
+ │ ┌──────────┐ │ │ │ │
61
+ │ │ Content │ │ 다른 UX │ Edit │ Editor / │
62
+ │ │ (소비) │ │ ↔ │ Nav │ Creator View │
63
+ │ └──────────┘ │ │ │ (생산) │
64
+ │ ┌──────────┐ │ │ │ │
65
+ │ │ Content │ │ │ │ │
66
+ │ └──────────┘ │ └──────┴──────────────────┘
67
+ ├──────────────┤
68
+ │ [🏠][🔍][+][💬]│
69
+ └──────────────┘
70
+ 모바일: 소비/브라우징 데스크톱: 생산/편집
71
+ ```
72
+
73
+ - **특징**: 플랫폼별 완전히 다른 UX 역할
74
+ - **적합**: YouTube(시청 vs 스튜디오), 교육(학습 vs 제작)
75
+ - **네비**: 완전 독립 (역할에 최적화)
76
+ - **구현**: 공유 API/데이터 + 독립 UI 레이어
77
+
78
+ ---
79
+
@@ -0,0 +1,81 @@
1
+ # 4. 전체 플랫폼 (`all` = 웹 + 모바일 + PC)
2
+
3
+
4
+ ### hybrid_all_atomic — 아토믹 디자인 (Atomic Design System)
5
+
6
+ ```
7
+ Atoms → Molecules → Organisms → Templates → Pages
8
+
9
+ [Button] [Input] [Icon] ← Atoms (전 플랫폼 공유)
10
+
11
+ [SearchBar] [Card] [NavItem] ← Molecules (전 플랫폼 공유)
12
+
13
+ [Header] [Sidebar] [ProductList] ← Organisms (플랫폼별 조합)
14
+
15
+ [DashboardTemplate] ← Templates (플랫폼별 레이아웃)
16
+
17
+ Web Mobile Desktop
18
+ ┌────────┐ ┌────────┐ ┌────────┐ ← Pages (플랫폼별)
19
+ │Dashboard│ │Dashboard│ │Dashboard│
20
+ └────────┘ └────────┘ └────────┘
21
+ ```
22
+
23
+ - **특징**: 아토믹 디자인 시스템으로 컴포넌트 공유 극대화
24
+ - **적합**: 대규모 서비스, 디자인 시스템 구축 우선
25
+ - **네비**: 플랫폼별 네이티브 패턴
26
+ - **구현**: Design System + 플랫폼별 Template/Page
27
+
28
+ ### hybrid_all_adaptive — 적응형 레이아웃 (Adaptive Layout)
29
+
30
+ ```
31
+ Mobile (<768) Tablet (768-1024) Desktop (≥1024)
32
+ ┌──────────────┐ ┌──────────────────┐ ┌──────┬──────────┐
33
+ │ [≡] Title │ │ [≡] Title [🔍] │ │ Side │ Main │
34
+ ├──────────────┤ ├──────────────────┤ │ bar │ Content │
35
+ │ Content │ │ Content │Extra│ │ │ │
36
+ │ (1 column) │ │ (2 columns)│ │ │ │ │
37
+ ├──────────────┤ └──────────────────┘ └──────┴──────────┘
38
+ │ [Tab Bar] │
39
+ └──────────────┘ Desktop App (Electron/Tauri)
40
+ ┌──────────────────────────────┐
41
+ │ [Custom Titlebar] ─ □ ✕ │
42
+ │ = Desktop 레이아웃 + 네이티브 │
43
+ └──────────────────────────────┘
44
+
45
+ 브레이크포인트로 전체 제어
46
+ ```
47
+
48
+ - **특징**: 브레이크포인트 기반 단일 반응형 + 데스크톱 래핑
49
+ - **적합**: 범용 서비스, MVP, 점진적 플랫폼 확장
50
+ - **네비**: Mobile=bottom → Tablet=top → Desktop=sidebar
51
+ - **구현**: Responsive Web + PWA + Electron/Tauri wrap
52
+
53
+ ### hybrid_all_optimized — 플랫폼 최적화 (Platform-Optimized)
54
+
55
+ ```
56
+ 각 플랫폼 완전 독립 최적화:
57
+
58
+ Web Mobile Desktop
59
+ ┌────────────┐ ┌──────────┐ ┌──────────────┐
60
+ │ SEO 최적화 │ │ 터치 최적화│ │ 생산성 최적화 │
61
+ │ 정보 풍부 │ │ 오프라인 │ │ 멀티 윈도우 │
62
+ │ 반응형 │ │ 푸시알림 │ │ 키보드 중심 │
63
+ └────────────┘ └──────────┘ └──────────────┘
64
+ │ │ │
65
+ └─────────────────┼───────────────────┘
66
+
67
+ Shared API / Data Layer
68
+ Shared Business Logic
69
+ Shared Design Tokens
70
+
71
+ 공유: API, 비즈니스 로직, 디자인 토큰
72
+ 분리: UI 레이아웃, 네비게이션, 인터랙션
73
+ ```
74
+
75
+ - **특징**: 각 플랫폼 최적 UX 제공, 데이터/로직만 공유
76
+ - **적합**: 글로벌 서비스, 대기업 제품, 최상위 UX 요구
77
+ - **네비**: 각 플랫폼 네이티브 최적
78
+ - **구현**: Monorepo + 공유 패키지 + 플랫폼별 UI
79
+
80
+ ---
81
+
@@ -0,0 +1,49 @@
1
+ # 혼합(멀티플랫폼) 레이아웃 패턴 정의
2
+
3
+ > 참조 위치: `stages/stage2-hybrid-layout.md`에서 분기 사용
4
+ > platform_combo별 크로스플랫폼 레이아웃 전략 정의
5
+ > Dependencies: 없음 (독립 참조 데이터)
6
+
7
+ ---
8
+
9
+ ## 핵심 원칙
10
+
11
+ 멀티플랫폼 레이아웃은 **공유 구조**와 **플랫폼 최적화** 사이의 균형:
12
+
13
+ | 원칙 | 설명 |
14
+ |------|------|
15
+ | **Shared Layout DNA** | 정보 구조(IA)는 공유, 구현은 플랫폼별 최적화 |
16
+ | **Responsive Breakpoints** | 화면 크기별 레이아웃 자동 적응 |
17
+ | **Component Mapping** | 동일 컴포넌트 → 플랫폼별 네이티브 위젯 매핑 |
18
+ | **Navigation Adaptation** | 네비게이션 패턴을 플랫폼 관례에 맞게 변환 |
19
+
20
+ ---
21
+
22
+ ## 1. 웹 + 모바일 (`web_mobile`)
23
+
24
+ > 상세: `defs/hybrid-layouts/01-web_mobile.md` 참조
25
+
26
+ Desktop (≥1024px) Tablet (768-1023px) Mobile (<768px)
27
+ ## 2. 웹 + PC (`web_desktop`)
28
+
29
+ > 상세: `defs/hybrid-layouts/02-web_desktop.md` 참조
30
+
31
+ Web (브라우저) Desktop (Electron/Tauri)
32
+ ## 3. 모바일 + PC (`mobile_desktop`)
33
+
34
+ > 상세: `defs/hybrid-layouts/03-mobile_desktop.md` 참조
35
+
36
+ Mobile (경량) Desktop (풀 기능)
37
+ ## 4. 전체 플랫폼 (`all` = 웹 + 모바일 + PC)
38
+
39
+ > 상세: `defs/hybrid-layouts/04-all.md` 참조
40
+
41
+ Atoms → Molecules → Organisms → Templates → Pages
42
+ ## 핵심 화면 구성 참조
43
+
44
+ | 플랫폼 조합 | 공유 화면 | 플랫폼 전용 화면 |
45
+ |------------|----------|-----------------|
46
+ | web_mobile | 홈, 목록, 상세, 프로필, 설정 | Web: 풀 대시보드 / Mobile: 바텀시트, 스와이프 |
47
+ | web_desktop | 대시보드, 설정, 프로필 | Web: 반응형 / Desktop: 트레이, 멀티윈도우 |
48
+ | mobile_desktop | 메인 기능, 동기화 | Mobile: 터치UI / Desktop: 키보드+마우스UI |
49
+ | all | 인증, 프로필, 핵심 기능 | 각 플랫폼별 네비게이션 셸 |
@@ -0,0 +1,69 @@
1
+ # 1. 웹 + 모바일 (`web_mobile`)
2
+
3
+
4
+ ### WM-M1. Adaptive Responsive (적응형 반응)
5
+
6
+ ```
7
+ 기법: 뷰포트별 모션 자동 적응
8
+ 전략: 웹과 모바일에서 동일한 모션 의도, 구현만 차이
9
+
10
+ Web (마우스): Mobile (터치):
11
+ ┌─────────────┐ ┌──────────┐
12
+ │ hover effect│ │ tap effect│
13
+ │ scroll anim │ │ swipe │
14
+ │ cursor trail│ │ pull- │
15
+ └─────────────┘ │ refresh │
16
+ └──────────┘
17
+
18
+ 공유 토큰:
19
+ --motion-duration-fast: 200ms
20
+ --motion-duration-normal: 400ms
21
+ --motion-easing-default: cubic-bezier(0.4, 0, 0.2, 1)
22
+
23
+ 강도: moderate
24
+ 적합: 반응형 웹앱, PWA
25
+ 구현: CSS @media + JS matchMedia
26
+ ```
27
+
28
+ ### WM-M2. Shared Scroll & Touch (공유 스크롤 & 터치)
29
+
30
+ ```
31
+ 기법: 스크롤 기반 공유 + 터치 전용 제스처 확장
32
+ 전략: Scroll = 공통 / Touch Gesture = 모바일 전용
33
+
34
+ Common (Scroll):
35
+ - Scroll Reveal (fade-up on viewport enter)
36
+ - Parallax (layer speed difference)
37
+ - Reading Progress bar
38
+
39
+ Mobile Only (Touch):
40
+ - Pull to Refresh (↓ drag → refresh)
41
+ - Swipe Actions (← swipe → delete/archive)
42
+ - Pinch Zoom (two-finger zoom)
43
+
44
+ 강도: moderate
45
+ 적합: 콘텐츠 앱, 뉴스, 블로그
46
+ 구현: Intersection Observer (공통) + Touch Events (모바일)
47
+ ```
48
+
49
+ ### WM-M3. Platform Unified (플랫폼 통일)
50
+
51
+ ```
52
+ 기법: 모든 플랫폼에서 완전히 동일한 모션
53
+ 전략: 웹 기술 기반으로 통일 (React Native Web / Capacitor)
54
+
55
+ 모든 플랫폼 동일:
56
+ - Page transition: slide-left (300ms)
57
+ - Modal: fade + scale (250ms)
58
+ - List: stagger fade-up (50ms delay)
59
+ - Button: scale(0.97) on press (100ms)
60
+
61
+ 차이점 없음 (브랜드 일관성 최우선)
62
+
63
+ 강도: subtle ~ moderate
64
+ 적합: 브랜드 앱, 마케팅 앱
65
+ 구현: Framer Motion / React Native Reanimated 공유
66
+ ```
67
+
68
+ ---
69
+