Communitygithub.com

런치 QA

웹사이트의 성능, 접근성, SEO 기초, 양식, 크로스 디바이스 동작 및 콘텐츠를 사전 출시 품질 점검하고, 심각도별로 분류된 결과와 수정 방법을 보고합니다. 누군가 사이트가 '출시 준비 완료', '라이브 예정'이라고 하거나, '내 사이트를 확인해 줘', QA 패스, 웹사이트 감사, Lighthouse 스타일 리뷰를 요청하거나, 페이지가 느리거나 점수가 낮은 이유를 알고 싶어 할 때 사용하세요.

런치 QA란 무엇인가요?

이 기술은 웹사이트 출시 전 품질 점검(런치 QA)을 자동화하고 보고하는 AI 에이전트 스킬입니다. 사용자가 '사이트를 확인해 달라', '출시 준비가 되었다'고 말할 때, AI가 성능, 접근성, SEO, 양식, 크로스 디바이스 동작, 콘텐츠 정확성 등 40개 이상의 항목을 점검하고 심각도(Blocker, Should fix, Polish)별로 분류하여 보고서를 생성합니다. 주로 Claude Code, Cursor, Codex 같은 터미널 기반 AI 에이전트에서 사용되며, `webcraft` CLI 도구나 MCP `audit_site` 도구를 활용해 측정 가능한 검사를 먼저 수행한 후, AI가 직접 확인해야 하는 렌더링, 키보드 사용, 실제 기기 테스트, 콘텐츠 정확성 등에 집중합니다. 보고서는 'Verdict'(Ready / Ready after blockers / Not ready)로 바로 결론을 알리고, 각 문제를 '문제-위치-수정'의 한 줄로 명확히 기술하여 소유자가 즉시 조치할 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/imperfec-t/webcraft/tree/HEAD/skills/launch-qa

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

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

문서

런치 QA (Launch QA)

소유자를 당황하게 하거나 문의를 놓치게 할 요소를 찾아 순위를 매기고 수정 방법을 제시합니다. 동등한 무게의 40개 사소한 지적 목록은 유용하지 않습니다. 세 가지 차단 요소와 짧은 꼬리 목록이 효과적입니다.

실행 방법

  1. 검사 가능한 대상을 파악하세요: 라이브 URL, 소스 파일, 또는 둘 다. 수행하지 못한 검사(예: 실제 기기 테스트 또는 양식 전달)는 통과로 표시하지 말고 명시하세요.

  2. webcraft CLI를 사용할 수 있으면 먼저 실행하여 측정 가능한 검사를 수행하세요 (또는 MCP audit_site 도구 호출):

    webcraft audit https://example.com --pages 10     # 라이브 사이트: robots, sitemap, redirects, 404, 링크도 함께 검사
    webcraft audit ./dist                             # 로컬 빌드 폴더
    webcraft audit ./dist --json --fail-on blocker    # CI: 블로커가 있으면 exit 1
    

    위 명령은 아래 보고서 템플릿과 함께 "확인되지 않음" 목록을 생성합니다. 놀라운 발견은 반복하기 전에 확인하고, 도구가 볼 수 없는 항목(렌더링, 키보드 사용, 실제 기기, 콘텐츠 정확성)에 집중하세요.

  3. 아래 영역을 하나씩 살펴보세요. 의견보다 측정을 우선시하세요: 페이지를 실행하고, 마크업을 읽고, 바이트를 계산하세요.

  4. 각 발견 사항을 분류하세요:

    • 블로커 (Blocker): 기능 고장, 핵심 콘텐츠 접근 불가, 전달되지 않는 양식, 잘못되었거나 플레이스홀더 콘텐츠, 인덱싱이 필요한데 불가능한 사이트.
    • 수정 권장 (Should fix): 속도, 접근성 또는 검색 노출에 측정 가능한 손해를 주는 경우.
    • 개선 사항 (Polish): 사소한 불일치.
  5. 마지막에 있는 템플릿을 사용하여 보고하세요.

기능 및 콘텐츠

  • 모든 링크와 버튼은 실제 목적지로 연결됩니다. #, lorem ipsum, 템플릿 잔재, 테스트 이메일 주소가 없어야 합니다.
  • 양식: 필수 입력 검증, 명확한 오류 메시지, 성공 상태, 스팸 방지, 그리고 실제 테스트 제출이 올바른 받은편지함에 도착하는지 확인.
  • 전화번호는 tel:을, 이메일은 mailto:를 사용하며, 정확한 번호여야 합니다 (헤더와 푸터 간 번호 불일치 확인).
  • 404 페이지가 존재하고 홈으로 연결되어야 합니다.
  • 필요한 법적 페이지: 개인정보 처리방침, 이용약관, 추적을 사용하는 경우 쿠키 알림.
  • 저작권 연도와 업체 정보가 최신이고 일관되어야 합니다.

성능

4G 환경의 중간 가격대 휴대폰 기준: LCP 2.5초 미만, INP 200ms 미만, CLS 0.1 미만.

  • 이미지: 최신 형식(WebP 또는 AVIF), 표시 크기에 맞게 조정, width 및 height 속성 설정, 스크롤 아래는 loading="lazy", LCP 이미지는 미리 로드하고 lazy 사용 금지.
  • 비디오: 포스터 이미지 제공, 소리와 함께 자동 재생 금지, 압축, 장식용인 경우 작은 화면에서 로드하지 않음.
  • 폰트: 최대 두 종류, font-display: swap, 상단 영역 파일 미리 로드.
  • CSS 및 JS: 축소, 가능한 경우 지연 로드, 사용하지 않는 라이브러리 없음 (정적 이미지 하나를 위해 슬라이더 라이브러리를 로드하는 경우 흔함).
  • 타사 스크립트: 각각 정당화 필요. 채팅 위젯과 트래커는 빈번한 LCP 및 INP 위반 요소입니다.
  • 서버에서 캐싱 및 압축 활성화.

접근성

  • h1은 하나만; 제목 수준을 건너뛰지 않음.
  • 모든 의미 있는 이미지에 alt 텍스트 제공; 장식용 이미지는 alt="".
  • 텍스트 대비 최소 4.5:1 (큰 텍스트는 3:1). 이미지 위 텍스트와 흐린 회색 텍스트를 먼저 확인.
  • 모든 기능이 키보드로 작동: 보이는 포커스 링, 논리적 순서, 메뉴와 아코디언 작동 가능, 포커스 트랩 없음.
  • 양식 필드는 연결된 <label> 요소가 있어야 함; 오류는 색상만으로 표시하지 않고 알림으로 전달.
  • prefers-reduced-motion 준수; 깜빡임 없음; 자동 재생 모션은 일시 중지 가능.
  • <html>에 lang 속성; 200% 확대에서 페이지 정상 작동.

SEO 기초

  • 페이지별 고유 <title> (50~60자) 및 메타 설명 (약 150자).
  • 표준 URL(canonical) 설정; 도메인의 한 버전(https, www 유무)으로 나머지를 리디렉션.
  • robots.txt가 사이트를 차단하지 않음, 스테이징 환경에서 남은 noindex 없음, XML 사이트맵 존재.
  • 공유 링크가 제대로 표시되도록 Open Graph 제목, 설명 및 이미지 (1200x630, https 제공).
  • 구조화된 데이터 (Organization, LocalBusiness, FAQ, Article 등)가 적합한 곳에 있고 유효해야 함.
  • "여기를 클릭하세요" 대신 설명적인 링크 텍스트; 깔끔한 URL.

크로스 디바이스

  • 너비 320, 390, 768, 1024, 1440: 가로 스크롤 없음, 텍스트 겹침 없음, 터치 대상 최소 44px.
  • 최신 Chrome, Safari, Firefox 및 Edge; 특히 iOS Safari에서 vh 단위, 고정 위치 지정, 비디오 자동 재생 확인.
  • JavaScript 실패 시 애니메이션이 콘텐츠를 숨기지 않아야 함.

보안 및 운영

  • 모든 곳에서 HTTPS, 혼합 콘텐츠 없음.
  • CMS, 테마 및 플러그인 업데이트; 사용하지 않는 플러그인과 테마 제거; 기본 관리자 사용자 이름 사용 금지.
  • 백업 일정 수립 및 복원 테스트 완료.
  • 분석 및 서치 콘솔 연결, 필요한 경우 동의 처리.
  • 파비콘 및 터치 아이콘 존재.

보고서 템플릿

# Launch QA: [사이트명]   확인일: [날짜]   범위: [검사 및 미검사 항목]

평가: 준비 완료 / 차단 요소 해결 후 준비 완료 / 준비 안 됨

## 블로커
1. [문제] — [위치] — [수정 방법]

## 수정 권장
...

## 개선 사항
...

## 확인되지 않음
- [검사 항목] — [미확인 이유 및 소유자가 확인할 수 있는 방법]

각 발견 사항은 문제, 위치, 수정 방법을 한 줄로 유지하세요. 평가를 먼저 제시하여 소유자가 즉시 자신의 상황을 파악할 수 있도록 하세요.

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

design-tokens

Create a website's visual system as CSS custom properties, covering color palette, typography scale, spacing, radius and shadows, with contrast checked. Use this whenever someone asks for a color scheme, a palette from one brand color, font pairing, a type scale, "make it look consistent", dark mode, a rebrand of an existing site into new colors, or starts a build with no defined styles.

hero-section

Design and build the hero (first screen) of a website, including headline layout, media treatment, CTA, proof badge, marquee and entrance animation. Use this whenever someone asks for a hero section, a landing page header, "the top of my homepage", a cinematic or animated intro, a video background, a text marquee, or says their first screen looks plain or generic.

homepage-blueprint

Plan the section structure and content slots of a homepage for an agency, freelancer, studio or service business before any design or code. Use this whenever someone asks "what sections should my homepage have", "plan my website", "structure a landing page for my business", wants a wireframe or sitemap for a service site, or starts building a homepage without a clear outline.

responsive-layout

Build page layouts that work from phones to wide desktops using CSS grid, flexbox, container queries and fluid sizing, including card grids, bento grids, split sections, sticky sidebars and navigation that collapses. Use this whenever someone says their site "breaks on mobile", asks for a responsive grid, a bento layout, a mobile menu, fixing horizontal scroll or overflow, or is laying out any multi-column section.

scroll-motion

Add scroll-driven and entrance animation to a website with GSAP, ScrollTrigger and Lenis, including reveals, parallax, pinned sections, horizontal scroll, line drawing, counters and preloaders. Use this whenever someone wants a site to "feel premium", asks for smooth scrolling, scroll animations, parallax, text reveals, a pinned or sticky scroll section, an animated preloader, or names GSAP, ScrollTrigger, Lenis, Locomotive or AOS.

site-teardown

Analyze a live website and turn it into a section-by-section build brief that another person or AI can rebuild from, with brand name, colors, fonts and images swapped for placeholders. Use this whenever someone shares a URL and says "analyze this site", "make something like this", "give me a prompt to build this", "recreate this effect", "clone the layout with my branding", or asks how a page's animation or structure works, even if they never say "teardown".

website-workflow

Plan and sequence a whole website build, from structure through design, code, WordPress and launch, by routing each stage to the right webcraft skill. Use this when someone asks to "build me a website", "design my site from scratch", "redo our homepage", wants an end-to-end plan for a marketing, agency, studio or service site, or the request spans more than one of structure, look, layout, motion, CMS and QA.

wordpress-theme-build

Turn a static HTML/CSS/JS design into a custom WordPress theme that the client can edit, covering theme structure, theme.json, enqueueing scripts, block patterns, custom post types and editable content. Use this whenever someone wants to convert a design or static site to WordPress, build a custom or block theme, make sections editable in Gutenberg, add GSAP or other scripts to a theme properly, or asks why their theme edits are lost or their content is hard-coded.

관련 스킬