designpaca/docs/full-showcase-upgrade-20260912.md

전체 쇼케이스 업그레이드 보고서 · 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의 초점·정렬·면적·이미지 역할 질문으로 실제 화면 재료를 비교했다.
3. 타입은 실제 한글·숫자·긴 라벨의 폭·행간·fallback을 proof 했고, 시각 지각 연구의 선호와 읽기 성능 분리를 지켰다.
4. 색은 면적·배경·상태 조합에서 역할과 대비를 확인했다. 후보는 구조 차이가 있는 경우만 비교하고, 채택 이유와 기각 조건을 design.md에 남겼다.
5. 규범·기능 하드 게이트, 프로젝트 계약, 시각·과업 판정을 SKILL 기준으로 분리했다. 자동 통과만으로 시각 품질이나 사용자 효과를 선언하지 않는다.

현재 증거

범위	현재 결과	의미
패키지	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이다.
• 사용자 참여 과업, 읽기 속도·이해도·전환 측정은 수행하지 않았다. 이 전후 사례는 강화된 스킬 지침을 기존 산출물에 적용한 비교이며, 스킬만의 인과 효과를 증명하지 않는다.