Communitygithub.com

웹 디자인 플레이북

웹사이트 / 랜딩 페이지 / HTML 목업을 디자인하고 구현하는 워크플로우입니다. 새로 만들기, 리디자인, 또는 '예쁘게 해줘' 같은 요청 시 사용하며, 참조 레이어 로드 → 방향 결정 → 구현 → 실기기 검증 → 학습 환류의 단계를 강제합니다. 사용자가 '이 사이트 좋아/참고해'라며 URL을 공유할 때도 참고 사이트를 축적합니다.

웹 디자인 플레이북란 무엇인가요?

이 스킬은 AI 에이전트가 웹 디자인 구현을 체계적이고 일관성 있게 수행하도록 돕는 설계 워크플로우입니다. 핵심은 `~/.claude/design-taste.md` 파일을 중심으로 사용자의 디자인 취향과 참고 사이트를 축적하고, 이를 디자인 방향 결정 및 구현의 기준으로 삼아 사용할수록 개인화되는 '타입'을 만드는 것입니다. 스킬은 참조 레이어(프로젝트 DESIGN.md, 취향 파일, 기본 원칙)를 먼저 읽은 후, 디자인 방향을 정하고(필요시 1화면 래프로 합의), 웹 벤토(Web Bento) 등의 기성 부품을 우선 활용하여 구현하며, 실기기에서 반응형 및 일본어 조판을 검증한 뒤, 사용자 피드백을 바탕으로 축적 파일을 업데이트하는 5단계 워크플로우로 구성됩니다. Claude Code, Cursor, Codex 등에서 사용할 수 있으며, Google의 DESIGN.md 형식과 Taste Skill 같은 추가 도구와의 연계가 용이합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ry071702-prog/web-design-playbook/tree/HEAD/skills/web-design-playbook

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Web Design Playbook

타입으로 품질을 재현하기 위한 디자인 구현 워크플로우. 핵심은 아래 '축적 파일'과의 왕복입니다. 좋은 디자인을 흡수하고, 만든 결과의 교훈을 다시 써넣음으로써 사용할수록 그 사용자 전용 타입으로 성장합니다.

축적 파일 (이 스킬의 중심)

사용자별 디자인 취향과 참고 사이트를 저장하는 원본입니다. 위치는 ~/.claude/design-taste.md이며, 존재하지 않으면 최초에 이 템플릿으로 만듭니다:

# Design Taste — 나의 디자인 축적

## 실증된 원칙
<!-- 만든 디자인에 대한 반응으로 '맞은 타입 / 안 맞은 타입'을 한 줄씩 추가 -->

## 참고 사이트 모음
<!-- '좋다'고 생각한 사이트를 무엇이 좋은지 언어화하여 추가 -->
| 사이트 | URL | 무엇이 좋은가 |
|---|---|---|

추가하는 시점 (흡수)

  • 사용자가 '이 사이트 좋아', '참고해', '이런 느낌'이라며 URL을 공유하면, 즉시 해당 사이트를 확인하고 무엇이 좋은지 (레이아웃/색상/타이포/모션/정보 설계)를 한 마디로 언어화하여 참고 사이트 모음에 추가합니다.
  • 만든 디자인에 대한 사용자 반응을 통해 '맞은 타입 / 안 맞은 타입'을 알게 되면 실증된 원칙에 한 줄 추가합니다.

읽는 시점 (사용)

  • 디자인 구현 전에 반드시 읽습니다 (워크플로우 1단계). 구현 방향, 색상, 모션의 판단 자료로 사용합니다.

워크플로우

1. 참조 레이어 로드 (구현 전 반드시)

우선순위로 읽습니다:

  1. 프로젝트 루트의 DESIGN.md — 프로젝트 고유의 원본. 최우선.
  2. 축적 파일 ~/.claude/design-taste.md — 사용자 개인의 실증된 취향.
  3. 아래 '디자인 원칙 (초기값)' — 위 두 가지에 해당하는 내용이 없을 경우의 기본값.

2. 방향 결정

  • 톤이 미확정이면, 먼저 1화면의 래프 (히어로 + 대표 섹션)로 방향성을 제시하고 합의를 구합니다. 모든 페이지를 만든 후 방향을 바꾸는 것이 가장 비용이 큽니다.
  • 방향이 확정되면 DESIGN.md 형식 (YAML 토큰 + 의도를 담은 산문)으로 프로젝트에 고정합니다. 이후 구현자(사람과 AI 모두)가 이를 읽으면 톤이 흐트러지지 않습니다.

3. 구현

  • 장식 파츠 (버튼/제목/카드/로더/배경 패턴 등)를 직접 만들기 전에 Web BENTO에서 기성 파츠가 있는지 확인합니다.
    • 개별 페이지: https://amix-design.com/tl/web-bento/parts/<slug>.html slug = 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

관련 스킬