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

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

상태

21개 showcase slug과 28개 공개 HTML route를 업그레이드 범위로 관리했다. 각 화면의 기존 design.md·토큰·기능 계약을 보존하면서, 원론·인지 연구는 화면의 선택 절차와 충돌 점검에만 사용했다. designpaca v0.12.0은 npm과 Forgejo에 공개됐고, Cloudflare production 배포와 전역 설치 10곳 갱신을 완료했다.

선택 절차

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는 오래된 게이트 점수 대신 현재 화면에서 확인 가능한 기능·정보로 갱신했다.

최종 완료 상태

• 최종 전체 재실행은 18개 계층 모두 통과했다. 최초 실행의 두 실패는 수정과 시각 검토 후 해소했고, 최종 기록은 verify-accepted.log다.
• npm v0.12.0과 Forgejo 릴리스를 공개했다. Cloudflare production 배포 후 6개 경로 × 데스크톱/모바일 12건에서 runtime·HTTP·이미지·폰트·가로 넘침 실패 0을 확인했다. 전체 자산 HTTP 동일성 검사는 마감 요청으로 중단했으며 통과로 계산하지 않았다.
• 사용자 참여 과업, 읽기 속도·이해도·전환 측정은 수행하지 않았다. 이 전후 사례는 강화된 스킬 지침을 기존 산출물에 적용한 비교이며, 스킬만의 인과 효과를 증명하지 않는다.