Communitygithub.com

MCERQUA/jam-skills

연구 중심의 워크플로우(발견 → 심층 조사(키워드, 경쟁사, 콘텐츠 전략, 토픽 맵) → 디자인 기획 → 스캐폴딩 → 빌드 → 배포)를 통해 프로덕션에 바로 사용할 수 있는 Next.js 15 웹사이트를 처음부터 구축합니다. 트리거: '웹사이트 제작', '내 비즈니스 사이트 만들기', '새로운 웹 프로젝트 시작'. 기존 사이트 편집(web-dev)이나 단일 아티클(article-writer)에는 트리거하지 마세요.

jam-skills란 무엇인가요?

이 스킬은 Next.js 15를 사용하여 프로덕션에 바로 사용할 수 있는 웹사이트를 처음부터 구축하는 포괄적인 13단계 워크플로우를 제공합니다. 연구 우선 접근 방식(발견, 심층 조사, 디자인 기획)으로 코드 작성 전에 데이터에 기반한 결정을 내리도록 보장합니다. 로컬 서비스 사이트의 전환율 최적화(CRO)를 위한 상세한 규칙을 포함하며, 실전에서 입증된 전략(예: 전화번호 가시성, 양식 필드 최소화, 모바일 속도 최적화)을 제공합니다. 또한 모든 Next.js 프로젝트에서 `pnpm.onlyBuiltDependencies` 선언을 필수로 요구하는 등 컨테이너 환경의 핵심 요구 사항을 강조합니다.

지원 대상✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/MCERQUA/jam-skills/tree/HEAD/website-builder

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

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

문서

⚠️ 먼저 읽으세요: 이 스킬 디렉토리의 PNPM_11_REQUIREMENTS.md. Mike가 사이트를 미리보는 Webdev 컨테이너는 2026-05-13부터 pnpm 11.1.1을 실행합니다. 모든 새 프로젝트는 package.json에 pnpm.onlyBuiltDependencies(최소: ["sharp"])를 선언해야 합니다. 그렇지 않으면 개발 서버가 시작되지 않습니다. 이를 무시하면 컨테이너가 재시작 루프에 빠지고 사이트가 502 오류를 반환하며 사용자가 당신을 탓하게 됩니다. 60초만 투자해 읽으세요; 무시하면 위험합니다.

웹사이트 빌더 — 완벽한 Next.js 웹사이트 스킬

연구 기반의, 디자인을 의도한 웹사이트 구축. 모든 결정은 데이터로 뒷받침되고, 모든 섹션은 연구로 정당화됩니다.

이 스킬을 사용해야 할 때

다음 요청이 들어오면 트리거하세요:

  • 새 웹사이트 구축
  • 비즈니스 웹사이트 제작
  • 새로운 웹 프로젝트 시작
  • "사이트 만들어 줘"

다음 경우에는 사용하지 마세요:

  • Canvas 페이지 (대신 canvas-web-design 스킬 사용)
  • 기존 웹사이트 프로젝트 편집 (해당 프로젝트의 .claude/CLAUDE.md 따르기)
  • Remotion 비디오 프로젝트 (대신 remotion-video 스킬 사용)

절대 타협할 수 없는 규칙

  1. 연구 및 디자인 기획을 완료하기 전에는 절대 코드를 작성하지 마세요. 1-4단계에서는 코드를 한 줄도 생성하지 않습니다. 이것이 올바른 방식입니다.
  2. 템플릿 기본값이 포함된 페이지를 절대 제공하지 마세요. "로고", "(555) 000-0000", "[email protected]", "서비스 1"이 보이면 — 당신은 실패한 것입니다.
  3. 키워드 조사 없이 절대 카피를 작성하지 마세요. 모든 헤드라인은 3단계의 특정 키워드를 타겟팅해야 합니다.
  4. 디자인 계획을 절대 건너뛰지 마세요. 모든 섹션, 색상, 애니메이션에는 문서화된 이유가 있어야 합니다.
  5. 협박 전술이나 공포 기반의 헤드라인을 절대 사용하지 마세요. 혜택 중심의 SEO 타겟팅 카피를 작성하세요.
  6. 사이트를 제시하기 전에 항상 플레이스홀더 검사를 실행하세요. 무관용 원칙입니다.
  7. 항상 모든 섹션을 사용자 정의하세요. 섹션이 내장 기본값을 렌더링한다면 props 전달을 잊은 것입니다.
  8. 절대 뒤로 가기 버튼 하이재킹을 배포하지 마세요. history.pushState 루프, 리디렉션 트랩, 또는 브라우저 뒤로 가기 버튼이 사용자를 SERP로 돌려보내는 것을 막는 모달/오버레이 체인은 Google 스팸 정책 위반(악성 행위, 2026-06-15 시행)이며 수동 조치 및 순위 하락 위험이 있습니다. 종료 의도 스크립트, 인터스티셜, 포함된 모든 광고/라이브러리 코드를 감사하세요(위반은 종종 퍼스트파티가 아닌 여기서 발생합니다). 12단계에서 확인하세요. (developers.google.com/search/blog/2026/04/back-button-hijacking)

사이트 유형

인테이크 중에 식별하세요 — 모든 것이 달라집니다:

유형목표주요 섹션카피 스타일
SEO 리드젠순위 + 리드 확보히어로 + TrustBar + CoverageGrid + HowItWorks + FAQ + 사용후기 + CTA키워드 풍부, 혜택 중심, 전문적
로컬 서비스전화 + 양식히어로 + TrustBar + 서비스 + 서비스 지역 + 리뷰 + CTA직접적, 신뢰 구축, 위치 타겟팅
포트폴리오작품 전시히어로 + 프로젝트 그리드 + 소개 + 프로세스 + 연락처시각적, 최소 카피, 작품이 말하게 함
SaaS / 제품가입 / 체험판히어로 + 기능 + 가격 + 사용후기 + FAQ + CTA혜택 중심, 비교 기반

로컬 서비스 사이트: 홈 서비스 또는 계약자 사이트를 구축하기 전에 아래의 로컬 서비스 CRO 규칙 섹션을 먼저 읽으세요. 대부분의 로컬 사이트는 전환율이 1% 미만입니다. 이 규칙을 따르면 3–5%를 달성할 수 있습니다.


로컬 서비스 CRO 규칙

출처: Noah Igler (@noahiglerSEO)의 홈 서비스 사이트(배관공, HVAC, 지붕 수리공, 전기공, 조경사 등) 전환 감사. 대부분의 사이트는 트래픽은 충분하지만 전화가 울리지 않습니다 — 사이트가 트래픽이 아닌 리드를 누설하기 때문입니다.

대부분의 홈 서비스 사이트는 전환율이 1% 미만입니다. 이 규칙은 동일한 트래픽으로 3–5%를 목표로 합니다.

접는 부분 위 (Above the Fold, 전환의 80%가 여기서 결정되거나 실패)

방문자는 랜딩 후 3초 이내에 다음을 알아야 합니다: 당신이 무엇을 하는지, 어디서 하는지, 신뢰할 수 있는지, 그리고 전화하는 방법. 아래의 모든 요소는 필수이며 선택 사항이 아닙니다.

  • 헤드라인 형식: "[서비스명] [도시명]" 또는 "[도시명]의 신뢰할 수 있는 [서비스명] 업체" — "2003년부터 신뢰할 수 있는 홈 서비스 파트너"가 아닙니다.
  • 전화번호: 오른쪽 상단, 큰 글꼴, 사용자가 스크롤할 때 고정 — tel: 링크로 직접 연결 (모달, 팝업, 확인 단계 없음 — 한 클라이언트는 모달 때문에 전화가 30% 감소했습니다)
  • 신뢰 바 / 부제목: 별점 + 리뷰 수 + 업력 + 면허 번호 + 서비스 지역 — 모두 히어로에 표시
  • 기본 CTA: "지금 전화" 또는 "무료 견적 받기" — 버튼 위나 바로 아래에 전화번호를 표시하세요
  • 히어로 이미지: 브랜드 셔츠를 입은 팀, 작업 현장의 트럭, 실제 작업 사진 — 웃는 가족의 스톡 사진은 사용하지 마세요 (방문자가 즉시 알아차리고 신뢰가 부정적으로 변합니다)

전화 가시성 — 가장 강력한 레버

  • 고정 헤더: 모바일에서 사용자가 스크롤할 때 전화번호가 항상 보여야 함
  • 모바일 고정 푸터 바: 두 개의 버튼 — "지금 전화" (tel: 링크)와 "온라인 예약" — 항상 표시
  • 긴 페이지에는 플로팅 액션 버튼
  • 실전에서 통화량을 15–25% 증가시킵니다

양식 — 추가 필드마다 전환율이 약 10% 감소

홈 서비스 리드 양식의 최대 필드 수는 4개:

  1. 이름
  2. 전화번호
  3. 필요한 서비스 (드롭다운 — 자유 텍스트 아님)
  4. 주소

절대 추가하지 마세요: 이메일, "최적 통화 시간", "알게 된 경로", 댓글 상자, 주소 증명, 또는 기타 자격 질문. 신용 신청을 하는 것이 아닙니다 — 다시 전화할 수 있도록 전화번호를 받는 것입니다. 자격 확인은 전화 통화 중에 이루어집니다.

모바일 속도 — 타협 불가

  • 모바일 PageSpeed 50 미만 = Map Pack 순위 2-3개 하락
  • 모바일 PageSpeed 70 미만 = 페이지 로드 전에 모바일 방문자의 20-30% 손실
  • 목표: 모바일 PageSpeed 70+, 페이지 로드 < 2초

속도 개선 방법 (영향 순):

  1. 히어로 이미지를 200–400KB로 압축 (대부분의 사이트는 2–3MB 히어로 이미지를 제공합니다)
  2. 불필요한 플러그인 및 추적 스크립트 제거
  3. 실제 CDN 사용 (호스트의 번들 옵션만 사용하지 마세요)
  4. 접는 부분 아래의 모든 것을 레이지 로드
  5. 타사 위젯(라이브 채팅, 소셜 임베드, 리뷰 애그리게이터) 최소화 — 늦게 로드되고 전화번호를 가립니다

리뷰 / 사회적 증명 — 모든 스크롤 깊이에 표시되어야 함

모든 증거를 페이지 중간의 하나의 사용후기 섹션에 넣지 마세요. 방문자는 모든 레벨에서 이를 볼 수 있어야 합니다:

  • 접는 부분 위: "Google 리뷰 312개의 별점 4.9" — 히어로 신뢰 바에 개수와 평점 표시
  • 히어로 섹션: 실제 리뷰에서 인용한 2-3개의 짧은 인용문, 가급적 GBP에서 동적으로 가져오기
  • 서비스 페이지: 해당 서비스를 언급하는 리뷰를 인용하는 전용 리뷰 섹션
  • 양식 옆: 요청 직전에 증거를 반복

목표: 방문자가 양식에 도달할 때쯤이면 증거를 5–6번 보게 하는 것입니다.

사진 — 스톡 사진보다 실제 이미지가 항상 우선

  • 작업 현장에서 브랜드 셔츠를 입은 팀의 실제 사진
  • 실제 고객 주택에 주차된 트럭
  • 전후 사진 (배관 청소, 패널 작업, 에어컨 설치, 덕트 공사, 지붕 교체)
  • 면허증, 제조업체 인증, 보험 증서를 촬영하여 표시
  • 사이트는 마케팅 대행사가 로고를 박아 넣은 템플릿이 아닌, 실제 사람이 있는 실제 비즈니스처럼 보여야 합니다

금융 — 고액 서비스($5K+)에 필수

교체 수준의 작업을 원하는 고객의 약 60%는 할부 금융을 원합니다. 경쟁업체가 Synchrony / GreenSky / Wisetack 로고를 표시하는데 당신이 표시하지 않으면, 당신이 견적을 제시하기도 전에 거래를 성사시킵니다.

  • 서비스 페이지의 접는 부분 위에 금융 파트너 로고 표시
  • 히어로에 "0% 할부 가능" 또는 "월 89,000원부터" 안내
  • 메인 내비게이션에서 연결된 별도의 금융 페이지
  • 고액 서비스 페이지에 사전 자격 위젯 내장

전환을 망치는 일반적인 실수

이러한 실수는 감사에서 지속적으로 나타납니다 — 배포하지 마세요:

  • 리드를 "자격 확인"하기 위해 더 긴 양식 사용 — 자격을 확인하는 것이 아니라 잃는 것입니다
  • 양식 작성을 유도하기 위해 전화번호 숨기기 — 방문자는 그냥 떠납니다
  • 히어로 섹션에서 자동 재생 비디오 — 모바일 속도를 죽이고 방문자를 짜증나게 합니다
  • 첫 방문 시 팝업 — 모바일에서 즉시 뒤로 가기 버튼 트리거
  • 라이브 채팅 위젯 — 로드하는 데 4초 걸리고, 전화번호를 가리며, 홈 서비스에 가치를 더하지 않습니다

기술 스택 (모든 프로젝트)

도구패키지목적
Next.js 15next앱 라우터, 서버 컴포넌트, 서버 액션
React 19reactUI 프레임워크
TypeScripttypescript타입 안전성
Tailwind CSS v3tailwindcss유틸리티 우선 스타일링 (v3 — v4 사용 금지, v4는 PostCSS 문제 있음)
shadcn/uishadcn (CLI)컴포넌트 라이브러리 (Radix + Tailwind)
Motionmotion애니메이션 (스프링 물리, 스크롤, 레이아웃)
Lenislenis부드러운 스크롤 (< 4kb, 접근성)
Lucide Reactlucide-reactSVG 아이콘

선택 사항 (필요할 때 설치)

도구패키지설치 시기
Pretext@chenglou/pretextDOM 리플로우 없는 텍스트 측정 — 가상 리스트, 채팅 UI, 메이슨리 그리드, 자동 크기 조정 텍스트 컨테이너, 캔버스 텍스트 렌더링. getBoundingClientRect보다 ~500배 빠름. 의존성 없음. /mnt/shared-skills/pretext/SKILL.md 참조
GSAPgsap복잡한 스크롤 시퀀스, SplitText, MorphSVG
Three.jsthree + @react-three/fiber3D 배경 또는 히어로 요소
MDX@next/mdx풍부한 콘텐츠의 블로그
Prismaprisma데이터베이스 접근

13단계 워크플로우

단계를 순서대로 따르세요. 단계를 건너뛰지 마세요. 1-4단계에서는 코드를 한 줄도 생성하지 않습니다. 연구와 계획을 생성합니다. 이것이 핵심입니다.

1단계: 발견

읽기: instructions/brand-intake.md

다른 모든 것보다 먼저 클라이언트에게 브랜드 인테이크 질문을 하세요:

  • 비즈니스 아이덴티티, 산업, 타겟 고객
  • 브랜드 색상, 톤, 개성
  • SEO 목표, 경쟁사, 고객 검색어
  • 필요한 페이지, 특별 기능, 기본 CTA
  • 사이트 유형 (SEO 리드젠, 로컬 서비스, 포트폴리오, SaaS)

산출물: 완료된 인테이크 답변

2단계: 설정

읽기: instructions/folder-setup.md

프로젝트 디렉토리 내에 ai/ 폴더 구조를 생성하세요:

  1. 모든 연구 디렉토리 생성 (01-07)
  2. 디자인, 콘텐츠, 블로그 연구 디렉토리 생성
  3. research-status.json 초기화
  4. 인테이크 답변으로 01-business-profile/profile.md 채우기

산출물: 비즈니스 프로필이 채워진 완전한 ai/ 폴더 구조

3단계: 연구 (기초 — 서두르지 마세요)

읽기: instructions/research-plan.md

이후 모든 것을 결정짓는 6가지 연구 작업:

  1. 키워드 연구 — 기본, 보조, 롱테일, 지역 카테고리에서 50-100개 이상의 키워드를 찾으세요. ai/research/02-keyword-research/에 문서화하세요. Google을 검색하고, PAA 질문을 캡처하고, 키워드 클러스터를 구축하세요.

  2. 경쟁사 심층 분석 — 5-10개의 경쟁사 사이트를 자세히 검토하세요. 각 사이트에 대해: 홈페이지 섹션, 히어로 레이아웃, CTA, 시각 디자인, 타이포그래피, 애니메이션, 콘텐츠 품질, 강점, 약점을 문서화하세요. ai/research/03-competitor-analysis/site-reviews/에 경쟁사별 검토 파일을 생성하세요. 그런 다음 pattern-analysis.md (업계 내 공통 패턴)와 gaps-opportunities.md (활용할 기회)로 종합하세요.

  3. 콘텐츠 전략 — 모든 페이지를 매핑하세요: URL, 키워드, 섹션, H1, 메타 태그. ai/research/04-content-strategy/content-briefs/에 페이지별 콘텐츠 브리프를 생성하세요. PAA, Reddit, 포럼에서 FAQ 질문을 조사하세요.

  4. 토픽 맵 — 토픽 클러스터 아키텍처 구축: 필러 페이지, 클러스터 콘텐츠, 내부 링킹 전략. ai/research/05-topical-map/에 문서화하세요.

  5. 로컬 SEO (해당되는 경우) — 타겟 서비스 지역, 로컬 경쟁사, 도시별 키워드. ai/research/06-local-seo/에 문서화하세요.

  6. 전환 패턴 — 경쟁사 CTA, 신뢰 신호, 사회적 증명 패턴을 분석하세요. 전환 퍼널을 매핑하세요. ai/research/07-conversion-patterns/에 문서화하세요.

산출물: 7개 디렉토리에 20-40개의 연구 파일. research-status.json 업데이트.

4단계: 디자인 계획 (사고 단계 — 모든 결정이 의도적)

읽기: instructions/design-plan.md

사이트가 "또 다른 템플릿"에서 실제로 작동하는 사이트로 전환되는 단계입니다. 6가지 디자인 문서:

  1. 경쟁사 시각 감사 (ai/design/competitor-visual-audit.md) — 모든 경쟁사 사이트의 시각적 패턴 검토: 히어로 유형, 섹션 순서, 색 구성표, 타이포그래피, 애니메이션, 사진 스타일. 시각적 품질에 따라 순위를 매기세요. 극복해야 할 점을 식별하세요.

  2. 스타일 방향 (ai/design/style-direction.md) — 이유를 포함한 미학 선택. 색상, 글꼴, 다크/라이트 모드, 간격 — 모든 선택은 브랜드 인테이크 + 경쟁사 분석 + 업계 맥락으로 추적 가능해야 합니다.

  3. 컴포넌트 계획 (ai/design/component-plan.md) — 필요한 모든 컴포넌트를 순서대로, 그 목적과 함께. 이 히어로 레이아웃을 사용하는 이유? 이 신뢰 바 스타일을 사용하는 이유? 이 순서로 이 섹션을 배열하는 이유? 전환 퍼널에 매핑하세요.

  4. 애니메이션 계획 (ai/design/animation-plan.md) — 무엇이 움직이고, 왜, 어떻게 움직이는지. 진입 애니메이션, 호버 상태, 스크롤 효과. 의도적인 모션, 무작위 장식 금지.

  5. 페이지 와이어프레임 (ai/design/page-wireframes.md) — 모든 페이지의 섹션별 레이아웃. 구조를 보여주는 ASCII 와이어프레임.

  6. 디자인 브리프 (ai/design/design-brief.md) — 마스터 문서. 모든 디자인 결정을 요약하고, 이 사이트를 경쟁사와 차별화하는 요소를 나열하며, 모든 선택을 연구와 연결합니다.

산출물: 6개의 디자인 문서. 디자인 브리프는 전체 빌드의 참고 자료입니다.

5단계: 스캐폴드

읽기: instructions/architecture.md 사용: templates/project/ 디렉토리

  1. templates/project/를 Websites/<프로젝트명>/으로 복사
  2. pnpm install 실행
  3. shadcn 초기화: pnpm dlx shadcn@latest init
  4. 핵심 shadcn 컴포넌트 설치: pnpm dlx shadcn@latest add button card badge separator input textarea label
  5. 애니메이션 종속성 설치: pnpm add motion lenis
  6. git 초기화, 스캐폴드 커밋
  7. 프라이빗 GitHub 저장소 생성, 푸시, web-dev 브랜치 생성
  8. templates/config/claude-project.md를 사용하여 .claude/CLAUDE.md 채우기

6단계: 디자인 시스템

읽기: instructions/design-system.md 사용: templates/config/design-system.json

# 디자인 시스템을 init 디렉토리로 복사
cp templates/config/design-system.json Websites/<프로젝트명>/ai/design/
# [참고: JSON 파일은 수동으로 프로젝트의 Tailwind 구성 및 CSS 변수에 통합하여 디자인 시스템을 조정합니다]
  1. design-system.json의 콘텐츠를 tailwind.config.ts에 통합 (색상, 글꼴, 간격, 테두리 반경)
  2. app/globals.css에서 CSS 변수 설정
  3. components/ui/에 기본 shadcn 컴포넌트가 올바르게 설정되었는지 확인
  4. 타이포그래피 유틸리티 클래스 확인
  5. 복사본 커밋: "feat: initialize design system"

7단계: 히어로

읽기: instructions/hero-section.md 참조: ai/design/page-wireframes.md, ai/design/design-brief.md

히어로 섹션은 방문자가 보는 첫 번째 인상입니다. 반드시 다음을 처리해야 합니다:

  • 가치 제안 — 즉시 명확히 전달
  • 명확한 CTA — "지금 전화" 또는 "무료 견적"
  • 신뢰 신호 — 평점, 리뷰 수, 업력
  • 시각적 요소 — 히어로 이미지 또는 일러스트레이션

모든 방문자에게 3초 이내에 답해야 할 질문:

  1. 이 회사는 무엇을 하나요?
  2. 그들은 어디에서 서비스하나요?
  3. 그들을 신뢰할 수 있나요?
  4. 어떻게 연락하나요?

산출물: 완전히 반응형이며 접근성을 갖춘 히어로 섹션. 모든 텍스트는 실제이며(플레이스홀더 없음), 연구를 바탕으로 합니다.

8단계: 메인 콘텐츠 섹션

읽기: instructions/main-content.md 참조: ai/design/page-wireframes.md, ai/research/04-content-strategy/

콘텐츠 전략 문서에 정의된 대로 주요 콘텐츠 섹션을 구축하세요:

  • 서비스 섹션 (로컬 서비스 사이트의 경우 CoverageGrid)
  • 작동 방식
  • 기능
  • 사용후기 / 사회적 증명
  • FAQ (PAA 연구의 일반적인 질문 대상)
  • 신뢰 바, 배지, 인증

각 섹션의 규칙:

  • 각 섹션의 존재 이유를 디자인 브리프에 추적 가능하게 함
  • 모든 텍스트는 실제, 고유해야 하며 연구된 키워드를 포함해야 함
  • 각 섹션은 시각적으로 명확한 목적을 가져야 함 — 레이아웃을 채우는 것이 아님

산출물: 디자인 브리프에 정의된 모든 섹션을 갖춘 완전한 페이지

9단계: CTA 및 전환 요소

읽기: instructions/cta-conversion.md 참조: ai/research/07-conversion-patterns/, ai/design/design-brief.md

양식, 버튼, 전화 링크, 리드 자석 — 방문자를 고객으로 전환하는 모든 것:

  • 기본 CTA 버튼 (전화번호 또는 양식)
  • 전환 양식 (가능한 적은 필드, 홈 서비스 최대 4개)
  • 리드 자석 또는 평가판 제공 (SaaS의 경우)
  • 종료 의도 트리거 (접근성 및 사용자 제어 보장)
  • 전환 요소 근처의 사회적 증명

산출물: 완전히 기능적이며 최적화된 전환 경로

10단계: 푸터 및 글로벌 요소

읽기: instructions/footer-global.md 참조: ai/design/design-brief.md

글로벌 내비게이션, 푸터, 쿠키 동의, 접근성 기능:

  • 반응형 내비게이션 (모바일 햄버거 메뉴)
  • 연락처 정보, 소셜 링크, 법적 링크가 포함된 완전한 푸터
  • 로컬 서비스 사이트를 위한 모바일 고정 푸터 바
  • 쿠키 동의 배너 (필요한 경우)
  • 스크린 리더를 위한 접근성 기능

산출물: 완전한 글로벌 페이지 구조

11단계: 반응형 및 QA

읽기: instructions/responsive-qa.md 참조: ai/design/design-brief.md

모든 중단점에서 사이트가 완벽하게 작동하는지 확인하세요:

  • 모바일 (375px, 414px)
  • 태블릿 (768px, 1024px)
  • 데스크톱 (1280px, 1440px, 1920px)

QA 체크리스트:

  • 모든 링크 작동
  • 모든 양식 유효성 검사
  • 이미지가 올바르게 로드되고 최적화됨
  • 페이지 속도 목표 충족 (모바일 PageSpeed 70+, 데스크톱 90+)
  • 접근성 검사에서 심각한 문제 없음
  • 콘솔 오류 없음
  • 플레이스홀더 없음 (텍스트, 이미지, 로고, 전화번호, 이메일)

산출물: 수정 사항이 적용된 QA 보고서

12단계: 최종 점검

읽기: instructions/final-audit.md 참조: 모든 연구 및 디자인 파일

배포하기 전 최종 감사:

  1. 콘텐츠 감사 — 모든 카피가 고유하고, 연구를 바탕으로 하며, 플레이스홀더가 없는지 확인
  2. SEO 감사 — 메타 태그, 헤딩 구조, 키워드 사용, 이미지 alt 속성 확인
  3. 성능 감사 — Lighthouse, PageSpeed Insights 실행
  4. 접근성 감사 — WAVE 도구 또는 Axe 실행
  5. 보안 감사 — 종속성 확인, 환경 변수 노출 없음 확인
  6. 뒤로 가기 버튼 감사 — "history.back()" 또는 "window.location"을 조작하는 모든 스크립트 수동 확인 (하이재킹 확인). 리디렉션 체인, 모달/오버레이 함정, 종료 의도 팝업에 특히 주의하세요. 정책을 위반하면 Google이 수동 조치를 취합니다.

산출물: 모든 항목이 통과된 완료된 감사 체크리스트

13단계: 배포

읽기: instructions/deployment.md

# 메인에 병합
git checkout main
git merge web-dev

# 푸시
git push origin main
  1. 정적 내보내기를 위해 프로젝트 구성 (Vercel, Netlify 또는 기타 호스트)
  2. 환경 변수 설정
  3. web-dev에서 main으로 병합
  4. 배포 플랫폼에 푸시
  5. 도메인 연결 (있는 경우)
  6. 애널리틱스 설정
  7. Google Search Console에 사이트맵 제출
  8. 사이트맵 및 robots.txt 확인

산출물: 프로덕션 환경의 라이브 웹사이트


빠른 시작 치트 시트

# 새 Next.js 프로젝트 스캐폴드
git clone <이 저장소> templates/project
cd Websites/새-프로젝트
pnpm install
pnpm dlx shadcn@latest init
pnpm dlx shadcn@latest add button card badge separator input textarea label
pnpm add motion lenis

기여

이 스킬을 개선하기 위한 PR을 환영합니다. 특히 다음 분야에서:

  • 더 나은 CRO 패턴
  • 추가 사이트 유형
  • 더 빠른 스캐폴딩 템플릿

라이선스

MIT

관련 스킬