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

[postmelee]

배경

Codex plugin packaging 검증이 통과하면 실제 배포 후보 bundle을 만들고 설치 smoke를 확인해야 한다. 이 task는 검증 결과를 배포 가능한 산출물로 고정하고, 공개 배포 또는 보류 판단을 기록하는 단계다.

마일스톤 목적과 실행 순서

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. 최종 배포 채널 정합성 감사와 문서 갱신

목표

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

범위 - 포함

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

범위 - 제외

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

수용 기준

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

검증 기준

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

참고

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

마일스톤과 label 후보

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

확인

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