웹사이트 피니싱 디렉터
구조화된 5단계 웹사이트 마감 감사 — 첫인상부터 출시 준비까지 — 100점 만점으로 평가. 마치 그림 그리기와 같습니다: 프라이머, 베이스 코트, 디테일, 클리어 코트, 최종 검사. 마감 점검 없이 사이트를 출시하지 마세요.
이 스킬을 사용해야 할 때
- 출시 전 게이트 — DNS가 실제로 전환되거나 트래픽이 유입되기 전 최종 검증
- 리디자인 후 감사 — 시각적 개편 후, 어떤 것도 퇴보하지 않았는지 확인
- 클라이언트 인계 — 사이트가 품질 기준을 충족함을 입증하는 구조화된 보고서 생성
- 분기별 유지보수 — 누적된 UX 부채, 끊어진 링크, 오래된 콘텐츠 발견
- 타겟 단계 — 특정 단계만 실행 (예: 성능 개선 후 "2단계만")
방법론 기반
출처:
- 닐슨 노먼 그룹(Nielsen Norman Group) — 휴리스틱 평가 프레임워크 (10가지 사용성 휴리스틱)
- 구글 웹 바이탈(Google Web Vitals) — LCP, CLS, INP 임계값
- OWASP — 보안 헤더 기준
- 올리 가드너(Oli Gardner) / 언바운스(Unbounce) — 랜딩 페이지 전환 모범 사례
- 돈 노먼(Don Norman) — 감성 디자인 (본능적/행동적/반성적 레이어)
- GUIA 프로덕션 메모리 — 8개의 출시된 웹사이트, Next.js, Framer Motion, GSAP, Lenis, Railway, Docker에서 문서화된 문제점
핵심 원칙: Lighthouse를 통과하고 올바른 메타 태그를 가진 웹사이트는 기술적으로 유효하지만 완성된 것은 아닙니다. 마감이란 '작동한다'와 '준비되었다' 사이의 간극입니다. 개별 지표의 체크리스트가 아닌, 방문자가 경험하는 대로 사이트를 평가해야 합니다 — 점진적이고, 감성적이며, 기기 간에 걸쳐서.
이것이 중요한 이유: 기존 도구(Lighthouse, Screaming Frog, Awwwards)는 각각 하나의 차원만 감사합니다. 시각적 완성도 + UX 완성도 + 기술적 기반 + 콘텐츠 품질 + 브랜드 정렬을 순차적이고 점수화된 워크플로우로 결합한 도구는 없습니다. 이 스킬이 바로 그 도구입니다.
Claude가 하는 일 vs 사용자가 결정하는 일
"Claude가 감사를 실행합니다. 사용자가 무엇을 출시할지 결정합니다."
| Claude가 처리 | 사용자가 제공 |
|---|---|
| 각 단계를 체크리스트에 따라 체계적으로 실행 | 라이브 URL 또는 코드베이스 접근 권한 |
| 각 체크포인트에 근거와 함께 점수 매기기 | 컨텍스트: 브랜드 포지셔닝, 타겟 오디언스, 출시 일정 |
| 문제를 P0/P1/P2로 분류 | 재정의 결정 (예: "MVP의 경우 P1 허용") |
| 수정 제안과 함께 최종 보고서 생성 | 최종 Go/No-Go 판단 |
| 프로덕션 메모리에서 GUIA 스택 문제점 플래그 지정 | 실제 기기에서 검증 (Claude는 Safari를 열 수 없음) |
기억하세요: 이것은 켄타우로스 워크플로우입니다. Claude가 감사를 엄격하게 구조화하고, 사용자는 실제 기기에서 인간의 눈으로 판결을 검증합니다.
이 스킬이 하는 일
- 5초 첫인상 테스트 — 첫 순간에 명확성, 감정적 적합성, CTA 가시성 평가
- 기술 기반 감사 — 성능 (핵심 웹 바이탈), SEO 기초, 보안 헤더, 끊어진 링크
- UX 완성도 점검 — 컴포넌트 상태, 폼 동작, 애니메이션 완성도, 모바일 사용성
- 콘텐츠 및 브랜드 검증 — 카피 품질, 플레이스홀더 감지, 음성 일관성, 시각적 일관성
- 교차 기기 및 출시 준비 — 브라우저 테스트, OG 미리보기, 애널리틱스, 404 페이지, 파비콘
사용 방법
출시 전 전체 웹사이트 감사
[사이트 URL]을 곧 출시하려고 합니다. 전체 웹사이트-피니싱-디렉터 감사(5단계 모두)를 실행해 주세요.
브랜드 사분면: [Warm+Calm / Warm+Active / Cold+Active / Cold+Calm].
타겟 오디언스: [누구].
특정 수정 후 단일 단계
[사이트 URL]의 성능을 방금 최적화했습니다. 2단계(기술 기반)만 실행해 주세요.
랜딩 페이지 빠른 감사
이 랜딩 페이지를 감사해 주세요: [URL]. 랜딩 페이지 프로필(1, 2, 4단계)을 사용하세요.
지침
이 감사를 실행할 때는 5단계를 순서대로 따르세요. 각 단계는 이전 단계를 기반으로 합니다 — 기반을 다진 후에 마무리 작업을 합니다. 각 체크포인트에 점수를 매기고, 우선순위별로 문제를 분류한 다음 최종 보고서를 생성합니다.
감사 프로필
모든 사이트가 5단계를 모두 필요로 하는 것은 아닙니다. 프로젝트에 맞는 프로필을 선택하세요:
| 프로필 | 단계 | 사용 시기 |
|---|---|---|
| 랜딩 페이지 | 1, 2, 4 | 단일 페이지 캠페인 또는 제품 페이지 |
| 전체 웹사이트 | 1, 2, 3, 4, 5 | 탐색, 양식, 콘텐츠가 있는 다중 페이지 사이트 |
| 이커머스 | 2, 3, 5 | 장바구니, 결제, 제품 페이지가 있는 스토어 |
축소된 프로필을 사용할 때는 점수 총계를 비례적으로 조정하세요. Go/No-Go 임계값은 원점수가 아닌 백분율 점수에 적용됩니다.
1단계: 첫인상 (15점)
"방문자는 5초 안에 무엇을 이해하고 느끼는가?"
홈페이지(또는 히어로 섹션)를 5초 동안 보여줍니다. 다음 5가지 질문에 답하세요 — 각 3점:
## 1단계 — 첫인상 (5초 테스트)
### 1. 이것은 무엇인가? (3점)
방문자가 사이트/제품/서비스가 무엇인지 식별할 수 있습니까?
[ ] 3 — 즉시 명확, 모호함 없음
[ ] 2 — 부제목을 읽은 후 명확
[ ] 1 — 모호, 이해를 위해 스크롤 필요
[ ] 0 — 이것이 무엇인지 전혀 모름
### 2. 누구를 위한 것인가? (3점)
타겟 오디언스를 식별하는 신호가 있습니까?
[ ] 3 — 명백한 인구통계/심리통계 신호
[ ] 2 — 암시되지만 명시적이지 않음
[ ] 1 — 일반적 ("모든 사람")
[ ] 0 — 적극적으로 혼란을 줌 (잘못된 오디언스 신호)
### 3. 왜 신경 써야 하는가? (3점)
가치 제안 또는 이점이 보입니까?
[ ] 3 — 명확한 이점, 감정적으로 공감됨
[ ] 2 — 기능 중심이지만 이해 가능
[ ] 1 — 존재하지만 묻혀 있음
[ ] 0 — 가치 제안이 보이지 않음
### 4. 다음에 무엇을 해야 하는가? (3점)
기본 CTA가 보이고 명확합니까?
[ ] 3 — CTA가 접힌 부분 위에 보이고, 행동별 텍스트
[ ] 2 — CTA가 존재하지만 일반적임 ("더 알아보기")
[ ] 1 — CTA가 접힌 부분 아래에 있거나 찾기 어려움
[ ] 0 — CTA가 보이지 않음
### 5. 어떤 느낌인가? (3점)
감정적 톤이 브랜드 사분면과 일치합니까?
[ ] 3 — 완벽한 사분면 일치 (따뜻한 브랜드 = 따뜻한 디자인)
[ ] 2 — 대체로 일치, 약간의 불협화음
[ ] 1 — 눈에 띄는 불일치 (따뜻한 브랜드 + 차가운 디자인)
[ ] 0 — 반대 사분면 (포지셔닝 혼란)
### 1단계 점수: ___/15
판결:
- 12-15: 통과 — 첫인상이 명확하고 감정적으로 정렬됨
- 8-11: 개선 필요 — 방문자가 이해하지만 느리거나 마찰이 있음
- <8: 실패 — 접힌 부분 위 경험 재설계
통합: 감정적 느낌을 web-design-director 사분면 시스템과 비교하세요. 브랜드가 Warm+Calm인데 사이트가 Cold+Active처럼 느껴지면 점수와 관계없이 P0입니다.
이 단계의 GUIA 문제점:
- Calendly URL이
/contact/페이지 대신 CTA에 하드코딩됨 (애널리틱스 중단) - 따뜻한 카피 톤과 차가운 UI 요소 혼합 (테라코타 팔레트 + 고정폭 글꼴 = 혼란)
2단계: 기술 기반 (25점)
"구축할 수 있을 정도로 인프라가 견고한가?"
## 2단계 — 기술 기반
### 성능 (10점)
| 지표 | 목표 | 점수 |
|------|------|------|
| LCP (최대 콘텐츠풀 페인트) | ≤ 2.5초 | 0-3점 |
| INP (다음 페인트와의 상호작용) | ≤ 200ms | 0-2점 |
| CLS (누적 레이아웃 시프트) | ≤ 0.1 | 0-2점 |
| Lighthouse 성능 점수 | ≥ 85 | 0-3점 |
점수 계산:
- LCP: 3 = ≤2.5초, 2 = ≤4.0초, 1 = ≤6.0초, 0 = >6.0초
- INP: 2 = ≤200ms, 1 = ≤500ms, 0 = >500ms
- CLS: 2 = ≤0.1, 1 = ≤0.25, 0 = >0.25
- Lighthouse: 3 = ≥90, 2 = ≥85, 1 = ≥70, 0 = <70
### SEO 기초 (8점)
- [ ] (2점) 표준 URL 정의 + 후행 슬래시 일관성
- [ ] (1점) 페이지별 고유 메타 제목 (≤60자)
- [ ] (1점) 페이지별 메타 설명 존재 (≤160자)
- [ ] (1점) Sitemap.xml 접근 가능 및 유효
- [ ] (1점) robots.txt 존재 및 올바름
- [ ] (1점) 구조화된 데이터 존재 (JSON-LD)
- [ ] (1점) 모든 이미지에 대체 텍스트
### 보안 및 링크 (7점)
- [ ] (2점) HTTPS 적용 (혼합 콘텐츠 없음)
- [ ] (2점) 보안 헤더 존재 (CSP, X-Frame-Options, HSTS, X-Content-Type-Options)
- [ ] (1점) 끊어진 내부 링크 없음 (404)
- [ ] (1점) 끊어진 외부 링크 없음
- [ ] (1점) 프로덕션에 노출된 소스 맵 또는 디버그 엔드포인트 없음
### 2단계 점수: ___/25
판결:
- 21-25: 견고함 — 출시 가능
- 16-20: 수용 가능 — P0 수정, P1 백로그와 함께 출시
- 11-15: 취약함 — 상당한 기술 부채
- <11: 고장남 — 출시하지 마세요
이 단계의 GUIA 문제점:
next.config.js에trailingSlash: true누락 (Rental-CRM에서 색인 해제 유발, 2026년 1월)'use client'컴포넌트의export const metadata(메타데이터가 서버 측에서 렌더링되지 않음)- 모듈 수준 SDK 초기화(Supabase/Stripe)가 env 변수 누락 시 빌드에서 실패 — 함수 내부에서 지연 초기화
- Vercel env 변수에
echo의 후행 개행 문자 — 대신printf사용 - Railway
*.railway.internal호스트 이름이 Nixpacks 빌드 중에 연결 불가 — 공개 URL 사용
3단계: UX 완성도 (25점)
"사이트가 햅피 패스뿐만 아니라 실제 사용을 처리하는가?"
## 3단계 — UX 완성도
### 컴포넌트 상태 (8점)
각 대화형 컴포넌트(버튼, 카드, 양식, 모달, 목록)에 대해:
- [ ] (2점) 로딩 상태 — 스켈레톤, 스피너 또는 프로그레시브 렌더링
- [ ] (2점) 오류 상태 — 명확한 메시지 + 복구 작업
- [ ] (2점) 빈 상태 — 도움이 되는 메시지, 빈 화면 아님
- [ ] (2점) 성공 상태 — 확인 피드백
점수: 모든 컴포넌트에서 누락된 상태당 차감.
8점 = 모든 상태가 적용됨. 누락된 상태당 -1 (최소 0).
### 양식 (6점)
- [ ] (1점) 명확한 오류 메시지가 있는 클라이언트 측 유효성 검사
- [ ] (1점) 서버 측 유효성 검사 (클라이언트만 아님)
- [ ] (1점) 제출 후 성공 피드백 (토스트, 리디렉션 또는 인라인)
- [ ] (1점) 처리 중 제출 버튼 비활성화 (이중 제출 방지)
- [ ] (1점) 스팸 방지 (허니팟, reCAPTCHA 또는 속도 제한)
- [ ] (1점) 양식 근처 개인정보 보호정책 링크 (GDPR)
### 애니메이션 완성도 (6점)
- [ ] (1점) 스크롤 애니메이션에 `viewport={{ once: true }}` (다시 스크롤해도 재생 안 됨)
- [ ] (1점) GSAP 애니메이션에 `useGSAP` 훅 사용 (`useEffect` 아님)
- [ ] (1점) `prefers-reduced-motion` 존중 (애니메이션 비활성화 또는 축소)
- [ ] (1점) 애니메이션이 콘텐츠 접근을 차단하지 않음 (애니메이션 실패 시에도 콘텐츠 보임)
- [ ] (1점) Lenis가 올바르게 초기화됨 (Locomotive Scroll 아님)
- [ ] (1점) 종료 애니메이션이 레이아웃 시프트를 유발하지 않음
### 모바일 사용성 (5점)
- [ ] (1점) 터치 대상 ≥ 44px (iOS HIG 표준)
- [ ] (1점) 수평 오버플로우 / 수평 스크롤 없음
- [ ] (1점) 본문 텍스트 글꼴 크기 ≥ 16px (iOS 확대 방지)
- [ ] (1점) 고정/스티키 요소가 콘텐츠와 겹치지 않음
- [ ] (1점) 스크롤 동작이 올바르게 작동함 (사용자를 가두는 스크롤-재킹 없음)
### 3단계 점수: ___/25
판결:
- 21-25: 완전함 — 실제 사용 범위 포함
- 16-20: 대부분 완료 — 엣지 케이스 주의 필요
- 11-15: 불완전함 — 사용자가 막다른 골목에 도달함
- <11: 미완료 — UX가 프로덕션 준비 안 됨
이 단계의 GUIA 문제점:
- GSAP + React 18 Strict Mode가 개발에서 애니메이션을 2번 실행 (
useEffect대신useGSAP사용) - 글로벌 CSS
a { color: var(--color-coral) }가 앵커 CTA에서 Tailwindtext-white를 재정의 — 인라인style={{ color: 'white' }}사용 - Framer Motion
AnimatePresence종료 애니메이션이 Next.js App Router에서 중단됨 - 너무 많은 동시
ScrollTrigger인스턴스가 모바일 성능을 저하시킴 - Lenis 패키지 이름:
npm install lenis(@studio-freight/lenis아님)
4단계: 콘텐츠 및 브랜드 (20점)
"콘텐츠가 완성되고, 일관되며, 브랜드에 적합한가?"
## 4단계 — 콘텐츠 및 브랜드
### 카피 품질 (8점)
- [ ] (2점) 플레이스홀더 텍스트 감지 안 됨 ("Lorem ipsum", "[Your Name]", "Coming soon",
"example.com", "TODO", 빈 섹션)
- [ ] (1점) 맞춤법 또는 문법 오류 없음
- [ ] (1점) 링크 텍스트가 설명적임 ("여기를 클릭" 또는 URL 노출 아님)
- [ ] (1점) CTA 카피가 구체적임 ("Submit"이 아닌 "무료 체험 시작")
- [ ] (1점) 제목 계층이 논리적임(H1 → H2 → H3, 페이지당 하나의 H1)
- [ ] (1점) 대체 텍스트가 설명적임 ("image1.png" 또는 빈 값 아님)
- [ ] (1점) 전화번호, 이메일, 주소가 실제임 (플레이스홀더 아님)
### 브랜드 음성 (6점)
- [ ] (2점) 톤이 브랜드 포지셔닝과 일치 (따뜻함/차가움, 공식적/캐주얼)
- [ ] (2점) 모든 페이지에서 음성이 일관됨 (같은 사람이 "말하는" 것처럼)
- [ ] (1점) AI-다듬기 마커 없음 ("주저하지 말고 연락주세요",
"오늘날의 빠르게 변화하는 세상에서", "주목할 점은")
- [ ] (1점) CTA가 감정적 사분면과 일치 (따뜻한 브랜드 = 초대하는 CTA, 공격적이지 않음)
### 시각적 일관성 (6점)
- [ ] (1점) 색상 팔레트가 일관되게 사용됨 (브랜드 외 색상 없음)
- [ ] (1점) 타이포그래피 계층이 명확함 (디스플레이, 제목, 본문, 캡션 — 최대 2-3개 글꼴)
- [ ] (1점) 간격 리듬이 일관됨 (섹션 간 무작위 패딩 아님)
- [ ] (1점) 아이콘 스타일이 통일됨 (아웃라인, 채움, 이모지 혼용 금지)
- [ ] (1점) 이미지 처리가 일관됨 (모든 사진 동일한 필터/톤, 또는 모든 일러스트레이션)
- [ ] (1점) 컴포넌트 스타일이 일관됨 (카드, 버튼, 입력이 동일한 패턴을 따름)
### 4단계 점수: ___/20
판결:
- 17-20: 세련됨 — 콘텐츠가 완성되고 브랜드에 적합
- 13-16: 좋음 — 사소한 불일치, 출시 가능
- 9-12: 거침 — 콘텐츠에 편집 단계 필요
- <9: 미완료 — 주요 콘텐츠 공백 또는 브랜드 불일치
이 단계의 GUIA 문제점:
- Calendly URL이 올바른 전문가(Valeria vs Matthieu vs 클라이언트)와 일치해야 함
- 따뜻한 카피("We understand your challenges")와 차가운 UI(다크 모드, 고정폭, 날카로운 모서리) 혼합
- AI 생성 카피 감지: 게시 전 이중 줄바꿈 제거 (LinkedIn의 AI 서명)
- credou.bzh 카피 방향: 메커니즘 우선, 이력서 없음, 경력/타임라인 없음
5단계: 교차 기기 및 출시 (15점)
"모든 곳에서 작동하고, 라이브로 전환할 모든 준비가 되었는가?"
## 5단계 — 교차 기기 및 출시
### 브라우저 테스트 (5점)
3대 주요 브라우저에서 테스트. 브라우저별 점수:
- [ ] (2점) Safari — 올바르게 렌더링, 애니메이션 작동, 글꼴 로드
- [ ] (2점) Chrome — 올바르게 렌더링, 애니메이션 작동, 글꼴 로드
- [ ] (1점) Firefox — 올바르게 렌더링, 주요 중단 없음
브라우저별 확인: 레이아웃, 애니메이션, 글꼴, 양식, 스크롤 동작.
시각적 버그가 있는 브라우저당 1점 차감. 기능적 버그가 있는 브라우저당 2점 차감.
### 기기 테스트 (4점)
- [ ] (2점) 모바일 (375px) — 전체 사이트 사용 가능, 터치 대상 충분, 내용이 뷰포트에 맞음
- [ ] (2점) 태블릿 (768px) — 레이아웃 중단 없음, 탐색 작동, 콘텐츠 가독성
### 출시 준비 (6점)
- [ ] (1점) OG 이미지가 소셜 미디어에서 올바르게 렌더링됨 (Open Graph 디버거 사용)
- [ ] (1점) Favicon이 모든 탭/브라우저에 존재
- [ ] (1점) 404 페이지가 유용함 (홈으로 연결, 검색 또는 도움말) — 일반 서버 오류 아님
- [ ] (1점) 애널리틱스가 추적 중이고 필터가 적용됨 (내부 트래픽 제외)
- [ ] (1점) 로봇 noindex 태그가 프로덕션에서 제거됨 (스테이징에서만 활성화)
- [ ] (1점) 맞춤 도메인이 환경 변수에 설정되고 하드코딩된 localhost URL이 없음
### 5단계 점수: ___/15
판결:
- 13-15: 출시 준비 완료 — 출시
- 10-12: 거의 준비 — P0 수정, 빠른 수정과 함께 출시
- 7-9: 준비 안 됨 — 5단계 항목을 먼저 해결
- <7: 차단됨 — 출시하지 마세요
이 단계의 GUIA 문제점:
- Safari가
scroll-behavior: smooth를 무시함 (CSS 대신 JS 스크롤 사용) - OG 이미지가
absolute경로를 사용하지 않으면 Next.js 메타데이터에서 중단됨 metadataBase가 Next.js 앱에서 설정되지 않아 OG 미리보기가 손상됨- iMessage/Facebook Messenger가 OG 이미지를 3일 동안 캐시함 (테스트 전 캐시 무효화)
- Vercel 분기 배포에
noindex가 자동으로 추가됨 — 프로덕션 도메인에서 확인
점수 요약
| 단계 | 최대 점수 | 받은 점수 | 백분율 |
|---|---|---|---|
| 1차: 첫인상 | 15 | ___ | ___% |
| 2차: 기술 기반 | 25 | ___ | ___% |
| 3차: UX 완성도 | 25 | ___ | ___% |
| 4차: 콘텐츠 및 브랜드 | 20 | ___ | ___% |
| 5차: 교차 기기 및 출시 | 15 | ___ | ___% |
| 총계 | 100 | ___ | ___% |
Go/No-Go 판결
- ≥ 85%: 출시 가능 — 발견된 P1/P2 문제를 백로그에 추가하고 출시
- 70-84%: 조건부 출시 — P0 문제를 수정하고, P1 문제가 문서화되고 수용 가능하면 출시
- < 70%: 출시 불가 — P0 및 P1 문제를 수정한 후 재감사
FAQ
Q: 이 스킬은 실제 사람을 대체합니까? A: 아닙니다. Claude가 감사를 체계적으로 구성하고 문제에 플래그를 지정하며 수정 사항을 제안합니다. 실제 기기에서의 최종 검증과 출시 결정은 사용자의 몫입니다.
Q: 어떻게 시작합니까? A: 감사할 URL을 제공하고, 브랜드 사분면(해당되는 경우)과 타겟 오디언스를 포함하세요. 기본값은 전체 5단계 감사이지만, 특정 단계만 요청할 수도 있습니다.
Q: 단일 페이지를 감사할 수 있습니까? A: 가능합니다. 랜딩 페이지 프로필(1, 2, 4단계)을 사용하면 됩니다. 전체 사이트 감사는 탐색, 양식 및 여러 페이지가 있는 경우에 적합합니다.
Q: 점수는 어떻게 계산됩니까? A: 각 단계는 정의된 체크포인트에 따라 채점됩니다. 단계 점수는 합산되어 100점 만점의 백분율로 변환되며, Go/No-Go 결정이 내려집니다.
Q: 특정 스택(GSAP, Next.js 등)에 대한 모범 사례를 포함합니까? A: 네, 각 단계에는 GUIA 프로덕션 메모리의 'GUIA 문제점'이 포함되어 있어 일반적인 함정을 방지하는 데 도움이 됩니다.