Web Design Playbook
타입으로 품질을 재현하기 위한 디자인 구현 워크플로우. 핵심은 아래 '축적 파일'과의 왕복입니다. 좋은 디자인을 흡수하고, 만든 결과의 교훈을 다시 써넣음으로써 사용할수록 그 사용자 전용 타입으로 성장합니다.
축적 파일 (이 스킬의 중심)
사용자별 디자인 취향과 참고 사이트를 저장하는 원본입니다. 위치는 ~/.claude/design-taste.md이며, 존재하지 않으면 최초에 이 템플릿으로 만듭니다:
# Design Taste — 나의 디자인 축적
## 실증된 원칙
<!-- 만든 디자인에 대한 반응으로 '맞은 타입 / 안 맞은 타입'을 한 줄씩 추가 -->
## 참고 사이트 모음
<!-- '좋다'고 생각한 사이트를 무엇이 좋은지 언어화하여 추가 -->
| 사이트 | URL | 무엇이 좋은가 |
|---|---|---|
추가하는 시점 (흡수)
- 사용자가 '이 사이트 좋아', '참고해', '이런 느낌'이라며 URL을 공유하면, 즉시 해당 사이트를 확인하고 무엇이 좋은지 (레이아웃/색상/타이포/모션/정보 설계)를 한 마디로 언어화하여 참고 사이트 모음에 추가합니다.
- 만든 디자인에 대한 사용자 반응을 통해 '맞은 타입 / 안 맞은 타입'을 알게 되면 실증된 원칙에 한 줄 추가합니다.
읽는 시점 (사용)
- 디자인 구현 전에 반드시 읽습니다 (워크플로우 1단계). 구현 방향, 색상, 모션의 판단 자료로 사용합니다.
워크플로우
1. 참조 레이어 로드 (구현 전 반드시)
우선순위로 읽습니다:
- 프로젝트 루트의
DESIGN.md— 프로젝트 고유의 원본. 최우선. - 축적 파일
~/.claude/design-taste.md— 사용자 개인의 실증된 취향. - 아래 '디자인 원칙 (초기값)' — 위 두 가지에 해당하는 내용이 없을 경우의 기본값.
2. 방향 결정
- 톤이 미확정이면, 먼저 1화면의 래프 (히어로 + 대표 섹션)로 방향성을 제시하고 합의를 구합니다. 모든 페이지를 만든 후 방향을 바꾸는 것이 가장 비용이 큽니다.
- 방향이 확정되면 DESIGN.md 형식 (YAML 토큰 + 의도를 담은 산문)으로 프로젝트에 고정합니다. 이후 구현자(사람과 AI 모두)가 이를 읽으면 톤이 흐트러지지 않습니다.
3. 구현
- 장식 파츠 (버튼/제목/카드/로더/배경 패턴 등)를 직접 만들기 전에 Web BENTO에서 기성 파츠가 있는지 확인합니다.
- 개별 페이지:
https://amix-design.com/tl/web-bento/parts/<slug>.htmlslug = gradient / heading / button / card / text-effect / divider / hover / glass-shadow / badge / loading / form / background-pattern / speech-bubble / list / alert / table - 차용 시 프로젝트의 색상/둥근 모서리/폰트에 맞게 수정합니다 (상업적 이용 OK, 크레딧 불필요. 부품 모음으로의 재배포만 금지되므로 리포지토리에 포함하지 않습니다).
- 개별 페이지:
- 모션은 가벼운 구현부터 검토합니다: CSS / Framer Motion → Rive / Lottie → Three.js
prefers-reduced-motion을 반드시 존중합니다.
4. 실기기 검증 (배포 전 반드시)
- 브라우저에서 390 / 880 / 1280px의 세 가지 너비 이상으로 스크린샷을 찍어 육안으로 확인합니다 (Chrome DevTools MCP 등 활용). 빌드가 통과하는 것과 화면이 제대로 보이는 것은 별개입니다.
- 일본어 체크: 제목의 줄바꿈 깨짐 (조사 줄 앞 고립, 단어 중간 분할) / 요소 잘림 / 호버해야 읽을 수 있는 정보.
- 일본어 줄바꿈 처리: 의미 덩어리별로 nowrap 블록 행으로 나누거나 /
word-break: auto-phrase/ 분할 금지 구문은 nowrap span으로 감쌉니다.
5. 학습 환류
- 사용자 반응을 통해 '맞은 타입 / 안 맞은 타입'을 알게 되면, 즉시 축적 파일의 '실증된 원칙'에 추가합니다.
- 이를 반복하면 판단 기준이 '일반론'에서 '이 사용자의 실증된 취향'으로 대체됩니다. 이것이 이 플레이북의 본질입니다.
디자인 원칙 (초기값)
축적 파일에 실증이 쌓일 때까지의 기본값입니다. 어디까지나 초기값이므로 맞지 않으면 바꿔도 좋습니다:
- 흰색 베이스 + 악센트 1색 + 거대 타이포 + 테마의 구체적 모티프 다색이나 다크×골드 같은 '호화' 방향은 AI스러운 템플릿 느낌이 나기 쉽습니다.
- 조작에 반응하는 장난기 + 이벤트 감각의 모션, 단 정보의 가독성을 절대 희생하지 않습니다.
- 정서는 테마의 은유로 표현 (예: 축구 대회 사이트 → 신문 지면, 상영회 이벤트 → 축제). 범용 그라데이션+유리 카드 조합으로 때우지 않습니다.
커스터마이즈 가이드 (이곳을 자신에 맞게 변경)
| 항목 | 커스터마이즈 방법 |
|---|---|
| 디자인 원칙 (초기값) | 자신의 실증이 쌓이면 축적 파일 쪽이 정본이 됩니다. 이 절은 삭제하거나 자신의 타입으로 다시 쓰세요. |
| 축적 파일 위치 | 팀에서 공유한다면 리포지토리 내 (예: design/taste.md)에 두고 본문의 경로를 변경하세요. |
| 검증 너비 390/880/1280px | 프로젝트의 실제 브레이크포인트에 맞추세요. |
| 일본어 체크 | 다국어 사이트라면 대상 언어의 조판 체크 (하이픈 연결 등)로 변경하세요. |
| 철학의 소스 | 자신이 추천하는 디자이너/방법론이 있다면 그 참조를 1단계에 추가하세요. |
금지 사항
- AI 이미지 생성으로 가상의 IP·캐릭터·상품을 만들지 않습니다 (실제 IP를 다루는 맥락에서 가장 사고가 발생하기 쉽습니다). 장식은 추상 기하/타이포/브랜드 컬러/공식 에셋/실사만 사용합니다.
- 재배포가 금지된 소재집·타인 콘텐츠를 리포지토리에 포함하지 않습니다 (링크로 참조합니다).
병용 추천 (선택 사항)
- Taste Skill — 안티 슬롭 품질 가드:
npx skills add Leonxlnx/taste-skill -g -s design-taste-frontend(+high-end-visual-design/redesign-existing-projects) - DESIGN.md 검증:
npx @google/design.md lint