Claude plugin 배포 후보 생성과 설치 smoke

[postmelee]

배경

Claude plugin packaging 검증이 통과하면 실제 배포 후보를 만들고 Claude Code 사용자가 설치 또는 발견할 수 있는지 smoke해야 한다. 이 task는 Claude 채널의 최종 배포 가능성을 확인하고, public 배포 또는 보류 판단을 남기는 단계다.

마일스톤 목적과 실행 순서

M040은 Docker를 제외하고 npm, Homebrew, Codex, Claude 채널의 v0.2.0 최종 배포 가능 상태를 만든다.

실행 순서:

1. npm publish 실행과 post-publish 검증
2. Homebrew formula local tap smoke PoC
3. Homebrew public tap 배포와 설치 안내
4. Codex/Claude plugin 공통 배포 원칙 정리
5. Codex plugin packaging 검증
6. Codex plugin 배포 후보 생성과 설치 smoke
7. Claude plugin packaging 검증
8. Claude plugin 배포 후보 생성과 설치 smoke
9. 최종 배포 채널 정합성 감사와 문서 갱신

목표

• Claude plugin 검증 결과를 반영한 배포 후보 bundle 또는 배포 절차를 만든다.
• Claude Code 환경에서 사용자가 Hyper-Waterfall entrypoint와 core Skill 흐름을 발견할 수 있는지 smoke한다.
• public 배포가 가능하면 별도 승인 후 실행하고, 불가능하면 보류 사유와 대체 설치 경로를 문서화한다.

범위 - 포함

• Claude plugin packaging 검증 결과 반영
• 배포 후보 bundle, metadata, README 또는 설치 안내 작성
• Claude Code 환경에서 install/load/discovery smoke
• .claude/skills, docs/agent-entrypoint.md, npm CLI fallback 확인
• public 배포가 가능한 경우 작업지시자 별도 승인 게이트 설정
• 배포 결과 또는 보류 사유 기록

범위 - 제외

• Codex plugin 배포
• Docker image 관련 작업
• Homebrew formula 갱신
• core Skill 본문을 Claude 전용으로 fork하는 작업
• 승인 없는 public 배포 실행

수용 기준

• Claude plugin 배포 후보 산출물 또는 명확한 배포 절차가 존재한다.
• Claude Code 환경에서 설치 또는 로드 smoke 결과가 기록된다.
• 사용자가 Claude Code에서 Hyper-Waterfall 시작 지점과 Skill 흐름을 찾을 수 있다.
• public 배포가 실행됐거나, 보류 사유와 대체 경로가 문서화된다.

검증 기준

• Claude plugin bundle 또는 배포 후보 구조 확인
• Claude Code install/load/discovery smoke 가능 여부 확인
• .claude/skills와 canonical Skill 경로 확인
• docs/agent-entrypoint.md fallback 확인
• npx hyper-waterfall@0.2.0 --help 경로 확인
• 배포 또는 보류 결과 문서 확인
• git diff --check

참고

• Codex/Claude plugin 공통 배포 원칙 정리 #36
• Claude plugin packaging 검증 #39
• docs/distribution-channels.md
• docs/agent-entrypoint.md
• templates/mydocs/skills/

마일스톤과 label 후보

• milestone: M040. Claude 채널을 검증에서 배포 후보 상태로 올리는 단계다.
• label: enhancement, infrastructure. 신규 배포 채널 산출물과 운영 구조에 해당한다.

확인

• 기존 열린 이슈와 중복되지 않음을 확인했습니다.
• 이번 task에서 제외할 항목을 명시했습니다.
• 작업 시작 전 수행계획서 승인 절차가 필요함을 이해했습니다.