Website Finishing Director
구조화된 5단계 웹사이트 마감 감사 — 첫인상부터 출시 준비까지 — 100점 만점 평가. 페인팅과 같습니다: 프라이머, 베이스 코트, 디테일, 클리어 코트, 최종 점검. 마감 작업 없이 사이트를 출시하지 않습니다.
이 스킬을 사용하는 경우
- 출시 전 게이트 — DNS가 활성화되거나 트래픽이 전송되기 전 최종 검증
- 재디자인 후 감사 — 시각적 개편 후, 회귀(regression)가 없는지 확인
- 고객 인계 — 사이트가 품질 기준을 충족함을 증명하는 구조화된 보고서 생성
- 분기별 유지보수 — 누적된 UX 부채, 깨진 링크, 오래된 콘텐츠 발견
- 특정 단계 실행 — 단일 단계만 실행 (예: 성능 개선 후 "Pass 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 가시성 평가
- 기술 기반 감사 — 성능 (Core Web Vitals), SEO 기본, 보안 헤더, 끊어진 링크
- UX 완결성 확인 — 컴포넌트 상태, 양식 동작, 애니메이션 완성도, 모바일 사용성
- 콘텐츠 및 브랜드 검증 — 카피 품질, 플레이스홀더 감지, 음성 일관성, 시각적 일관성
- 다기기 및 출시 준비 — 브라우저 테스트, OG 미리보기, 분석, 404 페이지, 파비콘
사용 방법
전체 웹사이트 출시 전 감사
[사이트 URL]을 출시하려고 합니다. 전체 website-finishing-director 감사(5개 단계 모두)를 실행해주세요.
브랜드 사분면: [Warm+Calm / Warm+Active / Cold+Active / Cold+Calm].
대상 고객: [who].
특정 수정 후 단일 단계
방금 [사이트 URL]에서 성능을 최적화했습니다. Pass 2(기술 기반)만 실행해주세요.
랜딩 페이지 빠른 감사
이 랜딩 페이지를 감사해주세요: [URL]. 랜딩 페이지 프로필(단계 1, 2, 4)을 사용하세요.
지침
이 감사를 실행할 때는 5단계를 순서대로 따르세요. 각 단계는 이전 단계를 기반으로 구축됩니다 — 기초 위에 다듬기. 각 체크포인트에 점수를 매기고 우선순위별로 문제를 분류한 다음 최종 보고서를 생성합니다.
감사 프로필
모든 사이트에 5개 단계가 모두 필요한 것은 아닙니다. 프로젝트와 일치하는 프로필을 선택하세요:
| 프로필 | 단계 | 사용 시기 |
|---|---|---|
| 랜딩 페이지 | 1, 2, 4 | 단일 페이지 캠페인 또는 제품 페이지 |
| 전체 웹사이트 | 1, 2, 3, 4, 5 | 탐색, 양식, 콘텐츠가 있는 다중 페이지 사이트 |
| 전자상거래 | 2, 3, 5 | 장바구니, 결제, 제품 페이지가 있는 스토어 |
축소된 프로필을 사용할 때는 점수 총계를 비례적으로 조정하세요. Go/No-Go 임계값은 원시 점수가 아닌 백분율 점수에 적용됩니다.
Pass 1: 첫인상 (15점)
"방문자가 5초 안에 무엇을 이해하고 느끼는가?"
홈페이지(또는 히어로 섹션)를 5초 동안 보여줍니다. 다음 5가지 질문에 답하세요 — 각 3점:
## Pass 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 — 반대 사분면 (포지셔닝 혼란)
### Pass 1 점수: ___/15
판정:
- 12-15: 통과 — 첫인상이 명확하고 감정적으로 정렬됨
- 8-11: 개선 필요 — 방문자가 이해하지만 느리거나 마찰 있음
- <8: 실패 — 스크롤 없이 보이는 경험 재설계
통합: 감정적 느낌을 web-design-director 사분면 시스템과 비교하십시오. 브랜드가 Warm+Calm인데 사이트가 Cold+Active로 느껴지면 점수와 관계없이 P0입니다.
이 단계의 GUIA 문제점:
- CTA에
/contact/페이지 대신 Calendly URL이 하드코딩됨 (분석 망가짐) - 따뜻한 카피 톤과 차가운 UI 요소 혼합 (테라코타 팔레트 + 고정폭 글꼴 = 혼란)
Pass 2: 기술 기반 (25점)
"구축할 수 있을 만큼 인프라가 견고한가?"
## Pass 2 — 기술 기반
### 성능 (10점)
| 지표 | 목표 | 점수 |
|--------|--------|-------|
| LCP (최대 콘텐츠풀 페인트) | ≤ 2.5s | 0-3점 |
| INP (다음 페인트까지의 상호작용) | ≤ 200ms | 0-2점 |
| CLS (누적 레이아웃 이동) | ≤ 0.1 | 0-2점 |
| Lighthouse 성능 점수 | ≥ 85 | 0-3점 |
점수 매기기:
- LCP: 3 = ≤2.5s, 2 = ≤4.0s, 1 = ≤6.0s, 0 = >6.0s
- 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점) 프로덕션에 노출된 소스 맵 또는 디버그 엔드포인트 없음
### Pass 2 점수: ___/25
판정:
- 21-25: 견고 — 출시
- 16-20: 수용 가능 — P0 수정, P1 백로그와 함께 출시
- 11-15: 취약 — 심각한 기술적 부채
- <11: 손상 — 출시 금지
이 단계의 GUIA 문제점:
next.config.js에trailingSlash: true누락 (2026년 1월 Rental-CRM에서 색인 해제 발생)'use client'컴포넌트에export const metadata(메타데이터가 서버 측에서 렌더링되지 않음)- 모듈 수준 SDK 초기화 (Supabase/Stripe) — 빌드 시 env var가 없으면 실패, 함수 내부에서 지연 초기화
echo의 Vercel env var 후행 줄바꿈 — 대신printf사용- Railway
*.railway.internal호스트 이름 — Nixpacks 빌드 중에 연결 불가능, 공개 URL 사용
Pass 3: UX 완결성 (25점)
"사이트가 해피 패스뿐만 아니라 실제 사용을 처리합니까?"
## Pass 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점) 스크롤 동작이 올바르게 작동함 (사용자를 가두는 스크롤 하이재킹 없음)
### Pass 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아님)
Pass 4: 콘텐츠 및 브랜드 (20점)
"콘텐츠가 완성되고 일관되며 브랜드에 부합합니까?"
## Pass 4 — 콘텐츠 및 브랜드
### 카피 품질 (8점)
- [ ] (2점) 플레이스홀더 텍스트 발견되지 않음 ("Lorem ipsum", "[Your Name]", "Coming soon",
"example.com", "TODO", 빈 섹션)
- [ ] (1점) 철자 또는 문법 오류 없음
- [ ] (1점) 링크 텍스트가 설명적임 ("click here" 또는 링크 URL 직접 표시 아님)
- [ ] (1점) CTA 카피가 구체적임 ("Start free trial"이 "Submit" 아님)
- [ ] (1점) 제목 계층이 논리적임 (H1 → H2 → H3, 페이지당 하나의 H1)
- [ ] (1점) 대체 텍스트가 설명적임 ("image1.png" 또는 비어 있지 않음)
- [ ] (1점) 전화번호, 이메일, 주소가 실제임 (플레이스홀더 아님)
### 브랜드 음성 (6점)
- [ ] (2점) 톤이 브랜드 포지셔닝과 일치 (따뜻함/차가움, 공식적/캐주얼)
- [ ] (2점) 모든 페이지에서 음성이 일관됨 (같은 사람이 "말하는" 것처럼)
- [ ] (1점) AI 다듬기 표시 없음 ("Don't hesitate to contact us",
"In today's fast-paced world", "It's important to note that")
- [ ] (1점) CTA가 감정적 사분면과 일치 (따뜻한 브랜드 = 공격적이지 않은 초대형 CTA)
### 시각적 일관성 (6점)
- [ ] (1점) 색상 팔레트가 일관되게 사용됨 (브랜드 외 색상 없음)
- [ ] (1점) 타이포그래피 계층이 명확함 (디스플레이, 제목, 본문, 캡션 — 최대 2-3개 글꼴)
- [ ] (1점) 간격 리듬이 일관됨 (섹션 간 임의 패딩 없음)
- [ ] (1점) 아이콘 스타일이 통일됨 (외곽선, 채워짐, 이모지 혼용 금지)
- [ ] (1점) 이미지 처리 일관됨 (모든 사진이 동일한 필터/톤이거나 모두 일러스트레이션)
- [ ] (1점) 컴포넌트 스타일 일관됨 (카드, 버튼, 입력이 동일한 패턴 따름)
### Pass 4 점수: ___/20
판정:
- 17-20: 다듬어짐 — 콘텐츠가 완성되고 브랜드에 부합
- 13-16: 좋음 — 사소한 불일치, 출시 가능
- 9-12: 거침 — 콘텐츠 편집 필요
- <9: 미완료 — 주요 콘텐츠 격차 또는 브랜드 불일치
이 단계의 GUIA 문제점:
- Calendly URL이 올바른 전문가(Valeria 대 Matthieu 대 고객)와 일치해야 함
- 따뜻한 카피("We understand your challenges")와 차가운 UI(다크 모드, 고정폭, 날카로운 모서리) 혼합
- AI 생성 카피 감지: 게시하기 전에 이중 줄바꿈 제거 (LinkedIn의 AI 서명)
- credou.bzh 카피 방향: 메커니즘 우선, CV 없음, parcours/timeline 없음
Pass 5: 다기기 및 출시 (15점)
"모든 곳에서 작동하며, 라이브로 전환할 준비가 모두 되었습니까?"
## Pass 5 — 다기기 및 출시
### 브라우저 테스트 (5점)
3가지 주요 브라우저에서 테스트합니다. 브라우저별 점수:
- [ ] (2점) Safari — 올바르게 렌더링, 애니메이션 작동, 글꼴 로드
- [ ] (2점) Chrome — 올바르게 렌더링, 애니메이션 작동, 글꼴 로드
- [ ] (1점) Firefox — 올바르게 렌더링, 주요 중단 없음
브라우저당 확인: 레이아웃, 애니메이션, 글꼴, 양식, 스크롤 동작.
시각적 버그가 있는 브라우저당 1점 차감. 기능적 버그가 있는 브라우저당 2점 차감.
### 기기 테스트 (4점)
- [ ] (2점) 모바일 (375px) — 전체 사이트 이용 가능