Decision Map · 2026-05-04

외주(로건) DS
× DESIGN.md 결정 매핑

제품 · 홈페이지 · 브랜드 에셋 셋이 같은 시스템에서 작동하도록, 21개 결정을 4-layer 구조에 매핑.

SOURCE: Codex 분석.html × Claude Code 분석.html × DESIGN.md (1982 lines)
21
결정 항목
7
DESIGN.md에 이미 정의
8
부분 정의 — 확장 결정
6
신규 결정 필요
투표자
이름을 입력해서 투표를 시작하세요 →
— / 0

사용법: 투표자 추가 → 활성 투표자 선택(클릭) → 옵션(A/B/C) 클릭으로 투표 (같은 옵션 다시 클릭 = 취소) → 결정마다 코멘트 작성·저장. 표·코멘트는 Supabase에 저장돼 모든 사용자에 실시간 공유.

DESIGN.md §X.Y 가 뭔지 모를 때 펼쳐보기

이 페이지의 결정은 DESIGN.md(업스DS 마스터 문서)의 특정 섹션을 갱신·확장하는 형태로 반영됩니다. 본문 안의 §X.Y 표시 위에 마우스를 올리면 풀이가 나옵니다.

§2.1Color Primitive — 원시 컬러 팔레트 (HSL)
§2.2Semantic Tokens — Light/Dark 의미 토큰
§2.3Component Tokens — Product UI 전용
§2.4Marketing Material Colors — 플라이어·브로셔 전용
§3.1Font Stack — Plus Jakarta Sans / Geist / Noto Sans KR
§3.2CSS Custom Properties — 폰트 토큰 정의
§3.3Type Scale (Product) — 콘솔 UI 폰트
§3.4Type Scale (Marketing) — 랜딩·광고 폰트
§3.5Type Scale (A4 Print) — 인쇄물 폰트
§3.12Cross-Media Typography — 미디엄별 비율 통일
§3.13Known Constraints — 한글·라벨 충돌 처리
§4Spacing/Layout/Radius — 간격·그리드·라디우스
§5AProduct Components — 콘솔 UI 컴포넌트
§5BMarketing Components — 플라이어·슬라이드
§8Iconography & Imagery — 로고·이미지
§11Page Type Templates — 페이지 종류 정의
§13Figma↔Code Token Mapping — 토큰 매핑 정책
§5C / §8B / §14신규 제안 섹션 (현 DESIGN.md에 없음, 결정 후 추가될 자리)
전체 목차는 DESIGN.md에서 확인. 이 페이지는 그 중 결정 필요 항목만 시각화.

014-Layer 구조 — L1, L2, L3, L4가 뭔지

DESIGN.md는 이미 셋(제품·홈페이지·에셋) 공통 시스템을 4-layer로 분리. 결정의 위치가 어느 layer냐에 따라 셋에 미치는 영향이 달라집니다.

L1 PRIMITIVE

원시 토큰

DESIGN.md §2.1, §3.1§3.2, §4 scale
셋 공통 단일값. 충돌하면 양자택일. 분기 금지.
예시
--color-brand-500: #5A52FF
--font-headline
4 / 8 / 12 / 16px
L2 SEMANTIC

의미 토큰

DESIGN.md §2.2, §3.6, §3.12 비율
셋 공통 추상화. 컨텍스트 무관. "primary", "border-medium" 같은 의미만.
예시
--primary
--border-medium
Body 1× → Hero 1.5–2.0×
L3 CROSS-MEDIA

미디엄 변환

DESIGN.md §3.12, §3.13
비율 통일, 절댓값만 변환. Web/Print/Slide/Social 미디엄별 단위 다름.
예시
Body 16px (Web) ↔ 9pt (Print) ↔ 24px (Social)
Marketing Hero 4.5–5.5×
L4 CONTEXT

컨텍스트별 분기

DESIGN.md §2.3, §2.4, §3.3/§3.4/§3.5, §5A/§5B
명시적 분기. Product / Marketing / Asset prefix 필수. "Hero" 단독 사용 금지.
예시
--ups-purple (Marketing only)
--button-normal-bg (Product)
Card (Standard) vs Card (Featured)
L1 L2 L3 L4 — 하위 layer 결정 후 상위 layer 도출

02마스터 매트릭스 — 21개 결정의 한눈 보기

각 항목이 어느 layer에 속하고, DESIGN.md 어느 §을 건드리는지, 현 상태가 어떤지.

ID항목LayerDESIGN.md 위치현 상태핵심 결정
A. Color · 컬러
A1Brand PrimaryL1+L4§2.1 + §2.4분기 존재#5A52FF · #5B52FF 통합 여부
A2Neutral PaletteL1+L4§2.1 + §2.4분기 존재240 hue zinc · ink scale 통합
A3Categorical 개수L1§2.110색 정의10 → 8 축소 여부
A4Categorical 이름L1§2.1 + §13정의됨coral/skyblue → orange/sky 표준화
A5Additional PurpleL4 → ?§2.4--ups-purple 정의L1으로 승격 여부
B. Typography · 타이포그래피
B1Display 70px HeroL3§3.4 + §3.1272–88px 정의70px 범위에 포함시키기
B2Body 18pxL4§3.3 + §3.4Product만 18px 있음Marketing 컨텍스트 허용 여부
B3Typography 20 compositeL3§3.3/§3.4/§3.5 + §3.12셋 공통 비율 정의(변경 없음 권고)
C. Layout / Spacing · 레이아웃
C1Layout Grid (max-width)L1§4Marketing/Asset 토큰 부재1200/1000/384 토큰 신설
C2Spacing ScaleL1§48단계11단계 확장 + 큰 값 처리
C3Figma↔Code 매핑 정책정책§13color만 정의spacing/radius 매핑 추가
C4Border RadiusL1§4Marketing만 12px12px를 Product에도 추가
D. Components · 컴포넌트
D1ButtonL4§5A + §5B?§5A 정의Marketing 호출 방식 / S·M·L
D2CardL4§5A + §5B§5B 정의width 384 명시 / border 통일
D3Leadform / InputL4§5A + §5B?§5A box만underline 패턴 신규 정의
D4Nav / FooterL4§5A + §5B웹 nav 미정의브랜드홈 web nav 위치
D5Section SystemL4§5Bhomeheader 미정의homeheader 추가 여부
D6Component Token 70개L4§2.3Product 70개70→28 + Marketing 영역
D7Border TierL2§2.26-tier 정의(유지 권고)
E. Migration · 마이그레이션
E1Alias 라이프사이클정책신규 §14정책 부재Deprecate 시점 + codemod
F. Asset · 자산
F1KV / Cover GraphicL4신규 §8B시스템 부재KV/Cover 시스템 신설

03DESIGN.md 섹션별 영향도

어느 섹션이 가장 많이 갱신되는지 시각화. 보라 강조: 결정 3건 이상 영향. 노랑: 1–2건. 회색: 변경 없음.

§2 COLOR · §3 TYPOGRAPHY

§2.1 Primitive (Palette)
A1A2A3A4A5?
§2.2 Semantic Tokens
D7 keep
§2.3 Component Tokens
D6
§2.4 Marketing Material Colors
A1A2A5
§3.3 Type Scale Product
B2?
§3.4 Type Scale Marketing
B1B2
§3.12 Cross-Media Typography
B1B3

§4 LAYOUT · §5 COMPONENTS · §13

§4 Spacing / Layout / Radius
C1C2C4
§5A Product Components
D1D3D4
§5B Marketing Components
D2D3D4D5
§8 Iconography & Imagery
F1 신규
§13 Figma↔Code Mapping
A1A4C3E1
신규 §14 Migration Policy
E1

04결정 우선순위 — 어디부터 합의?

DESIGN.md layer 구조상 하위 layer가 정해져야 상위 layer 옵션이 좁혀집니다. 1순위 끝나기 전엔 나머지 보류 권고.

1L1 PRIMITIVE

컬러 primitive 정착

셋 모두에서 호출되는 가장 아래 layer. 여기가 안 정해지면 다른 결정의 옵션이 다 모호해짐.
A1 · A2 · A3 · A4 · A5
2L2 SEMANTIC

의미 토큰 검증

Border tier · Typography composite — 이미 셋 공통으로 정착돼 있어 빠르게 합의.
D7 · B3
3L3 CROSS-MEDIA

미디엄 변환 확장

Display Hero · Layout grid max-width 등 §3.12 위에 추가하는 셋 공통 비율 layer.
B1 · C1
4L4 CONTEXT

컨텍스트 컴포넌트

Component · KV는 1–3순위 결정 후 자연스럽게 옵션 도출.
D1–D6 · F1 · B2 · C2 · C4

별도 트랙: C3 (§13 매핑 정책) · E1 (마이그) — 토큰 결정과 병행 가능

05항목별 상세 — 무엇을 결정?

A1

Brand Primary 통합

L1+L4분기 존재
DESIGN.md 현황
§2.1 --color-brand-500: #5A52FF · §2.4 --key-palette: #5B52FF. hex 1단위 차이로 분기 중.
두 토큰 비교
A
L1 통일 — #5A52FF 단일값. §2.4 --key-palette 제거, marketing도 --primary 사용.
Marketing의 미세 차이 손실 (실용적으로 무시 가능 수준).
B
L1 통일 — #5B52FF 단일값. §2.1 brand-500 값 변경.
콘솔 검증 필요. HSL `243 100% 66%` 조정.
C
현 분기 유지.
토큰 폭발의 시작.
A2

Neutral Palette 통합

L1+L4분기 존재
DESIGN.md 현황
§2.1 neutral 12단계 (240 hue zinc) · §2.4 ink scale 5단계 (#0D0D12 알파). 두 시스템이 명백히 다름.
Product Neutral (240 hue) vs Marketing Ink
§2.1 Neutral · 240 hue
50
200
500
700
900
vs
§2.4 Ink · #0D0D12 base
ink-08
ink-20
ink-50
ink-80
ink
A
L1 단일화 — neutral 12단계로 통일. §2.4 ink는 alias.
B
L1 + L4 분기 명시 — neutral(product) + ink(marketing) 별도 유지. §3.13처럼 분기 규칙 명문화.
C
Marketing ink로 통일 — #0D0D12 기반으로 product도 변경.

부수 결정: 외주 slate(#0f1729) 흡수 여부 — 어느 옵션이든 거부 권고.

A3

Categorical 색 — 개수

L110색 정의
DESIGN.md 현황
§2.1에 10색 (Coral · Skyblue · Olive · Purple · Mint · Magenta · Teal · Burgundy · Green · Gray) + Yellow + Red(status). §2.4에는 별도 categorical 없음 — marketing도 §2.1 빌려쓰는 구조.
§2.1 Categorical 10색
coral
skyblue
olive
purple
mint
magenta
teal
burgundy
green
gray
A
8색 + status 분리 — Olive/Teal/Burgundy 제거. Green/Yellow는 status로만.
B
10색 유지 — §2.1 그대로.
A4

Categorical 색 — 이름 표준화

L1정의됨
DESIGN.md 현황
§2.1coral, skyblue, olive 등. Tailwind 표준은 orange, sky.
A
유지 — coral/skyblue 그대로.
B
Tailwind 표준 — orange/sky로 변경. §13에 alias 표 추가.
A5

--ups-purple #805CFB의 layer

L4 → ?--ups-purple 정의
DESIGN.md 현황 (이미 정착)
§2.4 --ups-purple: #805CFB Marketing 토큰 · §5B Featured Card border + Section Eyebrow color로 사용 중. Product에서 같은 보라가 필요할 때는 §2.1 --color-purple-400 #8D5DF4 사용. 외주 "신규" 제안은 사실 이미 marketing 토큰임.
두 보라의 관계
§2.1 Product · accent purple
purple-400
#8D5DF4
vs
§2.4 Marketing · ups-purple
--ups-purple
#805CFB
A
L4 유지 — §2.4 marketing 전용. Product UI는 §2.1 purple-400 그대로.
B
L1으로 승격 — §2.1에 primitive로 추가, product UI도 brand 보조색으로 사용 가능.
C
§2.1 purple과 통합 — #8D5DF4#805CFB로 교체 (또는 반대).

부수 결정: Marketing rule "버튼에 사용 금지"는 어느 옵션이든 유지.

B1

Display Hero 70px

L372–88px 정의
DESIGN.md 현황 (이미 거의 정의)
§3.12 Cross-Media에 Marketing Hero 72–88px 이미 정의 · Cover Display ★ 100–128px도 정의. 외주 70px는 Marketing Hero 하한 직전 (2px 차이).
§3.12 vs 외주 70px
§3.12 Marketing Hero 72–88px
Future of work.
외주 ES Peak 70px
Future of work.
A
§3.4 그대로 매핑 — 외주 Figma의 70px를 72px로 보정.
B
§3.4 하한 확장 — Marketing Hero를 70–88px로 변경. 권고.
C
신규 토큰 추가 — display-1/-2 별도 정의.
B2

Marketing Body 18px

L4Product만 18px 있음
DESIGN.md 현황
§3.3 Product에 Body/B1 18px 이미 정의. §3.4 Marketing 본문은 12–13px가 표준 (dense layout). Product 토큰은 있지만 marketing에서 18px 사용은 §3.4 표 밖.
A
거부 — §3.4 13px 본문 + 23–28px Card Title 사이 갭 그대로.
B
§3.4에 Marketing Subtitle 18px 신설 — Section/Card/Subtitle/Body 4단 구조.
C
§3.3 Body/B1 호출 허용 — 별도 토큰 안 만들고 product 토큰을 marketing에서 호출.
B3

Typography 20 composite

L3셋 공통 비율 정의
DESIGN.md 현황 (이미 셋 공통)
§3.3 Product 6개 + §3.4 Marketing 7개 + §3.5 A4 Print 7개. §3.12 Cross-Media 표가 셋을 단일 비율 시스템(Body 1× 기준)으로 묶음. 비율 통일, 절댓값만 미디엄별.
A
유지 — §3.12 이미 셋 공통 답. 변경 불필요. 권고.
B
10개로 축소 — §3.12 비율 시스템 단순화.
C1

Layout Grid (max-width)

L1Marketing/Asset 토큰 부재
DESIGN.md 현황
§4 Breakpoints (Tailwind sm~2xl) + Named Sizes (width-chat-content: 720px — product만). Marketing/Asset용 max-width 토큰 부재. 외주 1200/120/1000/384 패턴 미정의.
외주 grid 시각화 (1440 / 120 / 1200)
canvas 1440px
--max-w-content: 1200px
A
L1 신설 — --max-w-content: 1200 · --max-w-header: 1000 · --max-w-card: 384§4에 추가. 셋 모두에서 호출 가능. 권고.
B
L4 신설 — Marketing 전용 namespace.
C
§5B 컴포넌트 내부 hardcode — 토큰 없음.
C2

Spacing Scale 단계

L18단계
DESIGN.md 현황
§4 Spacing Scale 8단계 (4 / 8 / 10 / 12 / 16 / 18-20 / 24 / 32-36 / 44). product+marketing 혼합 표기. 외주는 5/7/10 (20/28/40) 추가 + 큰 값 64/120 사용.
11단계 확장 (5/7/10 추가) · 큰 값은 토큰 X
4
6
8
12
16
20*
24
28*
32
40*
48
64
120
A
8단계 유지.
B
11단계 — 5/7/10 추가. 큰 값(64+, 120)은 토큰 X, Tailwind class 직접 (gap-16, m-30). 권고.
C
Tailwind 전체 (0–96) — 일관성 약화.
C3

Figma↔Code 매핑 정책

정책color만 정의
DESIGN.md 현황
§13 Figma↔Code Token Mapping은 color만 정의. spacing/radius/typography 매핑 정책 부재.
A
§13에 매핑 정책 추가 — Figma 변수(gap/64 등)는 디자이너 internal, 코드는 Tailwind scale + spacing token. 매핑 표만 §13. 권고.
B
Figma 변수를 토큰으로 직결 — 토큰 폭발.
C4

Border Radius

L1Marketing만 12px
DESIGN.md 현황
§4 Product sm 4 / md 6 / lg 8 / xl 16 + Marketing 관행 4 / 8 / 10 / 12 / 16. §5B Card는 12px 사용. Product에는 12px 토큰 없음.
Radius scale
4
sm
6
md
8
lg
12
신규?
16
xl
A
L1 통일 — Product에도 12px 추가. sm 4 / md 6 / lg 8 / 12 / xl 16. 권고.
B
현 분기 유지 — Product와 Marketing radius 별도.
D1

Button

L4§5A 정의
DESIGN.md 현황
§5A에 Product button 정의. §5B Marketing components에는 button 없음 — marketing material에서 §5A 호출.
A
§5A 그대로 호출 — 셋 공통, button은 product 토큰만.
B
§5B에 marketing button 추가 — feature/CTA 전용 variant.

부수: S/M/L size 추가 여부.

D2

Card Pattern

L4§5B 정의
DESIGN.md 현황
§5B Card (Standard) padding 24 / border --ink-20 / radius 12 + Card (Featured) border 1.5px #805CFB. §5A에 product card 별도. 이미 분기.
D2.1§5B Card에 width 384px 명시? (C1과 연결)
A
Yes — --max-w-card: 384px
B
width 가변 유지
D2.2border 통일 방식
A
--ink-20 유지 (현 상태)
B
neutral-300으로 변경
D2.3Feature/Pricing/Leadform card 통합 vs 분리
A
§5B에 3종 명시
B
Standard 1종 + 변형 props
D3

Leadform / Input

L4§5A box만
DESIGN.md 현황
§5A Product Input (box style). §5B Marketing에 input 없음 — marketing form 사용 시 §5A 호출.
Box (현 §5A) vs Underline (외주 leadform)
§5A box
vs
외주 underline
A
§5B에 신규 정의 — leadform 전용 underline.
B
§5A에 underline variant 추가 — 셋 공통.
C
거부 — §5A box input 그대로.
D4

Navigation / Footer

L4웹 nav 미정의
DESIGN.md 현황
§5A nav 토큰 (product GNB) · §5B Header (Document/Flyer) + Footer (Dark) — 인쇄·슬라이드 자료 전용. 브랜드홈 web nav 미정의.
A
§5A 확장 — product GNB와 통합, 컨텍스트별 prop 분기.
B
§5B에 Web Nav 신설 — Header (Document)와 별도로 Header (Web) 추가.
C
신규 §5C — 별도 영역 신설.

부수: Announcement banner를 §5B 공통 컴포넌트로 추가 여부.

D5

Section System (homeheader)

L4homeheader 미정의
DESIGN.md 현황
§5B에 Section Eyebrow Label · Hero Section · CTA Block (Dark) 명시. homeheader 명시 없음.
A
§5B에 추가 — Hero Section의 변형으로.
B
Hero Section 하나로 충분 — 별도 정의 X.
D6

Component Token (~70개)

L4Product 70개
DESIGN.md 현황
§2.3 Component Tokens — nav-* / sidebar-* / table-* / tab-* 등 product 한정. Marketing/Asset component 토큰 영역 부재 (§5B는 CSS 클래스로 정의).
D6.1Product component 토큰 70개 처리
A
28개로 축소 — button/nav/sidebar/table/tab/tooltip/shadow만 보존
B
70개 유지
C
0개로 통합 — semantic만 사용
D6.2Marketing component 토큰 신설
A
§2.3에 카테고리 추가 — --marketing-card-*
B
§5B는 CSS 그대로 — 토큰화 안 함
D7

Border Tier

L26-tier 정의
DESIGN.md 현황 (이미 셋 공통)
§2.2 Border Scale 6-tier (subtle / border / medium / strong / dark / bold). 셋 공통 semantic.
A
6-tier 유지. 권고 — 변경 없음.
B
3-tier로 축소.
E1

v1 → v2 Alias 라이프사이클

정책정책 부재
DESIGN.md 현황
마이그 라이프사이클 정책 정의 없음. §13은 토큰 매핑 reference만.
A
즉시 정리 — alpha→beta 즉시 deprecate.
B
점진 — 콘솔 7-A 마이그 완료(~Q3) 후 deprecate. @upstage/ui-codemod 패키지 동반. 권고.
C
영구 alias.
F1

KV / Cover Graphic 시스템

L4시스템 부재
DESIGN.md 현황
§8 Iconography & Imagery는 logo만 정의. KV/Cover Graphic 시스템 부재. §11 Page Type Templates에 페이지 종류는 있지만 KV 토큰화 안 됨.
F1.1KV 시스템 신설
A
§8에 KV/Cover 시스템 추가
B
reference만 — 시스템화 X
F1.2KV 색상 layer
A
§2.4 marketing color 그대로 (--ups-purple 등)
B
신규 --graphic-* 카테고리
C
에셋 내부 hardcode — 토큰화 X
F1.3제품 onboarding 재사용 허용
A
Yes — 셋 공통 자산
B
Marketing/Asset 한정

INPUT 1 — raw/reports/design system/Codex 분석 및 결정사항 리스트.html (14 패턴)
INPUT 2 — raw/reports/design system/Claude Code 분석 및 결정사항 리스트.html (12 R-결정)
REFERENCE — raw/docs/design/DESIGN.md (1982 lines)