본문으로 건너뛰기
zest/ui

AI로 만들기

AI 도구는 아무 기준 없이 화면을 만들면 비슷한 결과를 내요 — 보라 그라데이션, 이모지 제목, 똑같은 카드 세 개. ZEST UI는 이 「AI 슬롭」을 막는 장치를 세 겹으로 줘요.

1. 규칙 파일

AI가 매번 읽는 디자인 규칙이에요. 한 줄로 설치해요.

npx shadcn@latest add @zest/zest-rules

설치되는 파일:

  • .cursor/rules/zest-ui.mdc — Cursor가 항상 적용하는 규칙
  • docs/zest-ui/DESIGN.md — 전체 디자인 계약

Claude Code를 쓴다면 프로젝트의 CLAUDE.md 에 한 줄을 더해요.

UI 작업은 @docs/zest-ui/DESIGN.md 와 .cursor/rules/zest-ui.mdc 를 따른다.

2. MCP — AI가 부품을 직접 찾아 설치

shadcn MCP 서버를 켜면 AI 에이전트가 레지스트리에서 부품을 찾아 바로 설치해요.

npx shadcn@latest mcp init --client claude

components.json 에 @zest 레지스트리가 있으면(설치) MCP가 함께 읽어요. 이제 “구성원 목록 화면 만들어 줘”라고 하면 @zest/list-block 을 찾아 씁니다.

3. 슬롭 검사기

만든 뒤에는 검사기로 확인해요.

npx shadcn@latest add @zest/zest-check
node scripts/zest-check.mjs src
규칙 잡는 것
gradient 그라데이션 버튼·배경
raw-color 토큰 밖 hex·rgb 색
ai-accent 인디고·바이올렛·퍼플·블루 강조색
emoji-heading 이모지로 시작하는 제목
heavy-shadow shadow-lg 이상의 카드 그림자
multi-primary 한 화면에 주 버튼 둘 이상
low-contrast-gray text-gray-400 같은 저대비 글자

위반이 있으면 종료 코드 1이라 CI에 그대로 붙일 수 있고, --json 으로 기계가 읽을 수도 있어요. 정말 예외가 필요하면 바로 위 줄에 // zest-check-ignore <규칙> 을 남겨요.

AI에게 이렇게 요청하세요

  • “ZEST UI 의 @zest/list-block 으로 거래처 목록 화면을 만들어 줘. 상태 열은 StatusDot.”
  • “상세는 Drawer, 승인 단계는 aside 에 ApprovalSteps.”
  • “끝나면 zest-check 를 돌려서 0건으로 만들어 줘.”

AI용 요약은 /llms.txt, 전체는 /llms-full.txt에 있어요.