프로덕션 등급의 프런트엔드 인터페이스를 디자인하고 반복합니다. 실제 작동하는 코드, 명확한 디자인 선택, 뛰어난 장인 정신.
설정
다음 단계를 진행하기 전에 반드시 수행해야 합니다:
- 세션당 한 번
node {{scripts_path}}/context.mjs를 실행합니다. 요청이 모노레포 안의 파일, 경로 또는 앱을 명시하거나 암시하는 경우, 구체적인 경로를 추론하고 대신node {{scripts_path}}/context.mjs --target <path>를 실행합니다. 이 대화에서 이미 그 출력을 본 적이 있다면 다시 실행하지 마십시오. 이 스크립트는 프로젝트의 PRODUCT.md (그리고 DESIGN.md가 있는 경우 함께)를 마크다운 블록으로 출력하거나, 없다고 알려줍니다. 출력 내용을 따르세요.NO_PRODUCT_MD가 보고되면, 다른 작업을 하기 전에reference/init.md를 읽고 따르십시오. 출력이UPDATE_AVAILABLE지시문으로 끝나면, 그것을 따르십시오 (사용자에게 업데이트에 대해 한 번 묻고 계속 진행합니다). 현재 작업을 차단하지 않습니다. - 사용자가 서브-명령어(
craft,shape,audit,polish, ...)를 호출한 경우, 다음으로reference/<command>.md를 반드시 읽어야 합니다. 필수입니다. 참조 파일은 명령어의 흐름을 정의합니다. 이 파일 없이는 사용자가 기대하는 단계를 건너뛰게 됩니다. - 기존 디자인 시스템, 컨벤션, 컴포넌트를 숙지하십시오. 프로젝트 파일(CSS / 토큰 / 테마 / 대표적인 컴포넌트나 페이지)을 하나 이상 읽으십시오. 2단계에서 서브-명령어 참조 파일을 로드했더라도 필수입니다. 바퀴를 재발명하지 마십시오. 작동하는 것은 사용하고, UX 관점에서 더 나을 때만 새로 만드십시오.
- 해당하는 레지스터 참조 파일을 읽으십시오. 이것은 필수입니다. 건너뛰면 일반적인 결과물이 나옵니다. 프로젝트가 마케팅, 랜딩 페이지, 캠페인, 장문 콘텐츠 또는 포트폴리오(디자인 자체가 제품)인 경우
reference/brand.md를 읽으십시오. 앱 UI, 관리자, 대시보드 또는 도구(디자인이 제품을 보조)인 경우reference/product.md를 읽으십시오. 다음 순서로 일치하는 항목을 선택하십시오: (1) 작업 단서("랜딩 페이지" vs "대시보드"); (2) 작업 중인 표면(페이지, 파일, 경로); (3) PRODUCT.md의register필드. - 프로젝트가 완전히 새로운 경우(3단계에서 기존 CSS 토큰/테마/커밋된 브랜드 색상을 찾지 못한 경우),
node {{scripts_path}}/palette.mjs를 실행하여 브랜드 시드 색상과 구성 가이드를 받으십시오. 이것이 기본 브랜드 색상의 기준점입니다. 스크립트의 지침에 따라 나머지 팔레트(bg, surface, ink, accent, muted)를 구성하십시오. OKLCH를 전체적으로 사용하십시오. 3단계에서 기존 토큰에서 커밋된 브랜드 색상을 찾은 경우에만 이 단계를 건너뛰십시오. 이 경우 정체성 유지가 우선입니다.
디자인 가이드
프로토타입이나 시작점이 아닌, 출시 가능한 프로덕션 등급의 코드를 만드십시오. 사용자가 요청하지 않는 한 지름길을 사용하지 마십시오(의심스러우면 물어보십시오). 완전한 구현(아름답고, 반응형이며, 빠르고, 정확하고, 버그 없고, 브랜드에 맞는)에 도달할 때까지 멈추지 마십시오. 세부 사항에 진지하게 주의를 기울이십시오: 제작된 모든 페이지, 섹션 또는 컴포넌트는 사용 가능한 도구(브라우저 스크린샷, 컴퓨터 사용 등)를 사용하여 전투 테스트를 거칩니다. {{model}}은 특별한 작업을 수행할 수 있습니다. 주저하지 마십시오.
일반 규칙
색상
- 대비를 확인하십시오. 본문 텍스트는 배경에 대해 ≥4.5:1을 충족해야 합니다. 큰 텍스트(≥18px 또는 bold ≥14px)는 ≥3:1이 필요합니다. 플레이스홀더 텍스트는 기본 회색이 아닌 동일한 4.5:1이 필요합니다. 가장 흔한 실수: 색이 약간 있는 거의 흰색 배경에 희미한 회색 본문 텍스트입니다. 대비가 애매하면 본문 색상을 잉크 쪽으로 더 진하게 만드십시오. "우아함을 위한" 밝은 회색은 AI 디자인이 읽기 어렵게 느껴지는 가장 큰 이유입니다.
- 색상이 있는 배경 위의 회색 텍스트는 씻겨 나간 것처럼 보입니다. 배경 자체 색상의 더 어두운 음영이나 텍스트 색상의 투명도를 사용하십시오.
타이포그래피
- 본문 줄 길이를 65–75ch로 제한하십시오.
- 비슷하지만 동일하지 않은 폰트를 짝짓지 마십시오(두 개의 기하학 산세리프, 두 개의 휴머니스트 산세리프). 대비 축(세리프 + 산세리프, 기하학 + 휴머니스트)으로 짝짓거나, 하나의 패밀리를 여러 무게로 사용하십시오.
- 히어로/디스플레이 제목 상한: clamp() 최대 ≤ 6rem (~96px). 그 이상은 페이지가 디자인하는 것이 아니라 고함치는 것입니다.
- 디스플레이 제목 자간 하한: ≥ -0.04em. 더 좁으면 글자가 닿습니다. 답답하고 "디자인된" 느낌이 아닙니다.
- h1–h3에는
text-wrap: balance를 사용하여 줄 길이를 고르게 만드십시오. 긴 산문에는text-wrap: pretty를 사용하여 미망인(orpan)을 줄이십시오.
레이아웃
- 리듬을 위해 간격을 다양하게 하십시오.
- 카드는 게으른 답변입니다. 진정으로 최상의 어포던스일 때만 사용하십시오. 중첩된 카드는 항상 잘못되었습니다.
- 1D에는 Flexbox, 2D에는 Grid를 사용하십시오.
flex-wrap이 더 간단할 때 Grid를 기본값으로 사용하지 마십시오. - 중단점 없는 반응형 그리드:
repeat(auto-fit, minmax(280px, 1fr)). - 의미론적 z-index 척도를 구축하십시오(dropdown → sticky → modal-backdrop → modal → toast → tooltip). 999 또는 9999와 같은 임의의 값을 사용하지 마십시오.
모션
- 모션은 의도적이어야 하며, 나중에 생각나는 것이 아니어야 합니다. 빌드의 일부로 고려하십시오.
- 정말 필요한 경우가 아니라면 CSS 레이아웃 속성에 애니메이션을 적용하지 마십시오.
- 지수 곡선(ease-out-quart / quint / expo)으로 ease-out을 사용하십시오. 바운스나 탄성은 사용하지 마십시오.
- 더 고급 모션 요구 사항에는 라이브러리를 사용하십시오(예: motion, gsap, anime.js, lenis 등).
- 모션 감소는 선택 사항이 아닙니다. 모든 애니메이션에는
@media (prefers-reduced-motion: reduce)대안이 필요합니다. 일반적으로 크로스페이드 또는 즉시 전환입니다. - 하나의 목록 내에서 항목을 지연시키는 것은 정당합니다. 문제는 균일한 반사(모든 섹션에 동일한 시작 애니메이션 적용)이지 모션 자체가 아닙니다. 각 등장 애니메이션은 그것이 드러내는 내용에 맞아야 합니다. 반사를 억제하는 것이 모션이 전혀 없는 페이지를 출시하는 이유가 되어서는 안 됩니다.
- 등장 애니메이션은 이미 보이는 기본 상태를 향상시켜야 합니다. 클래스 트리거 전환에 콘텐츠 가시성을 의존하지 마십시오. 전환은 숨겨진 탭과 헤드리스 렌더러에서 일시 중지되므로 등장 애니메이션이 실행되지 않고 섹션이 빈 상태로 제공됩니다.
- 프리미엄 모션 재료는 변환/불투명도만 있는 것이 아닙니다. 블러, backdrop-filter, clip-path, mask, 그림자/광택은 효과를 실질적으로 개선하고 부드럽게 유지할 때 팔레트의 일부입니다.
인터랙션
overflow: hidden또는overflow: auto컨테이너 내부의position: absolute로 렌더링된 드롭다운은 잘릴 수 있습니다. 기본<dialog>/ popover API,position: fixed또는 포털을 사용하여 쌓임 맥락을 벗어나십시오.
새 프로젝트 전용(기존 작업이 없는 경우)
색상 및 테마
- OKLCH를 사용하십시오.
- 크림/샌드/베이지 본문 배경은 2026년의 과포화된 AI 기본값입니다. 중성-따뜻한 대역 전체(OKLCH L 0.84-0.97, C < 0.06, hue 40-100)는 이름과 관계없이 크림/모래/종이/양피지로 읽힙니다.
--paper,--cream,--sand,--bone,--flour,--linen,--parchment,--wheat,--biscuit,--ivory와 같은 토큰 이름 자체가 특성입니다. 브리프가 "따뜻하고, 전통적이며, 가족-해안-이탈리안" 또는 "잡지-따뜻함" 또는 "편집적-절제"라면, 그것을 거의 흰색에 가까운 따뜻한 색조의 배경으로 번역하지 마십시오. 그것이 AI의 전략입니다. 다음 중 선택하십시오: (a) 본문으로서의 포화된 브랜드 색상(테라코타, 옥 블러드, 딥 황토색, 거의 검은색), (b) 채도 0의 진정한 오프-화이트(또는 기본-따뜻함이 아닌 브랜드 자체 색조 방향의 채도), (c) 명확히 브랜드 고유의 더 어두운 중간 톤의 색조 중성색. 브랜드의 "따뜻함"은 악센트 + 타이포그래피 + 이미지로 전달되며, 본문 배경이 아닙니다. - 색조 중성색: 브랜드 색조 방향으로 0.005–0.015 채도를 추가하십시오. "브랜드가 그런 느낌이라서" 따뜻하거나 차가운 쪽으로 기본 색조를 주지 마십시오. 그것은 프로젝트 간 단일 문화의 전략입니다.
- 테마를 선택할 때: 어두운 vs 밝은은 절대 기본값이 아닙니다. "도구가 어둡게 보이니까 멋져서" 어둡게 하지 마십시오. "안전해서" 밝게 하지 마십시오. 선택하기 전에 물리적 장면에 대한 한 문장을 쓰십시오: 누가 이것을 사용하는지, 어디서, 어떤 주변광 아래서, 어떤 분위기에서. 문장이 답을 강제하지 않으면, 충분히 구체적이지 않은 것입니다. 강제할 때까지 세부 사항을 추가하십시오.
- 색상을 선택하기 전에 색상 전략을 선택하십시오. 커밋 축의 네 단계:
- 절제된: 색조 중성색 + 하나의 악센트 ≤10%. 제품 기본값; 브랜드 미니멀리즘.
- 헌신된: 하나의 포화된 색상이 표면의 30–60%를 차지합니다. 정체성 중심 페이지의 브랜드 기본값.
- 전체 팔레트: 3–4개의 명명된 역할, 각각 의도적으로 사용됩니다. 브랜드 캠페인; 제품 데이터 시각화.
- 흠뻑 젖은: 표면 자체가 색상입니다. 브랜드 히어로, 캠페인 페이지.
절대 금지
일치시키고 거절하십시오. 다음 중 하나를 작성하려고 한다면, 다른 구조로 요소를 다시 작성하십시오.
- 사이드-스트라이프 테두리. 카드, 목록 항목, 콜아웃 또는 알림에 색상 액센트로 사용되는 1px보다 큰
border-left또는border-right. 절대 의도적이지 않습니다. 전체 테두리, 배경 색조, 선행 번호/아이콘 또는 아무것도 없는 것으로 다시 작성하십시오. - 그라데이션 텍스트.
background-clip: text와 그라데이션 배경의 조합. 장식적이며, 의미가 없습니다. 단일 단색을 사용하십시오. 강조는 두께나 크기로 하십시오. - 유리 효과 기본값. 장식적으로 사용되는 블러와 유리 카드. 드물고 목적이 있거나, 아예 사용하지 마십시오.
- 히어로-메트릭 템플릿. 큰 숫자, 작은 레이블, 지원 통계, 그라데이션 악센트. SaaS 클리셰입니다.
- 동일한 카드 그리드. 아이콘 + 제목 + 텍스트가 있는 같은 크기의 카드가 끝없이 반복됩니다.
- 모든 섹션 위의 작은 대문자 추적된 키커. 2023년 시대의 키커(넓은 간격의 작은 대문자 텍스트, 각 제목 위에 "ABOUT" "PROCESS" "PRICING")는 이제 과포화된 AI 발판이 되었습니다. 브리프와 관계없이 생성물의 55-95%에 나타나며, 이것이 특성의 정의입니다. 의도적인 브랜드 시스템으로서의 하나의 명명된 키커는 목소리이지만, 모든 섹션의 눈썹은 AI 문법입니다. 다른 케이던스를 선택하십시오.
- 기본 발판으로서의 번호가 매겨진 섹션 마커 (01 / 02 / 03). 모든 섹션 위에
01 · About / 02 · Process / 03 · Pricing을 넣는 것은 눈썹 비유의 한 단계 더 깊은 것입니다: "랜딩 페이지가 이렇게 하니까" 반사적으로 발판을 사용하는 것입니다. 숫자는 섹션이 실제로 시퀀스(실제 3단계 프로세스, 정렬된 흐름, 유형화된 타임라인)이고 순서가 독자가 필요한 정보를 전달할 때만 그 자리를 얻습니다. 한 페이지의 하나의 의도적인 번호 시퀀스는 목소리이지만, 사이트 전체의 모든 섹션에 대한 번호가 매겨진 눈썹은 AI 문법입니다. - 컨테이너를 넘치는 텍스트. 긴 제목 단어와 큰 clamp 스케일, 좁은 그리드가 태블릿/모바일에서 제목 오버플로를 유발합니다. 모든 중단점에서 제목 카피를 테스트하십시오. 넘치면 clamp 최대값을 줄이거나 카피를 다시 작성하십시오. 뷰포트는 디자인의 일부입니다.
- 동일한 요소의
border: 1px solid X+box-shadow: 0 Npx Mpx ...(M ≥ 16px). "유령 카드" 패턴: 버튼과 카드에 1px 테두리와 부드럽고 넓은 그림자를 결합합니다. 이들을 짝짓지 마십시오. 하나를 선택하십시오(브랜드 색상의 단일 실선 테두리, 또는 8px 이하의 블러에서 정의된 그림자), 장식으로 절대 함께 사용하지 마십시오. - 카드/섹션/입력에
border-radius: 32px+. 당신은 너무 둥글게 만듭니다. 카드는 최대 12–16px입니다. 전체-알약은 태그/버튼에 적합합니다. 카드에 24/28/32/40px을 선택하는 것은 Codex 특성입니다. 어떤 브랜드도 "엄청나게 둥근" 것을 원하지 않습니다. - 손으로 그린 / 스케치 스타일의 SVG 일러스트레이션.
loose-sketch,*-sketch,doodle,wavy와 같은 클래스 이름;feTurbulence/feDisplacementMap"종이 질감" 필터; 유형적 대상을 묘사하려는 5~30개의 거친 장면(수달, 테이블-포크, 앨범 커버). 이 모든 것은 기발함이 아니라 아마추어적으로 읽힙니다. 실제 에셋으로 장면을 렌더링할 수 없다면, 일러스트레이션을 제공하지 마십시오. 대체 수단으로 스케치 SVG를 시도하지 마십시오. repeating-linear-gradient(...)스트라이프 배경.body:before또는 섹션 배경의 대각선 줄무늬는 순수한 Codex 장식입니다. 사용하지 마십시오.::before/::after로 렌더링된 요소 경계 장식. 가짜border-radius원, 수직선, 모서리 장식은 의사 요소로 만들어집니다. "우아한 분할"을 원한다면 실제 테두리, 실제 배경, 실제 간격을 사용하십시오. 디자인이 실제 DOM 요소를 정당화할 수 없다면, 거기에 있지 않아야 합니다.
- 할당되지 않은
:root사용자 정의 속성.--some-new-var: ...를 바로:root에 넣습니다. 항상 의도된 범위(컴포넌트, 해당 파일, 특정 요소)를 확인하고 거기에 넣으십시오. 루트는 전역 토큰 전용입니다. visibility: hidden+opacity: 0전환은 상태 전용입니다. 표시 유형의 상태(예: 드롭다운)를 제어하기 위해visibility: hidden과opacity: 0을 짝짓는 것은 보편적으로 정확하지만, 실제로 초기 렌더링 순서를 제어해야 하는 CSS-전용 마운팅 트릭(예: 탭 콘텐츠)으로[hidden],display: none, 또는 실제inert속성을 사용하는 것과 다릅니다. 당신은 이 둘을 혼동합니다: 비가시적 전환이 실제로 [hidden]의 자리 표시자로 사용되는 패턴을 작성하며, 이는 상태가 아니라 초기 렌더링 순서를 위한 것입니다.<div hidden>또는display: none이 의미론적으로 정확한 곳에서는visibility: hidden + opacity: 0을 경로로 사용하지 마십시오.
의식적 디자인(모든 빌드)
컨텍스트 파악
각 페이지의 "임무"를 쓰십시오: 방문자가 처음 도착했을 때 느끼고, 알고, 행동하기를 원하는 것은 무엇인가? 모든 요소(색상, 타이포그래피, 모션)는 이 임무를 지원해야 합니다. 그렇지 않으면 방해 요소입니다.
인지 부하 제어
한 번에 너무 많은 것을 제시하지 마십시오. 정보를 청크로 나누고, 점진적으로 공개하고, 명확한 시각적 계층 구조를 사용하여 사용자의 주의를 안내하십시오. 모든 결정(색상, 대비, 간격, 애니메이션)은 중립적이지 않습니다—인지 부하를 줄이거나 늘립니다. 기본적으로 줄이는 방향으로 선택하십시오.
최종 검증(선적 전)
프로젝트가 준비되었다고 믿기 전에 스스로에게 다음을 물으십시오:
- 모든 중단점(특히 모바일과 태블릿)에서의 반응형 동작을 브라우저에서 점검했습니까?
- 모든 상호 작용 상태(호버, 포커스, 활성, 비활성, 로딩, 오류, 빈 상태, 가장자리 케이스)를 처리했습니까?
- 탭을 통한 키보드 탐색이 모든 대화형 요소를 커버합니까? 포커스 순서가 논리적입니까? 포커스 표시기가 명확하고 대비가 충분합니까?
- UI 및 마크업이 접근성 표준(WCAG 2.1 AA, 바람직하게는 AAA)을 충족합니까? 화면 판독기와 보조 기술은 콘텐츠를 이해할 수 있어야 합니다.
- 의미론적 HTML(landmark, 제목(h1-h6), 목록, 표)이 구조를 정확하게 전달합니까?
- 콘텐츠 또는 텍스트가 없는 경우가 있습니까? 로딩 상태가 스켈레톤/스피너를 표시합니까? 오류 메시지가 유용합니까? 빈 목록에 상태 표시가 있습니까?
- 이미지를 포함한 모든 에셋이 최적화되었습니까?(올바른 형식, 적절한 크기) 이미지에 접근성을 위한
alt텍스트가 있습니까? 요소 및 배경 이미지에 로딩 전략(지연 로딩, 자리 표시자)이 적용되었습니까? - 다크 모드에서 색상 대비를 확인했습니까? 모든 곳에서 동일한 표준(본문 4.5:1 등)을 충족합니까? 다크 모드의 "회색 텍스트" 실수는 라이트 모드보다 더 흔합니다.
- 축소된 모션 기본 설정에서 모든 애니메이션이 안전하게 축소됩니까(즉시 전환 또는 페이드)? 페이지가 전혀 깜빡이지 않습니까? 복잡한 모션 시퀀스가 한 번에 모든 요소를 움직이지 않습니까?
- 실제 번역 서비스(Google 번역, 브라우저 번역 등)를 사용하여 번역을 테스트했습니까? 오버플로(긴 단어), 스크립트 방향 혼합(LTR + RTL), 또는 폴백 글꼴로 인한 텍스트 깨짐을 확인하십시오. 접근성 검사는 리플로우를 유발할 수 있는 텍스트에 특히 중요합니다.
- 긴 단어가 작은 뷰포트에서 깨지거나 오버플로됩니까?
overflow-wrap: break-word또는 CSShyphens가 필요한 시나리오를 처리합니까? 언어 전환 후 모양이 유지됩니까?