Moat → 3D 랜딩 페이지
회사(라이브 사이트 또는 moat 문장)를 완성되어 실행 중이고 스크린샷으로 검증된 랜딩 페이지로 전환합니다. 엔진은 template/에 작성되어 있습니다. 각 클라이언트마다 하나의 파일, src/content.js 를 작성하고, 이미지를 생성한 후 검증합니다. 엔진 변경 사항은 template/로 다시 포팅되어 다음 클라이언트가 모두 그 혜택을 받을 수 있게 합니다.
필요할 때 읽으세요 (모두 references/ 안에 있습니다):
intake.md 클라이언트 조사 · narrative.md moat → 스토리 → 카피 · art-direction.md 색상 이론, 타이포그래피, 조명, 가독성 · scenes.md 오브젝트 vs 씬, 섹션 컷 · engine.md 스키마 및 모듈 · qa.md 캡처 스크립트 및 평가 기준 · advanced.md 실제 자산 및 트렌드 로드맵 · lessons.md 지금까지의 모든 실수 — 시작하기 전에 훑어보세요.
참조 조사 자료(스킬과 함께 보관): references/research/oryzo-teardown.md, graphify-teardown.md,
video-and-writeup-research.md. 작업한 클라이언트: pages/poolco/, pages/secureco/, pages/hotelsaas/.
참조 자료를 한 문단으로 요약
Oryzo는 하나의 히어로 오브젝트를 중앙에 배치하고 그 주변 세계(카메라, 렌더 모드, 그레이딩, 라이트/다크)를 변경합니다 — 짧고 무표정한 카피, 각 비트마다 하나의 주장 + 하나의 증거; 키가 큰 DOM 뒤에 고정된 단일 WebGL 캔버스, 모든 이징된 값은 스프링입니다. Graphify는 3D를 양념처럼 사용합니다: 스티키 "작동 방식" 섹션의 다이어그램 자체가 제품 은유(투영된 SVG 와이어프레임)이며, 증거 밀도로 판매합니다. 우리는 이 둘을 융합합니다 — 그리고 물리적 비즈니스의 경우 추상적인 오브젝트를 잘라서 라벨을 붙일 수 있는 실제적이고 식별 가능한 씬으로 대체합니다.
워크플로우 (모든 단계를 순서대로 수행하세요)
1 · 인테이크 및 조사 → research/<slug>/brief.md
클라이언트에 사이트가 있으면 모든 페이지를 먼저 크롤링하세요(intake.md): 텍스트, 서비스, 프로세스, 위치, FAQ, 약관/면책조항, 실제 로고 파일, 샘플 브랜드 색상 및 글꼴, 공개 연락처 정보. 추출할 내용: 회사, 한 문장으로 된 moat(반복되는 주장), 구매자, 실제 CTA, 실제로 존재하는 증거. 찾을 수 없거나 추론할 수 없는 것에 대해서만 사용자에게 한 번 질문하세요. 입력에 자격 증명 / 계정 번호 / 개인 데이터가 있으면 중단하고 먼저 경고하세요.
2 · 전략 (코드 작성 전에 brief에 기록)
- Moat 유형 → 은유 (
narrative.md §2). - 오브젝트 또는 씬? 1초 테스트 적용(
scenes.md). 장소/설치 → 씬 (pool패턴); 접근성/가시성에 관한 소프트웨어 →repo; 시계에 의해 운영되는 장소(호텔, 공연장, 소매업)를 위한 소프트웨어 →city; 제품 → 오브젝트 형태. - 테제 라인(카테고리 습관 vs moat가 실현하는 것).
- 챕터 계획: 10–15개 챕터 (
narrative.md §3, 또는 서비스 비즈니스의 경우 §3b 시공 순서). 모든 챕터는 카메라, 스테이지/모드, 그레이딩, 값, 레이아웃 모양 중 ≥ 2개를 변경합니다. - 모든 카피 (
§4): 헤드라인 ≤ 7단어, 본문 ≤ 35단어, 하나의 주장 + 하나의 증거, brief에서만 가져올 것. - 형식을 다양화하세요 — 어떤 두 클라이언트도 같은 페이지를 가질 수 없습니다. 스크롤이 의미하는 바(여정, 빌드 순서, 시계…), 독자가 하는 일(읽기, 탭, 드래그, 재생), 3D가 반응하는 대상(스크롤 전용 또는
send/receive를 통한 위젯)을 결정하고 brief에 작성하세요. 저장소가 있는 소프트웨어의 경우 챕터를 플레이 가능하게(type: 'play') 만드세요: 데모 데이터에서 제품의 실제 컴포넌트를 작고 정직하게 복사하여 3D를 움직이는 것 (engine.md→ HotelSaaS).
3 · 아트 디렉션
art-direction.md: 조명 우선 60·30·10 팔레트(브랜드 색상 + 제품 색상 + 보조 포인트 색상, 핸드오버에 이론 설명), 클라이언트 고유의 글꼴, 사실성을 위한 bloom 0, 복잡한 3D 위의 카피 카드, 모든 3D 챕터에 대한 모바일 키프레임.
4 · 이미지 (병렬 작업)
research/<slug>/images.json 작성(서비스별 사진 1장 + og) 후
node .claude/skills/moat-landing/tools/gen-batch.mjs research/<slug>/images.json
실행 (빌드하는 동안 백그라운드에서). 연락처 시트를 검토하고; 거부된 것은 다시 생성하세요. 원시 파일은 research/에 유지하고, 절대 public/에 넣지 마세요. 중요: GEMINI_API_KEY는 셸 환경에 있어야 합니다 — 절대 출력하거나 인수로 전달하지 마세요.
소프트웨어 / 개발자 브랜드: 사진 촬영은 건너뛰고; 히어로가 승인된 후 히어로 렌더링에서 직접 public/og.jpg를 만드세요(1200×630 뷰포트 스크린샷).
5 · 빌드
SLUG=<slug>; ROOT="${CLAUDE_PROJECT_DIR:-$(pwd)}"
mkdir -p "$ROOT/pages/$SLUG" && rsync -a --exclude node_modules --exclude dist "$ROOT/.claude/skills/moat-landing/template/" "$ROOT/pages/$SLUG/"
cd "$ROOT/pages/$SLUG" && npm install
src/content.js 재작성 (스키마: 템플릿의 content.js 상단 + engine.md), meta.url/image, business, brand.copyCards, quickActions, 챕터 notes/cover/mobile 포함.
페이지별 CSS는 brand.css에 넣습니다. 새로운 기능 → template/에 먼저 구축한 후,
rsync -a --exclude content.js template/src/ pages/<slug>/src/ 실행.
5b · 기타 페이지 (클라이언트 사이트에 다른 페이지가 있을 때)
원본 사이트의 모든 페이지를 원래 URL로 다시 구축하세요(src/pages/<slug>.js, engine.md → 다중 페이지):
각 하위 페이지는 동일한 3D 세계, 카드 언어 및 하나의 플레이 가능한 조각을 유지합니다(기능 → 탐색기,
가격 → 플랜 선택기, 정보 → 스토리 위젯); 법률 페이지는 라이브 텍스트와 함께 doc 유형을 사용하며(검토를 위해 날짜 및 관할권 플래그 지정); 연락처는 WhatsApp/이메일 양식을 사용합니다(승인 없이 백엔드 없음).
6 · 검증 (필수, 모든 반복, 두 사이즈 모두)
npm run check (예산 게이트) → 미리보기 → 모든 챕터를 1440×900 및 390×844로 캡처 →
연락처 시트 → 동작 + SEO 검사 → qa.md의 평가 기준. 2–3회 반복 예상.
7 · 핸드오버
실행 위치(npm run dev / 미리보기 URL), 테제, 챕터 맵, 색상 이론 근거,
클라이언트가 여전히 제공해야 하는 것(실제 증거, 양식 엔드포인트, 분석 ID, 도메인),
선택된 기본값, advanced.md §9의 상위 2–3개 업그레이드. 게시 전에 수치, 규제 및 비교 주장을 반드시 검증해야 한다는 점을 상기시키세요. lessons.md와 메모리를 학습한 내용으로 업데이트하세요.
디자인 규칙 (클라이언트 피드백 기반 — 기본 적용)
- 일초 인식성. 실제 것을 먼저 만드세요; 그런 다음 잘라서 보여주세요.
- 글로우 효과 없음. 실제 물체에는 Bloom 0; 빛은 태양, 하늘 및 씬 내 소스에서 옵니다.
- 물리적/서비스 비즈니스에는 밝고 햇살 가득한 팔레트; 야간/기술 주제에만 어두운 팔레트.
- 절대 질감 위에 텍스트를 배치하지 마세요. 물, 타일 및 복잡한 3D 위에는 카드 사용.
- 섹션 컷 + 고정 라벨로 설명하고, X-ray 글로우는 사용하지 마세요.
- 보이는 플레이스홀더를 절대 출시하지 마세요. 증거가 없으면 → 해당 챕터를 생략하고 핸드오버에 목록을 작성하세요.
비타협적 규칙
- 전체 페이지에 하나의 히어로(오브젝트 또는 씬); 흐름 콘텐츠는
cover챕터에 있습니다. - 스테이지를 스크럽하고, 카피를 트리거하세요 (카피는 재진입 시 다시 재생됨; 절대 단발성 아님).
- 텍스트는 HTML이며, 절대 텍스처나 이미지에 베이킹되지 않음; 구조화된 데이터는 페이지가 보여주는 것만 명시합니다.
- 정직함. 허위 지표, 고객, 로고, 인용, 인증 또는 경쟁사 사실 없음; 생성된 이미지는 일러스트레이션용으로 라벨링됨; 생성된 인물은 절대 고객으로 제시되지 않음.
- 브랜드를 사칭하지 마세요. 사용자가 대표할 자격이 없는 브랜드를 절대 사칭하지 않음; 가상 데모는 그렇게 명시해야 함.
- 브랜드. 항상 클라이언트 고유의 브랜드(글꼴, 색상, 로고) — 라이브 사이트에서 읽어오세요.
- 예산 (
npm run check): 페이지 JS ≤ 55 KB gz, 스테이지 ≤ 205 KB gz, 이미지 ≤ 500 KB, 캔버스 1개, DPR ≤ 1.75; WebGL 꺼짐, 동작 축소 켜짐, 390px에서 작동; 콘솔 오류 0개; 오버플로 0개. - 사용자의 명시적인 동의 없이 배포, 양식 엔드포인트, 분석 ID 또는 외부 계정을 설정하지 마세요.