배경

현재 Hyper-Waterfall 적용은 AI에게 프롬프트로 요청해 templates/를 복사하거나 반영하는 방식에 가깝다. 이 방식은 초기 도입에는 단순하지만, 이미 적용한 저장소가 어떤 버전을 쓰는지와 어떤 파일을 안전하게 갱신할 수 있는지 추적하기 어렵다. README, Skill, Manual, Issue/PR template처럼 방법론 파일이 바뀌면 기존 사용자에게 업데이트 경로를 제공해야 한다.

목표

• GitHub Release/tag를 canonical 배포 단위로 정의한다.
• 적용 저장소에 남길 Hyper-Waterfall 버전 기록 위치와 형식을 정한다.
• templates/manifest.json으로 배포 파일, 체크섬, overwrite/merge/symlink 정책을 정의한다.
• 버전 간 migration guide 작성 위치와 필수 섹션을 정한다.

범위 - 포함

• templates/manifest.json 초안 추가
• 적용 저장소 버전 기록 파일 정책 추가
• docs/migrations/ 또는 동등한 migration 문서 위치와 템플릿 정의
• GitHub Release/tag 기준 배포 설명을 README/Manual에 반영
• 기존 적용 저장소 업데이트를 고려한 overwrite/merge/symlink 정책 정리

범위 - 제외

• npm CLI 구현
• 실제 GitHub Release 생성 자동화
• Homebrew, Docker, Codex/Claude plugin 배포 구현
• 적용 저장소별 자동 병합 알고리즘 구현

수용 기준

• manifest가 포함 파일과 업데이트 정책을 사람이 검토 가능한 구조로 표현한다.
• 적용 저장소가 현재 Hyper-Waterfall 버전을 기록할 수 있는 위치가 명확하다.
• migration guide가 버전 간 추가/수정/수동 확인 항목을 설명한다.
• README/Manual에서 "프롬프트만 배포"가 아니라 "버전된 배포 단위 + 업데이트 프로토콜"로 설명된다.

검증 기준

• manifest JSON parse 검증
• README/Manual에서 manifest, migration, GitHub Release, version 키워드 확인
• 신규 migration 문서 또는 템플릿의 필수 섹션 확인
• git diff --check

참고

• M020 로드맵 1단계: GitHub Release + manifest + migration guide
• 후속 이슈는 install/update Skill, update PR workflow, npm CLI MVP에 의존한다.

마일스톤과 label 후보

• milestone: M020 - 배포·업데이트 프로토콜 MVP의 기반 작업이므로 선택
• labels: enhancement, documentation, infrastructure
  • enhancement: 새 배포 프로토콜 도입
  • documentation: README/Manual/migration 문서 추가
  • infrastructure: 저장소 적용·업데이트 운영 구조 변경