h1sort/claude4aieng

h1sort.com/claude4aieng에 덱 게시하기

이 저장소가 진실 공급원입니다. h1sort-website는 생성된 공개 사본만 보유합니다. 사이트 저장소 내에서 덱을 절대 편집하지 마세요.

claude4aieng/deck/src/**  ──assemble.mjs --public──▶  h1sort-website/public/claude4aieng/index.html  ──▶  h1sort.com/claude4aieng/
표지 (슬라이드 1) 1200×630 JPEG                    ──▶  h1sort-website/public/claude4aieng/og.jpg

단계

1. 덱이 여기에 커밋되어 있어야 합니다. node deck/tools/assemble.mjs --expect 40:00 및 node deck/tools/shot.mjs deck/tool-use.html 이 통과하고; main 브랜치에 커밋 및 푸시합니다.
2. 공개 빌드: node deck/tools/assemble.mjs --expect 40:00 --public --out <scratch>/index.html. 이 명령은 모든 <aside class="notes">를 제거하고 data-public을 추가합니다 (컨트롤 바 없음; N, P, ? 비활성화). 확인: grep -c 'class="notes"' 결과가 0이어야 합니다.
3. OG 이미지는 슬라이드 1이 변경된 경우에만: Playwright(deck/node_modules 사용)로 ?still=1&solo=1&slide=1을 1200×630으로 렌더링, JPEG 품질 ~82, 300KB 미만 유지.
4. 사이트 저장소: git checkout main && git pull, 새 브랜치 chore/refresh-claude4aieng 생성, 파일을 public/claude4aieng/에 복사, npm ci && npm run build 실행, cmp dist/claude4aieng/index.html public/claude4aieng/index.html로 일치 확인.
5. 실제 라우팅 스모크 테스트: 백그라운드에서 timeout과 함께 npx wrangler dev --port 8799 실행; /claude4aieng → 307, /claude4aieng/ → 200, /snowflake/ 및 /gbm-ai/는 여전히 200을 반환해야 함. timeout으로 중지하고 pkill -f 'wrangler dev'는 사용하지 마세요 (해당 패턴은 셸 자체와 일치하여 명령을 종료시킴).
6. 덱 경로만 커밋 (public/claude4aieng, 변경된 경우 astro.config.mjs / public/llms.txt). 절대 git add -A 하지 마세요.
7. 모든 브랜치 푸시가 프로덕션을 배포합니다 (Workers Builds, 약 2.5분). 푸시 후 PR을 열고 즉시 병합하여 main이 라이브 상태와 일치하도록 합니다; 병합 커밋의 "Workers Builds" 확인이 성공했는지 확인합니다.

Lessons 로그

• 2026-10-18 · main이 2026-10-13 이후 프로덕션보다 뒤쳐져 있었음: Snowflake 발표가 feat/snowflake-world-tour 브랜치에서 배포되었음 (브랜치 푸시 = 배포) 그리고 병합되지 않았음. PR #20으로 병합됨 (트리는 배포된 브랜치와 동일, 눈에 띄는 변경 없음). 규칙: 브랜치가 배포된 당일에 항상 병합하세요.
• 2026-10-18 · /claude4aieng/ 첫 마운트: PR #21 (039a04b), claude4aieng b1b7e43에서 유래. 빌드 및 배포 확인 성공.
• 2026-10-18 · Claude Code 클라우드 세션에서 브랜치 삭제가 차단됨 (API 및 git push 모두 403); 병합된 브랜치는 GitHub UI에서 삭제하세요.
• 2026-10-18 · 새로고침: PR #22 (3aaff2f), claude4aieng 2d87bab에서 유래 (라이브 드라이 런 이후, 슬라이드 16의 측정 테이블). 배포 성공.
• 2026-10-18 · GitHub에서 paso-* 브랜치를 확인하려면 git ls-remote origin 'paso-*'를 사용하거나 명시적으로 가져오세요 (git fetch origin '+refs/heads/paso-*:refs/remotes/origin/paso-*'): 이 얕은 클론에서 일반 git fetch는 main만 업데이트하고 오래된 origin/paso-* 참조는 남깁니다.
• 2026-10-18 · 새로고침: PR #23 (403f357), claude4aieng 508bb0a에서 유래: Rotura #1b 슬라이드, 18개 슬라이드. 배포 성공.