웹사이트 구축
차별화된 프로덕션 등급 웹사이트를 구축하세요. 모든 선택(타입, 색상, 모션, 레이아웃)은 의도적이어야 합니다. 정적 HTML/CSS/JS 번들로 S3에 배포합니다.
이 스킬은 웹 프로젝트의 모든 것을 다룹니다. load_skill("website-building")을 통해 로드되면 모든 파일이 workspace/에 복사됩니다. 프로젝트 유형에 따라 필요에 따라 하위 파일을 읽으세요. 웹 애플리케이션의 경우 하위 스킬을 로드하세요: load_skill("website-building/webapp").
범용 디자인 원칙 (색상 철학, 기본 팔레트, 글꼴 선택)은 design-foundations를 통해 다른 스킬과 공유됩니다. 이 스킬의 공유 파일은 웹 특화 구현(CSS 변수, 반응형 토큰, 기본 스타일시트)으로 이러한 기초를 확장합니다. design-foundations를 별도로 로드할 필요가 없습니다. shared/에 있는 웹 특화 버전이 포괄적입니다.
전체 경로와 함께 read를 사용하세요. 예: shared/01-design-tokens.md
프로젝트 유형 라우팅
1단계: 프로젝트 유형 식별 및 도메인별 지침 로드:
| 프로젝트 유형 | 작업 | 예시 |
|---|---|---|
| 정보 제공 사이트 | read informational/informational.md | 개인 사이트, 포트폴리오, 에디토리얼/블로그, 소규모 비즈니스, 랜딩 페이지 |
| 웹 애플리케이션 | load_skill("website-building/webapp") | SaaS 제품, 대시보드, 관리자 패널, 전자상거래, 브랜드 경험 |
| 브라우저 게임 | read game/game.md + game/game-testing.md | 2D Canvas 게임, Three.js/WebGL, HTML5 게임, 인터랙티브 3D 경험 |
2단계: 공유 파일 읽기 — 먼저 shared/01-design-tokens.md 및 shared/02-typography.md를 읽으세요(모든 프로젝트 유형(웹앱 포함)에 필수). 이 파일들은 보편적으로 적용되는 Nexus 디자인 시스템 기본값과 타이포그래피 규칙을 수립합니다. 웹 애플리케이션 및 대시보드의 경우 아래에 †로 표시된 파일은 건너뛰세요. 해당 파일에는 풀스택 템플릿에 미리 구성된 구현 세부 정보가 포함되어 있습니다.
사용자가 그냥 "website" 또는 "site"라고만 말하고 자세한 내용이 없으면, 유형을 묻거나 정보 제공 사이트로 기본값을 설정하세요.
하위 파일 참조
공유 (shared/) — 모든 프로젝트
| 파일 | 포함 내용 | 로드 |
|---|---|---|
shared/01-design-tokens.md | 타입 스케일, 간격, Nexus 팔레트, base.css | 항상 |
shared/02-typography.md | 글꼴 선택, 페어링, 로딩, 블랙리스트 | 항상 |
shared/04-layout.md | 공간 구성, 반응형, 모바일 우선 | 항상 † |
shared/05-taste.md | 스켈레톤 로더, 빈/오류 상태, 다듬기 | 항상 |
shared/08-standards.md | 접근성, 성능, 안티 패턴 | 항상 |
shared/09-technical.md | 프로젝트 구조, 샌드박스, 배포, 체크리스트 | 항상 † |
shared/03-motion.md | 스크롤 애니메이션, Motion 라이브러리, GSAP SVG 플러그인, 호버/커서 | 애니메이션이 필요할 때 |
shared/06-css-and-tailwind.md | Tailwind CSS v3, shadcn/ui, 최신 CSS | Tailwind를 사용할 때 |
shared/07-toolkit.md | CDN 라이브러리, React, Three.js, 아이콘, 지도, SVG 패턴/필터, esm.sh | 라이브러리를 선택할 때 |
shared/10-charts-and-dataviz.md | Chart.js, Recharts, D3, KPI, 스파크라인 | 데이터 시각화가 필요할 때 |
shared/11-web-technologies.md | 프레임워크 버전, 브라우저 호환성 | 호환성을 확인할 때 |
shared/12-playwright-interactive.md | 지속적인 Playwright 브라우저 QA, 스크린샷, 시각적 테스트 | 테스트할 때 |
shared/19-backend.md | FastAPI/Express/Flask 서버, WebSocket, SSE, 포트 포워딩 | 백엔드가 필요할 때 |
shared/20-llm-api.md | LLM 채팅, 이미지/비디오/오디오 생성, 전사 — 모델, 자격 증명, SDK 헬퍼 | 사이트가 AI/LLM API를 사용할 때 |
모든 경로는 ``에 상대적입니다.
† 웹앱 및 대시보드의 경우 건너뛰기 — 구현 세부 정보는 풀스택 템플릿에 미리 구성되어 있습니다. Design-tokens 및 typography는 건너뛰지 않습니다. 이는 모든 프로젝트 유형에 대한 권위 있는 디자인 시스템 기본값과 글꼴 선택 지침을 제공합니다.
도메인별 — 하나 로드
| 파일 | 로드 시기 |
|---|---|
load_skill("website-building/webapp") | SaaS, 대시보드, 관리자, 전자상거래, 브랜드 경험(풀스택 템플릿이 있는 하위 스킬) |
skills/website-building/webapp/dashboards.md | 대시보드 또는 데이터 밀집 인터페이스(웹앱과 함께) |
informational/informational.md | 개인 사이트, 포트폴리오, 에디토리얼, 소규모 비즈니스, 랜딩 |
game/game.md | 브라우저 게임, Three.js, WebGL, 인터랙티브 3D |
game/2d-canvas.md | 2D Canvas 게임(game.md와 함께) |
game/game-testing.md | 모든 브라우저 게임 — game.md와 함께 로드 |
인터랙티브 QA: 지속적인 브라우저 자동화를 위해 shared/12-playwright-interactive.md를 읽으세요(스크린샷, 기능 테스트, 시각적 QA). 게임 테스트에 필수이며, 복잡한 사이트에 유용합니다.
워크플로우
- 디자인 방향: 목적을 명확히 하고, 미적 방향을 선택합니다.
- 버전 관리: 스캐폴딩 후 프로젝트 디렉토리에서
git init을 실행합니다. 각 주요 이정표 후 짧은 메시지와 함께 커밋합니다. - 빌드: 사이트를 페이지별로 빌드하고 Playwright를 통해 스크린샷을 찍어 시각적 QA를 수행합니다.
- 게시: 모든 변경 사항을 커밋한 후
deploy_website()로 공개 URL을 반환합니다.
모든 도구 사용
- 먼저 조사하세요. 디자인하기 전에 웹에서 참조 사이트, 트렌드, 경쟁사 예제를 검색하세요. 특정 사이트 유형의 수상 경력에 빛나는 예제를 찾아보세요. 사용자가 제공한 URL을 가져오세요.
- 실제 에셋을 아낌없이 생성하세요. 히어로, 섹션 일러스트레이션, 에디토리얼 피처 비주얼, 분위기 배경을 위한 이미지를 생성하세요. 단 하나의 히어로 이미지만 생성하지 마세요. 모든 긴 페이지는 사이트의 아트 디렉션과 일치하는 생성된 이미지로 시각적 리듬을 가져야 합니다. 플레이스홀더는 안 됩니다. 모든 프로젝트에 대해 맞춤형 SVG 로고를 생성하세요(아래 참조). SVG는 사용자가 특별히 SVG 출력을 요청하지 않는 한 로고 전용입니다. 방향을 알려주는 웹 참조 이미지를 저장하세요.
- Playwright로 스크린샷 찍기(복잡한 사이트만). 여러 페이지 사이트, 웹 앱, 대시보드, 게임의 경우
skills/website-building/shared/12-playwright-interactive.md를 읽어 데스크톱(1280px+) 및 모바일(375px)에서 스크린샷을 찍으세요. 단순한 단일 페이지 정적 사이트의 경우 Playwright를 건너뛰세요. 아래 Visual QA를 참조하세요. - 프로덕션 코드를 직접 작성하세요. HTML, CSS, JS, SVG. 빌드 도구 및 파일 처리를 위해 bash를 사용하세요.
SVG 로고 생성
모든 프로젝트는 맞춤형 인라인 SVG 로고를 받습니다. 스타일이 적용된 텍스트 제목을 절대 대체하지 마세요.
- 브랜드 이해 — 목적, 어조, 정의하는 한 단어
- SVG 직접 작성 — 기하학적 모양, 글자체 또는 추상적 마크. 기억에 남는 하나의 모양.
- 원칙: 기하학적/미니멀(Paul Rand, Vignelli). 24px와 200px에서 모두 작동. 먼저 단색 — 색상은 강화용으로 추가. 다크/라이트 모드를 위해
currentColor사용. - 인라인 구현
aria-label,viewBox,fill="none",currentColor스트로크 포함 - 파비콘 생성 — 필요한 경우 단순화된 32x32 버전
SVG 애니메이션의 경우(DrawSVG, MorphSVG) shared/03-motion.md를 참조하세요. SVG 패턴/필터의 경우 shared/07-toolkit.md를 참조하세요.
Visual QA 테스트 프로세스
Playwright QA 사용 시기
간단한 사이트는 Playwright를 건너뛰세요. 단일 페이지 정적 사이트는 Playwright 스크린샷이 필요하지 않습니다. 코드를 직접 검토한 다음 배포하세요. Playwright QA는 상당한 시간이 추가되며 간단한 정적 콘텐츠에는 가치가 없습니다.
복잡한 사이트에는 Playwright를 사용하세요. 여러 페이지 사이트, 웹 애플리케이션, 대시보드, 게임 및 인터랙티브 기능(양식, 장바구니, 필터, 차트, 드래그 앤 드롭)이 있는 모든 사이트는 Playwright QA를 사용해야 합니다. 지속적인 브라우저 자동화를 위해 skills/website-building/shared/12-playwright-interactive.md를 읽으세요.
Playwright QA 프로세스(복잡한 사이트만)
사이클: 빌드 → Playwright QA → 평가 → 수정 → 반복 → 준비되면 배포
1단계: 페이지별 QA
각 페이지를 빌드한 후:
- 데스크톱(1280px+) 및 모바일(375px)에서 Playwright를 통해 스크린샷을 찍습니다.
- 비판적으로 평가: 전문적으로 디자인되었는가(AI 생성처럼 보이지 않는가)? 타이포그래피가 차별화되었는가? 여백이 넉넉한가? 명확한 시각적 계층 구조가 하나 있는가?
- 다음으로 넘어가기 전에 모든 문제를 수정하세요. 시각적 부채를 남기지 마세요.
2단계: 최종 QA(게시 전)
- 모든 페이지의 데스크톱 및 모바일 스크린샷을 찍습니다.
- 페이지 간 일관성 확인(간격, 색상, 텍스트 처리)
- 다크 모드 확인(최소 홈페이지 두 테마 스크린샷)
- 인터랙티브 상태 확인: 호버, 포커스, 액티브, 로딩, 빈 상태, 오류
- 첫인상 테스트: 세련되고 의도적으로 느껴지는가?
QA 실패: 텍스트 오버플로, 일관성 없는 간격, 토큰 외 색상, 다크 모드 누락, 모바일에서 눌림, 일반적인 AI 느낌, 플레이스홀더 콘텐츠, 로고 누락.
1단계: 아트 디렉션 — 묻기 전에 추론하고, 기본값으로 가기 전에 물어보기
모든 사이트는 콘텐츠에서 파생된 시각적 정체성을 가져야 합니다. Nexus 대체 팔레트로 건너뛰지 마세요. Nexus 팔레트는 추론과 질문 모두 실패했을 때의 최후의 수단입니다. 편리한 기본값이 아닙니다.
- 주제에서 추론하세요. 커피 로스터 사이트 → 어스니 브라운, 따뜻한 크림, 손으로 그린 느낌. 핀테크 대시보드 → 쿨 슬레이트, 날카로운 산세리프, 데이터 밀집. 어린이 학습 앱 → 밝은 원색, 둥근 서체, 장난기 있는 모션. 콘텐츠 자체가 사용자가 한마디도 하기 전에 팔레트, 타이포그래피, 간격을 알려줍니다.
- 아트 디렉션 테이블을 확인하세요. 각 도메인 파일(
informational.md,webapp/SKILL.md,game/game.md)에는 사이트/제품 유형을 컨셉 기반 방향 및 토큰 시작점에 매핑하는 아트 디렉션 테이블이 있습니다. 이를 발판으로 사용하세요. - 다섯 가지 기둥 도출: 색상(따뜻함/차가움, 주제의 악센트), 타이포그래피(세리프/산세리프, 디스플레이 개성), 간격(밀집/넉넉함), 모션(미니멀/표현적), 이미지(사진/일러스트레이션/타입 전용).
- 주제가 진정으로 모호하다면 물어보세요. — "어떤 분위기를 원하시나요?" 및 "참조 사이트가 있나요?" 한 가지 질문으로 충분합니다.
- Nexus 대체 — 추론 AND 질문 모두 아무것도 얻지 못한 경우에만. 사용자에게 질문했지만 방향을 제시하지 않았고, 주제도 명확한 신호를 주지 않는 경우에만 Nexus/Swiss 기본값으로 대체하세요.
대체: 깔끔하고 스위스 스타일(최후의 수단)
추론이 명확한 방향을 제공하지 못했고 사용자에게 질문했지만 스타일 지침을 받지 못한 경우 shared/01-design-tokens.md의 기본값을 다음 설정과 함께 사용하세요:
- 타이포그래피: Satoshi 또는 General Sans 본문(Fontshare — 선호) 또는 Inter/DM Sans. 글꼴 대비보다 두께 대비. 최대 3-4개 크기. 텍스트를 간결하게 유지 —
--text-3xl/--text-hero는 정보 제공 사이트 히어로 전용입니다. - 색상: Nexus 팔레트. 중립 표면 + CTA 전용 틸 악센트 하나.
- 레이아웃: 그리드 정렬. 넉넉한 여백. 흥미로운 곳에서 비대칭.
- 모션: 미니멀하고 기능적. 부드러운 상태 전환만.
- 이미지: 깔끔하고 관련성 높은 비주얼을 생성하세요. 스톡 사진 없음.
아트 디렉션 — AI 미학 피하기
전체 안티 패턴 목록은 shared/08-standards.md를 참조하세요.
2단계: 게시
deploy_website()를 프로젝트 경로 및 사이트 이름과 함께 호출하세요. 공개 S3 URL을 반환합니다. 업데이트하려면 로컬 파일을 편집하고 동일한 경로로 재배포하세요. 정확한 호출 및 예제는 shared/09-technical.md를 참조하세요.