# 전체 쇼케이스 업그레이드 보고서 · 2026-09-12

## 상태

21개 showcase slug과 28개 공개 HTML route를 업그레이드 범위로 관리했다. 각 화면의 기존 `design.md`·토큰·기능 계약을 보존하면서, 원론·인지 연구는 화면의 선택 절차와 충돌 점검에만 사용했다. `designpaca` skill release는 **v0.12.0으로 준비됐지만**, npm publish와 배포는 아직 진행 중이다.

## 선택 절차

1. 프로젝트 `design.md`와 실제 카피·이미지·상태를 먼저 읽고, 기존 브랜드·기능·진실성 계약을 확정했다.
2. 구도는 [art-direction](../packages/skill/references/art-direction.md)의 초점·정렬·면적·이미지 역할 질문으로 실제 화면 재료를 비교했다.
3. 타입은 실제 한글·숫자·긴 라벨의 폭·행간·fallback을 proof 했고, [시각 지각 연구](../packages/skill/references/visual-perception-research.md)의 선호와 읽기 성능 분리를 지켰다.
4. 색은 면적·배경·상태 조합에서 역할과 대비를 확인했다. 후보는 구조 차이가 있는 경우만 비교하고, 채택 이유와 기각 조건을 `design.md`에 남겼다.
5. 규범·기능 하드 게이트, 프로젝트 계약, 시각·과업 판정을 [SKILL](../packages/skill/SKILL.md) 기준으로 분리했다. 자동 통과만으로 시각 품질이나 사용자 효과를 선언하지 않는다.

## 현재 증거

| 범위 | 현재 결과 | 의미 |
| --- | --- | --- |
| 패키지 | Core 22, CLI 9, fail 0, skip 0; `verify-package` fail 0 | release worktree의 core·CLI 검사 결과 |
| 전체 캡처 | 28/28 route, partial 0, load failure 0 | 동결된 비교 소스의 두 viewport first/full 증거 수집 완료 |
| TWENTYOZ | 204 pass | 현장 탭·WebGL fallback·catalog·접근성·runtime 계약 검사 결과 |
| archive | 108 pass | archive showcase의 기능·상태 계약 검사 결과 |
| instrument | 10 rows, hard failure 0 | 계기판 계열의 계약 검토 결과 |
| global doctor | 10 완료 | 전역 doctor 검사 기록 |
| 홈 | 86 시나리오, 1,122 assertions | 홈 시나리오 검사 기록 |
| 최종 build | pass | release build 결과 |
| root 시각 검토 | 28개 모바일, 21개 데스크톱, 7개 하위 경로, 30개 앱 상태 수용 | 자동 검사와 별도인 실제 화면 검토 기록 |

위 수치는 각 검사 범위의 결과다. 전체 사이트의 접근성 인증, 실제 제품 성능, 사용자 만족도·전환·읽기 속도·이해도 향상을 뜻하지 않는다.

## 변경의 성격

- FORM은 사진·도면·인덱스의 순서를 건축 기록으로 재구성했고, 가상 사례·생성 이미지 표기를 유지했다.
- Font Foundry는 실제 마루부리·Pretendard 선택과 같은 폭의 문장 비교, 조판 제어를 전면에 두었다.
- 나머지 showcase는 사진/증거 표면, 정보 레일, 상태·행동의 위계를 각 프로젝트 `design.md`의 보존 자산과 기각 조건에 맞춰 조정했다.
- 공개 소개 metadata는 오래된 게이트 점수 대신 현재 화면에서 확인 가능한 기능·정보로 갱신했다.

## 재실행 상태와 남은 게이트

- 전체 full verify 재실행은 **진행 중**이다. 위 표는 현재 기록된 완료 묶음이며, `verify-final` 18개 중 16개는 즉시 통과했고 나머지 invariant·visual 2개는 수정 뒤 release 독립 재실행에서 ALL PASS·ALL MATCH였다.
- npm publish와 배포, 배포 URL에서의 실제 브라우저 검증은 **pending**이다.
- 사용자 참여 과업, 읽기 속도·이해도·전환 측정은 수행하지 않았다. 이 전후 사례는 강화된 스킬 지침을 기존 산출물에 적용한 비교이며, 스킬만의 인과 효과를 증명하지 않는다.