Communitygithub.com

랜딩 greenfield — Lighthouse + SEO 스캐폴드

프로덕션 랜딩/마케팅 사이트를 처음부터: Next.js App Router, content.ts 단일 카피 소스, Impeccable 디자인 위임, Gemini 이미지, Metadata/OG/JSON-LD/sitemap/robots, favicon, Lighthouse급 검증으로 빈 슬롯 없이 출고.

랜딩 greenfield — Lighthouse + SEO 스캐폴드란 무엇인가요?

Landing Pages 1단계(scaffold): My-Claude-Workflows landing-page. 기술 레이어(perf/SEO/아이콘/이미지) 담당, 디자인은 Impeccable.

지원 대상✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/2003gdb/My-Claude-Workflows/tree/HEAD/skills/landing-page

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

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

문서

처음부터 프로덕션 랜딩 페이지를 구축합니다. 이 스킬은 기술 계층(성능, SEO, 아이콘, 이미지, 검증)을 담당합니다. Impeccable이 디자인을 담당합니다. 시각적 요소를 직접 만들지 말고 Impeccable에 넘기세요.

첫째: 누락된 것만 질문하세요

추측하지 마세요. 요청에서 다음 사항이 명확하지 않으면 질문하세요(사용자 언어로 2~4개씩 묶어서 질문):

  • 브랜드: 이름, 하는 일, 한 줄 가치 제안, 로고 파일(또는 생성해야 하나요?).
  • 대상 + 목표: 방문하는 사람, 단일 기본 전환(WhatsApp / 폼 / 전화 / 가입 / 구매).
  • 섹션 / 콘텐츠: 어떤 블록이 있고 실제 카피(서비스, 소개, 프로세스, 연락처…)는 무엇인지. 사실, 가격, 통계, 사용 후기를 절대 만들어내지 말고 알 수 없는 것은 // PLACEHOLDER — editar로 표시하세요.
  • 디자인: 참고할 영감/이미지, 팔레트 또는 브랜드 색상, 언어/로케일, 대상 도메인(SEO SITE_URL용).
  • 이미지: Gemini 키가 .env 파일에 GEMINI-IMAGES-API로 설정되어 있는지 확인하세요(이미지 단계 참조).

워크플로우

  1. 스캐폴드 — Next.js App Router + TS + Tailwind. 먼저 프로젝트 자체 프레임워크 문서(예: node_modules/next/dist/docs/)를 읽으세요. API가 학습 데이터와 다를 수 있습니다. 파일을 350줄 미만으로 유지하세요. 콘텐츠의 단일 진실 공급원: 모든 편집 가능한 값(모든 헤드라인, 문단, 목록 항목, 브랜드 이름, 링크, 전화번호/WhatsApp, 가격, SEO 문자열)은 단일 타입 파일(lib/content.ts 또는 site.config.ts)에 있습니다. 컴포넌트는 이 파일에서 가져오며 하드코딩된 카피가 없어야 합니다. 환경별 값(SITE_URL, 연락처 번호)은 .env에서 가져와서 해당 파일을 통해 다시 내보냅니다. 목표: 비개발자가 하나의 파일을 편집하여 모든 콘텐츠를 변경할 수 있도록 합니다.

  2. 디자인 → Impeccable. 시각적 품질을 위해 필수입니다. 그린필드 프로젝트의 경우 /impeccable init을 실행하고(PRODUCT.md/DESIGN.md 설정, 브랜드 레지스터 + 팔레트 선택), 각 블록에 대해 /impeccable craft <section>을 실행합니다. Impeccable의 안티-슬롭 규칙(모든 섹션에 눈썹 없음, 01/02/03 스캐폴드 없음, 동일한 카드 그리드 없음, 대비 ≥4.5:1, 의도적인 모션)이 기준입니다. 목표: 깔끔하고, 미니멀하며, 시각적으로 눈에 띄는 디자인 — AI 슬롭이 아닌.

  3. 이미지 — 모든 시각적 슬롯을 채웁니다. public/images/manifest.json을 작성하고, scripts/generate-images.mjs를 실행하고, 후처리하고, 검증합니다. 하나의 공유된 style = 일관된 세트. 절대 .env를 읽거나 출력하지 마세요 — node --env-file=.env만 사용하세요. → references/images.md

  4. 성능 — next/image(AVIF, sizes, LCP에만 priority), next/font, 소스 축소, opacity:0 공개 뒤에 실제 콘텐츠를 숨기지 않음(프리렌더에서 빈 페이지로 제공됨), reduced-motion 폴백. → references/performance.md

  5. SEO + 파비콘 — Metadata API(canonical, OG 1200×630, twitter), viewport, robots.ts, sitemap.ts, JSON-LD, <html lang>, 그리고 scripts/make-icons.mjs를 통해 로고에서 생성된 아이콘/OG. → references/seo.md

  6. 검증 — npm run build가 깔끔하게 완료되고, 실제로 렌더링되는 헤드리스 스크린샷(큰 --virtual-time-budget, 작은 PNG = 빈 페이지 = 공개 트랩) + 가능하면 Lighthouse 95+. 이미지를 연결하기 전에 생성된 이미지를 읽으세요.

스크립트

  • scripts/generate-images.mjs — 매니페스트에서 Gemini 이미지 생성. node --env-file=.env <script> public/images/manifest.json [names…] [--dry]. GEMINI-IMAGES-API를 읽지만 절대 로그에 기록하지 않습니다.
  • scripts/make-icons.mjs — 로고에서 favicon.ico + icon.png + apple-icon.png + og.jpg 생성(sharp 필요). node <script> --logo public/logo.png [--mark …] [--out-app src/app] [--bg "#fafaf8"] [--title "…"] [--crop "L,T,W,H"].

엄격한 규칙

  • 절대 .env 또는 API 키를 읽거나 출력하지 마세요.
  • 모든 편집 가능한 콘텐츠는 하나의 파일에 있어야 하며, 컴포넌트에 하드코딩된 카피가 없어야 합니다.
  • 디자인 품질은 Impeccable을 통해야 합니다. 기본값처럼 보이는 출력을 제공하지 마세요.
  • 사실/통계/사용 후기를 만들어내지 마세요 — 명확하게 표시된 플레이스홀더를 사용하세요.
  • JS 트리거 공개 뒤에 실제 콘텐츠를 숨기지 마세요(빈 페이지 트랩).

관련 스킬