webbuild은(는) 무엇을 하나요?
비즈니스 소유자가 기꺼이 비용을 지불할 만한 웹사이트를 만드세요. 그들만의, 휴대폰에서 빠르게 로딩되는, 기억에 남는 단 하나의 순간이 있고, "AI가 만들었다"고 외치지 않는 사이트. 공예의 대부분은 코드를 작성하기 전의 선택과 결과를 정직하게 바라보는 데 있습니다.
아래 경로는 이 스킬의 폴더(scripts/, references/, assets/) 기준 상대 경로입니다.
0. 프로젝트 설정 (2분)
- 새 사이트 →
assets/starter/폴더를 프로젝트 폴더에 복사합니다 (일반 HTML + CSS + ES 모듈, CDN 임포트 고정, 빌드 단계 없음: 어디든 배포 가능, 편집 용이). 사용자가 요청하거나 프로젝트가 이미 Next.js/Astro/R3F를 사용하는 경우에만 사용하세요(references/3d-playbook.md§5). - 기존 프로젝트 → 프레임워크, 토큰 및 컴포넌트를 유지합니다. 이 스킬은 방향, 모션 및 QA를 추가할 뿐 다시 작성하지 않습니다.
- 프로젝트에
BUILD_NOTES.md를 만드세요. 이는 컨텍스트 재설정 간의 메모리 역할을 합니다: 브리핑, 결정, 미해결 질문, 효과가 있었던 수정 사항.
1. 브리핑 — 진짜 비즈니스를 파악하세요
수집하세요 (사용자, 비즈니스의 현재 사이트, Google 비즈니스 프로필, 인스타그램에서): 이름, 판매하는 제품/서비스, 위치, 운영 기간, 하나의 주요 액션 (전화 / 예약 / 주문 / 견적 요청 / 방문), 실제 증거 (평점 + 리뷰 수, 운영 연수, 라이선스, 보도 자료), 실제 사진, 로고/색상, 영업 시간, 주소, 전화번호. references/design-system.md §2의 5줄 브리핑을 BUILD_NOTES.md에 작성하세요.
절대 사실을 지어내지 마세요 — 조작된 리뷰, 통계, 가격 또는 주소는 비즈니스 소유자가 읽는 순간 신뢰를 무너뜨립니다. 대신:
- 알 수 없는 정보를 우회하여 데모가 여전히 완성된 것처럼 보이게 하세요: "Koregaon Park, Pune"(지어낸 번지수 대신); "Google 평점 4.7"(지어낸 인용구 대신); 가격 없는 서비스 이름, 또는 알고 있는 경우에만 "₹…부터".
- 사실이 정말로 필요한 경우(전화번호, 정확한 주소, 영업 시간), 눈에 띄는
{{placeholder}}를 사용하세요 —slop_check.py는 채워질 때까지 배포를 차단합니다. - 모든 알 수 없는 정보와 가정은 최종 보고서를 위한 "고객에게 물어볼 것" 목록에 넣으세요.
크리에이터 또는 채널 사이트의 경우, 대시보드 숫자와 프로필 사진을 미리 요청하거나 가져오세요: YouTube Studio / Instagram 인사이트 스크린샷, 그리고 연결된 경우 vidIQ 등. 실제 숫자로 구성된 '결과' 섹션이 제품을 판매합니다.
브리핑이 부족하고 사용자가 주변에 있다면, 최대 3개의 질문을 하세요(비즈니스 + 도시, 주요 액션, 마음에 드는 사이트). 사용자가 그냥 진행하길 원한다면, 합리적인 가정을 하고, 기록한 후 계속 진행하세요.
2. 참고 자료 (사용자가 사이트 이름을 지정하거나, 녹화본을 보내거나, "리빌드"를 원할 때)
references/reverse-engineer.md를 따르세요: node scripts/teardown.mjs <url>은 스택, 폰트, 팔레트, 미디어 및 셰이더 증거를 측정하고 스크롤을 스크린샷으로 캡처합니다; 화면 녹화는 프레임으로 변환되어 읽고 비트 단위 모션 사양으로 만듭니다. 빠른 패스로 효과를 설명할 수 없을 때는 REA의 엔진으로 더 깊이 들어가세요: scripts/rea-teardown.sh <url>은 페이지를 캡처하고, 번들을 지문 분석하며, 모든 스크립트를 내보내어 실제로 어떻게 구축되었는지 읽을 수 있게 합니다(가이드는 references/rea/에 있음). OBSERVED(관찰) → INFERENCE(추론) → DECISION(결정)을 기록하세요. 기술을 배우되, 브랜드, 카피, 에셋 또는 코드는 절대 복사하지 마세요.
3. 방향 — 계획을 세우고, 그 계획을 비판하세요
references/design-system.md를 읽으세요 (안티-슬롭 규칙 — 클래식 그리고 크림 + 테라코타, ALL-CAPS 눈썹 텍스트, 편집용 가는 선과 같은 새로운 "취향 있는 AI" 특징들). BUILD_NOTES.md에 다음을 작성하세요:
- 비즈니스에서 가져온 4–6개의 명명된 색상 토큰, 타이포그래피 페어링 및 역할, 모서리 스타일
- 각 섹션의 ASCII 와이어프레임 (리듬을 다양하게 — 히어로 → 3개 카드 → 로고들 → 사용후기 순서 유지 금지)
- 시그니처 모먼트 (정확히 하나)와 이것이 이 비즈니스에 적합한 이유
- 차별화를 만드는 3가지 원칙
그런 다음 텔 목록(tell list)에 대해 계획을 검토하고, 기본값처럼 읽히는 각 선택에 대해 이 비즈니스에 맞게 정당화하거나 변경하세요. "로고만 바꾸면 다른 비즈니스에도 속할 수 있나?"라고 질문하는 것이 문제를 저렴하게 잡아내는 가장 좋은 방법입니다.
방향이 정해지지 않아 사용자가 선택하기를 원한다면, 빌드하기 전에 2–3개의 진정으로 다른 방향(각각 정지 이미지나 빠른 HTML 스케치)을 보여주세요 — 21st-ui-explore가 설치되어 있다면 도움이 될 수 있습니다.
4. 히어로 — 비즈니스에 도움이 되는 모드를 선택하세요
references/3d-playbook.md §1에 결정 테이블이 있습니다. 요약:
- 정지 이미지 (훌륭한 사진/타이포그래피) — 장소, 음식, 미용실, 병원, 서비스 업종. 종종 올바른 선택입니다.
- 비디오 — 분위기 루프, 이상적으로는
assets/starter/grade.js로 보정하여 AI/스톡 영상이 맞춤 등급(그레인, 헐레이션, 리프트/감마/게인, 비네트)을 받도록 합니다. LOOK을 선택하고 미묘하게 유지하세요. - 프레임 — "$10,000 3D 웹사이트": AI 시작/종료 키프레임 → 첫 번째/마지막 프레임 비디오 →
scripts/frames.sh→ 스크롤로 스크러빙되는 캔버스. 키프레임 규칙, 프롬프트 및 블렌딩은references/scroll-video-playbook.md를 읽으세요. - 씬(scene) — 3D가 제품 스토리 그 자체일 때(구성 가능한 제품, 건축, 기술) 라이브 Three.js/R3F. 주제는 비즈니스의 것이어야 하며, 절대 기본 매듭(placeholder knot)이 아니어야 합니다.
- 전체 페이지 — 소유자가 "3D 웹사이트"를 요청할 때, 보통은 3D 히어로가 아니라 페이지 전체에 3D가 있기를 의미합니다. 섹션당 하나의 고정 카메라 위치가 있는 단일 씬을 사용하세요(
references/3d-playbook.md§6).
연결된 도구(Higgsfield / Kling / kie.ai / Nano Banana MCPs 또는 스킬)로 에셋을 생성하거나, 사용자에게 파일을 넣어달라고 요청하세요. 아무것도 사용할 수 없으면 명확하게 라벨이 지정된 플레이스홀더로 빌드하고 정확히 어떤 에셋을 생성해야 하는지 프롬프트와 함께 목록화하세요.
5. 빌드
순서: 토큰(styles.css :root) → 실제 카피가 있는 시맨틱 HTML 섹션 → 390px 및 1440px에서 레이아웃 → 히어로 모드 → 모션은 마지막.
- 카피 규칙:
references/design-system.md§8 (결과 + 장소 + 구체성, 실제 CTA 동사, 금지어). - 비즈니스 사이트에 필수: 접힌 부분 위에 하나, 마지막에 하나의 명확한 CTA,
tel:/ 예약 / 양식, 영업 시간 + 주소 + 지도 링크, 실제 증거, 제목 + 설명 + OG 이미지, LocalBusiness JSON-LD, 파비콘, 액션이 전화일 때 모바일의 고정 전화/예약 바. - 모션: 하나의 시그니처 모먼트 + 조용한 150–300 ms 마이크로 피드백; ease-out 사용, bounce 사용 금지;
transform/opacity만 사용; 축소 모션에서는 최종 상태를 표시합니다. - 컴포넌트: 복잡한 효과를 직접 코딩하기 전에
references/resources.md레지스트리(21st.dev, React Bits, Aceternity, Motion Primitives…)를 검색한 후 토큰에 맞게 다시 스타일링하세요. 정적 사이트에서는 React 컴포넌트를 바닐라로 다시 빌드하세요. 하나의 효과를 위해 React를 추가하지 마세요. - 푸터:
references/design-system.md§11에 따라 빌드하세요(브랜드 블록, 플랫폼 로고가 있는 링크 열, 연락처 버튼, 큰 워드마크, 하단 행). 소유자는 사이트 전체를 푸터로 판단합니다. 작은 제작자 크레딧은 이미 스타터에 포함되어 있습니다. 클라이언트가 제거를 요청할 수 있습니다. - 버튼 및 스크롤:
references/design-system.md§12를 따르세요(촉각적인 0.16초 버튼, 스타터의cursor.js를 통한 커서 링, 네이티브 스크롤바 없음: 스타터의blockbar.js가 대체). - 완료했다고 부르기 전에
references/design-system.md§10을 다시 읽으세요: 모든 규칙을 통과한 후에도 소유자들이 여전히 "슬롭"이라고 부르는 것들.
6. 살펴보기 — 좋은 사이트는 여기서 만들어집니다
로컬에서 서빙한 후(npx serve . 또는 프로젝트의 dev 서버):
node scripts/shoot.mjs http://localhost:3000 ./shots— 스크롤에 따른 휴대폰/노트북/데스크탑 스크린샷 + 콘솔 오류, 오버플로우, LCP, 용량. PNG를 읽으세요. (또는 사용 가능한 경우 브라우저 창 / Playwright MCP를 사용하세요.)--reduced-motion플래그로도 한 번 실행하세요.python3 scripts/slop_check.py .— 0 FAIL로 끝나야 합니다. WARN은 질문으로 간주하세요. (npx impeccable detect는 설치된 경우 좋은 두 번째 의견입니다.)- 브리핑에 대해 정직하게 비판하세요: 계층 구조, 타이포그래피, 색상, 시그니처 모먼트, 모바일, 카피의 구체성. 명확한 의도로 배치 단위로 수정하세요("하위 섹션이 제너릭해 보임 — 더 바쁘게 만들지 말고 더 고급스럽게 만드세요").
- 완료했다고 부르기 전에 장식 요소 하나를 제거하세요.
3–6회의 수정 라운드를 예상하세요. 한 번에 완벽한 사람은 없습니다. BUILD_NOTES.md에 무엇이 무엇을 수정했는지 기록하세요.
7. 배송 + 피칭
- 배포: Vercel / Netlify / Cloudflare Pages / GitHub Pages. 프레임 폴더를 커밋하세요 (가장 흔한 "히어로가 프로덕션에서 사라짐" 버그). 클라이언트가 구매할 때까지 스펙 데모에
<meta name="robots" content="noindex">를 추가하세요. - 피칭이라면,
references/pitch-and-sell.md를 읽으세요: 전후 비교 비디오, 아웃리치 스크립트, 가격 책정 닻, 피칭 준비 체크리스트, 인수인계.
사용자에게 최종 보고서
짧고 구체적으로 유지하세요:
- 무엇이 구축되었는지 (방향을 한 줄로, 시그니처 모먼트, 히어로 모드) 및 위치 (경로, URL)
- 실행 방법 (
npx serve .또는 dev 명령어) - QA 결과: slop_check FAIL/WARN 개수, shoot.mjs LCP/뷰포트별 오류, 살펴보고 수정한 사항
- 고객에게 물어볼 것 목록: 모든
{{placeholder}}와 가정 - 아직 생성해야 할 에셋(사용 준비된 프롬프트와 함께) (있는 경우)
참고 자료 맵
| 읽을 자료 | 사용 시기 |
|---|---|
references/design-system.md | 항상, 색상/타이포그래피/레이아웃/카피를 선택하기 전에 |
references/3d-playbook.md | 히어로 선택 시; 모든 Three.js/R3F; 성능 + 접근성 예산 |
references/scroll-video-playbook.md | AI 비디오에서 스크롤 스크럽 "3D" 히어로 생성 시 |
references/reverse-engineer.md | 참조 사이트, 녹화본, 또는 잠재 고객 사이트 리빌드 시 |
references/rea/README.md | teardown.mjs보다 REA 도구로 더 깊이 분석할 때 |
references/resources.md | 컴포넌트 레지스트리, 효과 도구, 영감, 동반 스킬 |
references/pitch-and-sell.md | 잠재 고객을 위한 스펙 사이트, 가격 책정, 아웃리치, 인수인계 |
| 스크립트 | 기능 |
|---|---|
scripts/teardown.mjs <url> | 참조 사이트 측정 (스택, 폰트, 팔레트, 미디어, 셰이더, 스크린샷) |
scripts/rea-teardown.sh <url> | REA 엔진으로 심층 분석: 페이지 캡처, 번들 지문, 내보낸 스크립트 |
scripts/frames.sh <video> <out> | 비디오 → WebP 프레임 시퀀스 (데스크탑 + 모바일) + 매니페스트 |
scripts/shoot.mjs <url> [out] | 스크롤에 따른 3가지 너비 스크린샷 + 오류/LCP/오버플로우 |
scripts/slop_check.py <dir> | AI-슬롭 + 배포 준비 린터 (배포하려면 0 FAIL) |
.mjs 스크립트용 Playwright: npm i -D playwright && npx playwright install chromium.