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 claudecomponents.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에 있어요.