애니메이션 웹사이트 파이프라인은(는) 무엇을 하나요?
종단간 - URL을 입력하면 배포된 Netlify URL이 출력됩니다. 네 단계, 중간 프롬프트 없음. 출력물은 $PWD/sites/<slug>/ 아래에 네임스페이스되어 여러 사이트가 하나의 상위 프로젝트에 공존할 수 있습니다.
작동 방법
- 사용자 메시지 또는
$1인수에서 URL을 추출합니다. URL이 없으면 한 번만 물어보고 중단합니다. 그렇지 않으면 조용히 진행합니다. - URL 호스트에서 슬러그(slug) 와 사이트 이름을 파생합니다:
- 호스트
acmegrowthpartners.com→ 슬러그acme-growth, 사이트 이름Acme Growth Partners(타이틀 케이스) www.제거, TLD 제거, 점을 하이픈으로 바꾸고 소문자로 변환. 사람 친화적인 사이트 이름은 브랜드 인식에 기반한 합리적인 타이틀 케이스를 사용합니다 (예:acmegrowthpartners.com→Acmegrowthpartners가 아닌Acme Growth Partners). 슬러그는 파일명과 URL에만 사용합니다.
- 호스트
- 필수 구성 요소를 병렬로 확인합니다:
npx playwright --version(브랜드 북 추출 의존성)grep -l KIE_AI_API_KEY "$PWD/.env" || grep -l KIE_AI_API_KEY "$HOME/<your-project-dir>/.env"(KIE.ai API 키)command -v netlify(배포 단계를 위한 Netlify CLI)mkdir -p "$PWD/sites/<slug>"
필수 구성 요소 중 하나라도 실패하면 정확한 문제를 표시하고 중단합니다. Playwright, Netlify를 설치하거나 API 키를 추측하려고 시도하지 마세요.
1단계 — 브랜드 북 (건너뛰기 가능)
건너뛰기 조건: $PWD/sites/<slug>/brand/typography.md, colors.md, tailwind.snippet.js, reference.png가 모두 존재하고 reference.png가 최근 24시간 이내에 수정된 경우. 건너뛰면 "→ 브랜드 북 캐시 재사용"을 로그로 기록하고 진행합니다.
- 브랜드 북 추출기를 실행합니다:
node ~/.claude/skills/brand-book/extract.js "<URL>" "$PWD/sites/<slug>/brand" sites/<slug>/brand/type-styles.json,sites/<slug>/brand/css-variables.json을 읽고sites/<slug>/brand/reference.png를 봅니다.- 브랜드 북 스킬의 형식에 따라
sites/<slug>/brand/typography.md,colors.md,tailwind.snippet.js,README.md를 작성합니다 - 불일치 우선, 타입 스케일 표, 팔레트 그룹, 의미론적 이름의 Tailwind 토큰. 합리화하고 코드화하지 않는 규칙을 적용합니다. - 묻지 않고 GitHub에 자동 게시합니다 (이것은 귀하의 GitHub 계정 아래에 공개 리포지토리를 생성합니다 — 아래에
<your-github-username>을 설정하거나, 브랜드 북을 게시하고 싶지 않으면 이 단계를 제거하세요):- 리포지토리 이름:
Brand-Book-<TitleCaseSlug>(예:Brand-Book-Acme-Growth-Partners). 단어 사이에 하이픈. mcp__github__create_repository(소유자:<your-github-username>, 공개, autoInit: true)를 사용한 다음, 6개 파일 모두와 함께mcp__github__push_files를 사용합니다 (reference.png는 도구 인수 제한에 비해 너무 크므로 건너뜁니다).- 리포지토리가 이미 존재하는 경우 (create에서 HTTP 422), 계속 진행합니다 - 바로
mcp__github__push_files를 호출하여 업데이트합니다.
- 리포지토리 이름:
캡처: BRAND_REPO_URL, 그리고 colors.md에서 합리화된 기본, 강조, 중립, 표면-어두움 16진수 값 (3단계에서 다시 읽습니다).
2단계 — 히어로 루프 영상 (건너뛰기 가능)
건너뛰기 조건: $PWD/sites/<slug>/hero-loop-7s.mp4가 존재합니다. "→ 히어로 영상 캐시 재사용"을 로그로 기록하고 진행합니다.
- 방금 작성한 브랜드 북 아티팩트에서 시각적 컨셉을 도출합니다:
colors.md에서 합리화된 팔레트를 검사합니다 → 지배적인 브랜드 감정을 선택합니다 (예: 성장 지향 브랜드의 경우 궤적 + 잠금 해제; 따뜻한 팔레트의 경우 따뜻함 + 장인정신; 미니멀 단색의 경우 절제 + 정밀).reference.png에서 시각적 모티프를 살펴봅니다 (그라데이션 방향, 선 작업, 입자/그레인 처리, 기하학적 모양).- 브랜드의 언어적 포지셔닝을 모션에 매핑하는 한 문장 영상 은유를 종합합니다.
- 이것은 창의적인 작업입니다 - 진지하게 받아들이고 일반적인 템플릿에 의존하지 마세요. 스크린샷을 확인하세요.
- 루프의 "시작" 비트를 포착하는 1:1 정지 이미지로 Nano Banana 2 이미지 프롬프트를 작성합니다. 정확한 브랜드 16진수 코드를 참조하세요. "텍스트 없음, 로고 없음, 시네마틱, 프리미엄 B2B 미학"으로 끝맺습니다.
- Nano Banana 2에 제출합니다:
source "$PWD/.env" 2>/dev/null || source "$HOME/<your-project-dir>/.env" curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @- <<EOF { "model": "nano-banana-2", "input": { "prompt": "<IMAGE_PROMPT>", "output_format": "png", "image_size": "1:1" } } EOFtaskId를 캡처합니다.state == "success"가 될 때까지https://api.kie.ai/api/v1/playground/recordInfo?taskId=<ID>를 폴링합니다.data.resultJson(JSON 문자열)에서 URL을 파싱합니다. 다운로드하지 마세요 - 클라우드 URL을 유지합니다. - 7초 동안의 시간 코드 비트로 Seedance 프롬프트를 작성합니다. 항상 다음을 포함하세요:
- 0-2초: 구축 (카메라 드리프트, 분위기)
- 2-4초: 빌드 (모션 가속화/수렴)
- 4-5초: 해제 (브랜드 "잠금 해제" 순간 - 일반적으로 강조 색상이 퍼짐)
- 5-7초: 해결 (루프 가능한 상태로 안정화)
- 꼬리말: "느린 제어된 카메라, 떨림 없음. 현실적인 빛 발광 물리. 텍스트 없음, 로고 없음."
- 클라우드 이미지 URL을
image_url로 Seedance 2에 제출합니다:taskId를 캡처합니다. 백그라운드에서 폴링 루프를 실행합니다 (cat > /tmp/seedance-payload.json <<'EOF' { "model": "bytedance/seedance-2", "input": { "prompt": "<VIDEO_PROMPT>", "image_url": "<CLOUD_IMAGE_URL>", "duration": 7, "resolution": "480p", "aspect_ratio": "16:9" } } EOF curl -s -X POST "https://api.kie.ai/api/v1/playground/createTask" \ -H "Authorization: Bearer $KIE_AI_API_KEY" \ -H "Content-Type: application/json" \ --data-binary @/tmp/seedance-payload.jsonrun_in_background: true) - 일반적으로 3-5분 소요. 완료 알림을 받으면recordInfo엔드포인트를 직접 호출하여state를 읽습니다 (bash 내 Python 폴링 파서는 취약하므로 백그라운드 알림 후 직접 curl을 선호). - 최종 영상을
$PWD/sites/<slug>/hero-loop-7s.mp4로 다운로드합니다.
캡처: VIDEO_PATH.
3단계 — 프론트엔드 디자인 빌드 (건너뛰기 가능)
건너뛰기 조건: $PWD/sites/<slug>/index.html이 존재합니다. "→ 사이트 캐시 재사용"을 로그로 기록하고 진행합니다. (사용자가 재빌드를 원하면 파일을 삭제하거나 요청에 --force를 전달합니다.)
이것은 사용자가 claude.ai의 Artifacts와 비교하는 작업 산출물입니다. 품질이 중요합니다.
- 프론트엔드 디자인 하위 스킬에 대한 컨텍스트를 로드합니다:
sites/<slug>/brand/tailwind.snippet.js읽기 (전체 내용)sites/<slug>/brand/typography.md및colors.md읽기 (합리화 요약만)- 로컬 영상 경로 참고:
./hero-loop-7s.mp4(index.html과 형제 — 중요: 이전 구조처럼../references/...를 사용하지 마세요) - 소스 URL 참고 (콘텐츠/카피 참조용 - 페이지는 복제본이 아닌 리비전이어야 함)
- Skill 도구를 통해
frontend-design:frontend-design스킬을 호출합니다. 모든 다음을 포함하는 단일 자체 포함 프롬프트를 전달하세요:- 출력 경로 -
$PWD/sites/<slug>/index.html(단일 파일, 자체 포함). 영상은 그 옆에./hero-loop-7s.mp4에 있습니다. - 브랜드 토큰 -
sites/<slug>/brand/tailwind.snippet.js의 전체 Tailwind theme.extend 블록을 붙여넣습니다. - 히어로 영상 - 히어로 배경으로
<video autoplay loop muted playsinline>과 함께 src./hero-loop-7s.mp4를 참조하고, 텍스트 가독성을 위해 어두운 그라데이션 스크림을 추가합니다. - 콘텐츠용 소스 URL - 디자인 하위 스킬에
<URL>의 랜딩 페이지 리비전을 작성하라고 지시합니다: 가치 제안과 주요 섹션(히어로, 사회적 증명, 서비스/솔루션, CTA, 푸터)을 유지하되 디자인 품질, 타이포그래피 계층 구조 및 모션 폴리시를 향상시킵니다. - 품질 기준 - "프로덕션 수준, 차별화됨, 일반적인 AI 미학 피함. 사용자는 이것을 claude.ai Artifacts 출력과 비교하고 있습니다 - 더 높은 목표를 설정하세요."
- 기술 스택 - 바닐라 HTML + CDN을 통한 Tailwind (
https://cdn.tailwindcss.com) + Lucide 아이콘 + Google Fonts. Tailwind 구성을 인라인으로 포함하여 브랜드 토큰을 사용합니다. - 콘텐츠 정확성 - 라이브 사이트에 명명된 제품/모듈/서비스가 있으면 그대로 사용합니다. 확실하지 않으면 카피를 작성하기 전에 WebFetch를 사용하여 URL에서 실제 모듈을 열거합니다. 존재하지 않는 제품을 만들어내지 마세요.
- 출력 경로 -
- 하위 스킬이 완료된 후
$PWD/sites/<slug>/index.html이 존재하고./hero-loop-7s.mp4를 참조하는지 확인합니다.
캡처: SITE_PATH.
4단계 — Netlify 배포
- 이 슬러그에 대한 Netlify 사이트를 생성하거나 재사용합니다. 명확하고 안정적인 사이트 이름 패턴을 사용하세요:
animated-<slug>(예:animated-acme-growth). $PWD/sites/<slug>/에서 프로덕션으로 배포합니다:cd "$PWD/sites/<slug>" && netlify deploy --prod --dir=. --site=animated-<slug> 2>&1- 슬러그에 대한 첫 번째 실행에서 Netlify는 사이트가 존재하지 않는다고 말할 것입니다. 그 경우 명시적으로 생성하세요:
netlify sites:create --name=animated-<slug>그런 다음 배포를 다시 실행하세요. - 배포 출력에서
Website URL:을 캡처합니다 (라이브*.netlify.appURL).
- 슬러그에 대한 첫 번째 실행에서 Netlify는 사이트가 존재하지 않는다고 말할 것입니다. 그 경우 명시적으로 생성하세요:
- 빠른 스모크 체크:
curl -sI <LIVE_URL> | head -1은HTTP/2 200을 반환해야 합니다. 그렇지 않으면 실패를 표시하지만 로컬 경로는 여전히 보고합니다.
캡처: LIVE_URL.
최종 출력
네 단계가 모두 성공하면 사용자에게 하나의 짧은 메시지 - 네 개의 링크만 보냅니다:
라이브 - <LIVE_URL>
브랜드 북 - <BRAND_REPO_URL>
히어로 영상 - <VIDEO_PATH>
로컬 사이트 - <SITE_PATH>
무엇이 빌드되었는지 요약하지 마세요. 요약하지 마세요. 로컬 파일을 자동으로 열지 마세요 - 라이브 URL이 이제 전달물입니다.
주의 사항
- 실행 중에 사용자에게 묻지 마세요. 핵심은 중간에 핸드오프가 없다는 것입니다. 진정으로 누락된 것이 있으면 (URL 없음, API 키 없음, Netlify CLI 없음) 차단기를 표시하고 중단하세요 - 창의적 입력을 요청하지 마세요.
- 이미 실행된 단계는 건너뛰세요. 세 가지 아티팩트 단계는 모두 파일 존재 여부에 따라 멱등적입니다. 다시 실행하면 크레딧이 낭비됩니다.
- 영상 경로는 형제 HTML 파일에 상대적이어야 합니다.
./hero-loop-7s.mp4를 사용하고../references/...를 사용하지 마세요. 각 사이트는sites/<slug>/에 완전히 자체 포함됩니다. - 각 사이트는 자체 Netlify 사이트이지 하위 경로가 아닙니다.
--site=animated-<slug>로 배포하여 자체*.netlify.appURL을 얻습니다. 5개 사이트를 하나의 Netlify 프로젝트에 마운트하려고 하지 마세요. - KIE 호스팅 이미지 URL은 임시입니다 - 동일한 세션 내에서 Seedance 작업을 제출하세요.
data.resultJson은 객체가 아닌 JSON 문자열입니다. 파싱하세요.- GitHub 리포지토리가 이미 존재합니까? 실패하지 마세요 - 새 파일을 푸시하여 업데이트하세요.
- netlify-cli를 자동으로 설치하지 마세요.
command -v netlify가 실패하면 사용자에게npm install -g netlify-cli && netlify login을 실행하라고 알리고 중단하세요. - 브랜드 충실도 > 제품 이름에 대한 창의적 자유. 항상 라이브 사이트의 실제 제품/모듈 이름을 사용하세요. 페이지 카피를 작성하기 전에 WebFetch를 실행하여 확인하세요.
- 브랜드 북 스크린샷 품질은 컨셉 도출에 중요합니다. 스크린샷이 대부분 비어 있어도 (쿠키 배너 오버레이, 지연 로드된 섹션이 렌더링되지 않음) 계속 진행하세요 - type-styles JSON + 색상 팔레트 + 브랜드 포지셔닝에 대한 지식을 사용하여 컨셉을 도출하세요.