メニュー
VPAT(Voluntary Product Accessibility Template) 및 ACR(Accessibility Conformance Report)을 공식 양식 기준으로 작성하는 절차·표기·흔한 실수 정리. 공공조달·B2B SaaS·기업 도입 검토 시 요구되는 접근성 적합성 문서 작성 가이드.
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/puk0806/gugbab-claude --skill accessibility-vpat-writingコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
DDD(Domain-Driven Design) 아키텍처 핵심 패턴 - 유비쿼터스 언어, 서브도메인, 바운디드 컨텍스트, Aggregate, Entity/VO, 도메인 서비스/이벤트, 레이어드 아키텍처
대규모 React/Next.js 프로젝트를 layer-first(types/·utils/·hooks/·api/·components/ 밑에 도메인이 반복되는 구조)에서 domain-first(feature/도메인 우선) 구조로 전환하는 설계 기준과 절차. Feature-Sliced Design 2.1 정본(layers 6종·slices·segments·import 규칙·@x 크로스임포트·public API), FSD를 쓰지 않는 경량 대안(features + shared 2~3계층 + ESLint import/no-restricted-paths), Next.js App Router 공존 전략(route group `()`·private folder `_`·colocation), Turborepo/Nx 모노레포에서 폴더↔패키지 승격 기준, colocation과 배럴 파일 성능 트레이드오프, 도메인 경계 역추출(import 그래프·change coupling·용어 클러스터), 전환 실패 패턴(shared 비대화·entities 남용·순환 의존·도메인=라우트 착각·조기 추상화). 도메인 개념 자체(바운디드 컨텍스트·유비쿼터스 언어)는 `architecture/ddd` 스킬을 참조한다.
소스 파일 수천 개 규모 프론트엔드 코드베이스를 멈추지 않고 점진 재구조화하는 실행 전략 - Strangler Fig / Branch by Abstraction / Parallel Change, ts-morph·jscodeshift codemod, PR 분할·검증 게이트·되돌리기, 테스트 없는 코드의 안전망, 작업 순서 설계와 위반 수 기반 진행 추적
| name | accessibility-vpat-writing |
| description | VPAT(Voluntary Product Accessibility Template) 및 ACR(Accessibility Conformance Report)을 공식 양식 기준으로 작성하는 절차·표기·흔한 실수 정리. 공공조달·B2B SaaS·기업 도입 검토 시 요구되는 접근성 적합성 문서 작성 가이드. |
소스:
- ITI 공식 VPAT 페이지: https://www.itic.org/policy/accessibility/vpat
- Section508.gov ACR/VPAT FAQ: https://www.section508.gov/sell/acr-vpat-faq/
- Section508.gov "How to Create an ACR": https://www.section508.gov/sell/how-to-create-acr-with-vpat/
- EN 301 549 V3.2.1 (ETSI): https://www.etsi.org/deliver/etsi_en/301500_301599/301549/03.02.01_60/en_301549v030201p.pdf
- 한국형 KWCAG 2.2 (KS X OT0003): https://a11ykr.github.io/kwcag22/
검증일: 2026-06-02 기준 버전: VPAT 2.5Rev (ITI, 2025-04 발행)
VPAT(Voluntary Product Accessibility Template) 은 IT 제품·서비스의 접근성 적합성을 공급자가 자체 평가하여 기록하는 표준 양식이다.
주의: ITI는 작성된 VPAT의 내용을 검증해주지 않는다. 허위 기재는 전적으로 작성자 책임이며 거래 신뢰 손실·계약 분쟁의 사유가 된다.
| 용어 | 정의 |
|---|---|
| VPAT | 빈 템플릿 (ITI 배포 .doc 파일) |
| ACR | VPAT을 채워 완성한 보고서 (Accessibility Conformance Report) |
대외 공개·고객 전달 시 파일명은 ACR 형식으로 명명한다.
좋은 예: MyProduct_v2.5_WCAG_ACR_2026-06.pdf
나쁜 예: vpat_template_filled.docx
ITI는 시장별로 4가지 에디션을 제공한다. 작성자는 대상 시장에 맞춰 1개 또는 INT를 선택한다.
| 에디션 | 기준 표준 | 대상 시장 |
|---|---|---|
| VPAT 2.5 WCAG | WCAG 2.2 (A/AA/AAA) | 글로벌 일반, 한국 기업 글로벌 B2B 기본값 |
| VPAT 2.5 508 | Revised Section 508 + WCAG 2.0 | 미국 연방 조달 |
| VPAT 2.5 EU | EN 301 549 v3.2.1 + WCAG 2.1 AA | 유럽 공공 조달 |
| VPAT 2.5 INT | 위 세 가지 모두 통합 | 글로벌 전 시장 동시 대응 |
한국 기업이 글로벌 B2B SaaS 진출 시: WCAG Edition 기본 + 미국 연방 고객 있으면 INT Edition.
주의: 한국 국내 컴플라이언스(KS X OT0003 / KWCAG 2.2 / 디지털포용법 제21조)는 VPAT과 별개 트랙이다. 국내 인증(한국디지털접근성진흥원 웹접근성 품질마크)은 KWCAG 기준으로 별도 진행한다.
VPAT 2.5는 2023-09에 발표되어 WCAG 2.2 정렬(success criterion 9개 추가)했고, 2025-04에 2.5Rev로 소폭 개정되었다.
다음 버전(2.6) 예정 없음. WCAG 3.0 또는 EN 301 549·Section 508 대규모 개정 시 갱신 전망.
VPAT은 다음 순서로 구성된다.
[1] 표지 (Title Page)
[2] 적용 범위·서문 (Applicable Standards & Guidelines)
[3] 평가 방법론 (Evaluation Methods Used)
[4] WCAG 표 (Tables 1, 2, 3 — A, AA, AAA)
[5] Section 508 표 (508/INT 에디션만)
[6] EN 301 549 표 (EU/INT 에디션만)
[7] 약어·각주·법적 면책
Section508.gov가 누락 빈도가 가장 높다고 지적하는 항목들:
YYYY-MM-DDVPAT의 Conformance 컬럼에는 반드시 다음 4개 용어 중 하나만 사용한다. ITI Essential Requirements에 정의된 공식 용어 외 변형은 허용되지 않는다 (예: "Mostly Supports", "Compliant" 등 금지).
| 용어 | 공식 정의 | 사용 시점 |
|---|---|---|
| Supports | 제품 기능이 알려진 결함 없이 또는 equivalent facilitation으로 기준을 충족 | 완전 충족 |
| Partially Supports | 제품의 일부 기능이 기준을 충족하지 않음 | 일부 페이지·일부 기능 미충족 |
| Does Not Support | 제품 기능 대부분이 기준을 충족하지 않음 | 대부분 미충족 |
| Not Applicable | 해당 기준이 제품에 적용되지 않음 | 예: 비디오 없는 제품의 1.2.x 자막 |
추가 표기:
주의: "Partially Supports" 또는 "Does Not Support"인 경우 Remarks and Explanations 컬럼에 무엇이 미충족인지·어떤 페이지/기능에서 발생하는지를 반드시 설명해야 한다. ITI 공식 요구사항.
각 success criterion(SC)별로 다음 3개 컬럼을 채운다.
| Criteria | Conformance Level | Remarks and Explanations |
|---|---|---|
| 1.3.1 Info and Relationships (Level A) | Supports | 모든 폼 필드에 <label for> 연결. 헤딩 계층 점검 완료. axe DevTools 자동 점검 0 violations, 수동 점검(NVDA + Chrome) 통과. |
| 1.4.3 Contrast (Minimum) (Level AA) | Partially Supports | 본문 텍스트는 7.2:1로 충족. 그러나 /dashboard 페이지의 보조 라벨(.help-text) 3.8:1로 미충족. 2026-Q3 디자인 시스템 토큰 개편으로 4.5:1 이상 확보 예정. |
| 1.2.4 Captions (Live) (Level AA) | Not Applicable | 제품 내 라이브 비디오 콘텐츠 없음. 녹화 영상 자막은 1.2.2에서 평가. |
| 2.5.7 Dragging Movements (Level AA, WCAG 2.2 신규) | Supports | 모든 드래그 인터랙션에 키보드·버튼 대체 수단 제공. 칸반 보드 카드 이동 시 "위로/아래로" 버튼 제공. |
상세 SC 점검 방법은 [[wcag-2.2-checklist]] 스킬 참조. 본 스킬은 문서화 형식에 집중한다.
ACR의 신뢰성을 좌우하는 핵심 컬럼이다.
표지에 다음을 모두 명시한다.
대표적으로 사용되는 도구:
주의: 자동 도구는 WCAG SC의 약 30%만 커버한다 (Deque, WebAIM 공통 추정). 자동 도구만으로 "Supports"를 주장하는 것은 흔한 실수다. 반드시 수동 점검과 병행한다.
평가 범위는 항상 명확히 기술한다:
권장 표기 (필수는 아니나 신뢰성 ↑):
| 시점 | 작업 |
|---|---|
| D-30 | [[wcag-2.2-checklist]] 스킬 기반 자체 점검 시작. 대상 SC 목록 확정 |
| D-21 | 자동 도구(axe, WAVE, Lighthouse, Pa11y) 결과 수집 및 정리 |
| D-14 | 수동 점검 시나리오 수행. 키보드·스크린리더·확대·색맹 시뮬레이션 |
| D-10 | 사용자 시나리오 기반 end-to-end 검증 |
| D-7 | ITI 공식 사이트에서 최신 VPAT 템플릿(.doc) 다운로드. 채우기 시작 |
| D-5 | Conformance level 결정 + Remarks 초안 작성 |
| D-3 | 내부 리뷰 — 접근성 담당자 + 법무·컴플라이언스 |
| D-1 | ACR 자체 접근성 점검 (PDF 태깅, 헤딩 구조, 표 대체 텍스트) |
| D-Day | PDF/Word 산출 + ACR 명명 + 공식 채널 게시 |
흔한 실수: D-7 시점에 작년에 받은 템플릿을 재사용. 반드시 ITI에서 새로 다운로드해 최신 버전(VPAT 2.5Rev)을 사용한다.
| 영역 | 한국 국내 | 글로벌 (VPAT) |
|---|---|---|
| 기준 | KWCAG 2.2 (KS X OT0003) | WCAG 2.2 |
| 인증 | 한국디지털접근성진흥원(KWACC) 품질마크 | 자기 평가 (제3자 인증 별도) |
| 법적 근거 | 디지털포용법 제21조, 장애인차별금지법 | Section 508(미국), EAA(EU) |
| 구조 | 4원칙·14지침·33검사항목 | WCAG 4원칙·13가이드라인·86 SC (2.2 AAA 포함) |
주의: KWCAG 2.2와 WCAG 2.2는 구조와 일부 검사항목이 다르다. KWCAG 점검 결과를 그대로 VPAT에 옮기지 말고, WCAG SC 단위로 재매핑한다.
| 패턴 | 문제 |
|---|---|
| "Supports" 남발 | 실제 점검 안 한 채 모두 Supports로 표기 → 신뢰성 즉시 손실 |
| 자동 도구만으로 "Fully Supports" 주장 | 자동 도구는 SC의 ~30%만 커버. 수동 점검 필수 |
| Remarks 비어 둠 | Partially/Does Not Support인데 설명 없음 → ITI 공식 요구사항 위반 |
| 평가일·버전 갱신 누락 | 작년 ACR을 신제품 v2.5에 재사용 → 즉시 거절됨 |
| 잘못된 WCAG 버전 표기 | WCAG 2.0 기준으로 점검하고 "WCAG 2.2 Supports" 표기 |
| Partially Supports를 Roadmap 없이 둠 | 개선 일정 없으면 영구 미충족으로 해석됨 |
| 평가 범위 모호 | "전체 사이트" 또는 "핵심 12개 페이지" 명시 없음 |
| 4종 외 conformance level 사용 | "Mostly Supports", "Compliant" 등 → 공식 용어 위반 |
| Not Applicable 사유 누락 | "N/A"만 표기, 왜 해당 안 되는지 없음 |
| 구버전 VPAT 사용 | 2.5Rev가 최신인데 2.3·2.4 사용 |
| 지침 페이지 미삭제 | 템플릿의 안내(instructions) 페이지를 그대로 둔 채 배포 |
| ACR 자체의 접근성 미점검 | PDF 태깅·헤딩 구조·표 헤더 누락 |
| 일회성 작성 | 1년 이상 갱신 없음 — 제품 변경 시 즉시 갱신 권장 |
/accessibility 또는 /legal/accessibility 경로{ProductName}_v{Version}_{Edition}_ACR_{YYYY-MM}.pdf
예시:
Acme_v2.5_WCAG_ACR_2026-06.pdfAcme_v2.5_INT_ACR_2026-06.pdfAcme_Mobile_v1.0_508_ACR_2026-06.pdfPDF는 반드시 태깅된 PDF로 산출 (Word → PDF 변환 시 "구조 태그 포함" 옵션). ACR 자체가 접근성 위반이면 신뢰도 0이다.
VPAT® 2.5Rev — WCAG Edition
Accessibility Conformance Report
Name of Product/Version: Acme Dashboard v2.5
Report Date: 2026-06-30
Product Description: A web-based analytics dashboard for B2B SaaS customers.
Contact Information: accessibility@acme.example (Jane Doe, Accessibility Lead, CPACC)
Notes: This report covers the web application only. Mobile apps are reported separately.
Evaluation Methods Used:
- Automated: axe DevTools 4.9, WAVE 3.2, Lighthouse 11
- Manual: Keyboard-only navigation, NVDA 2024.1 + VoiceOver (macOS 14)
- Scope: 14 core pages covering full user journey (signup → checkout → admin)
Applicable Standards/Guidelines:
- Web Content Accessibility Guidelines 2.2, Levels A and AA