Task #7: GitHub Release + manifest + migration guide 도입

[postmelee]

요약

• 대상 타스크: GitHub Release + manifest + migration guide 도입 #7 GitHub Release + manifest + migration guide 도입
• 왜: 프롬프트 요청만으로 배포하면 기존 적용 저장소가 안전하게 업데이트할 기준이 부족해서, release/tag 기준의 추적 가능한 업데이트 단위가 필요했습니다.
• 무엇: templates/manifest.json, .hyper-waterfall/version.json 정책, docs/migrations/ 체계, README/Manual/agent entrypoint 연결 문서를 추가했습니다.
• 리뷰 포인트: manifest update policy, README의 사용자용 안내 범위, 프레임워크 설치·업데이트 lifecycle 프로토콜 정리 #8~npm CLI MVP로 init/update/doctor 제공 #10 후속 작업과의 경계입니다.

변경 내역

• Stage 1 (704d33f): manifest와 .hyper-waterfall/version.json 정책을 정의했습니다.
• Stage 2 (9816783): migration guide 작성 규칙과 v0.1.0-to-v0.2.0 기준 문서를 추가했습니다.
• Stage 3 (bbed828): README, agent entrypoint, Manual에 배포·업데이트 프로토콜을 연결하고 README 안내 범위를 보정했습니다.

영향 영역

영역	변경	리뷰 포인트
배포 기준	templates/manifest.json 추가	적용 파일 17개와 update policy 5종이 후속 자동화에 충분한지
업데이트 문서	docs/migrations/ 추가	기존 적용 저장소 수동 확인과 충돌 판단 기준이 명확한지
사용자/에이전트 문서	README, docs/agent-entrypoint.md, Manual 보강	README는 짧게, 상세 프로토콜은 문서로 분리한 범위가 적절한지

작업 문서

• 수행 계획서: task_m020_7.md
• 구현 계획서: task_m020_7_impl.md
• 최종 보고서: task_m020_7_report.md

핵심 리뷰 포인트

• templates/manifest.json의 overwrite, merge, manual, preserve, symlink 구분이 적용 저장소의 사용자 수정 파일을 보호하기에 충분한지 확인이 필요합니다.
• README에는 독립 배포 상세 섹션을 두지 않고, 설치/업데이트 인터페이스와 대상 저장소 구조만 짧게 남겼습니다.
• 실제 framework-install, framework-update, update PR, npm CLI는 프레임워크 설치·업데이트 lifecycle 프로토콜 정리 #8~npm CLI MVP로 init/update/doctor 제공 #10 범위로 남겼습니다.

검증

• test -f templates/manifest.json
• ruby -rjson -e 'JSON.parse(File.read("templates/manifest.json"))'
• grep -nE '"schemaVersion"|"frameworkVersion"|"release"|"versionState"|"files"|"updatePolicies"|"checksum"' templates/manifest.json
• grep -nE 'AGENTS.md|CLAUDE.md|templates/mydocs/skills|templates/mydocs/_templates|templates/.github' templates/manifest.json
• ruby -rjson -e 'm=JSON.parse(File.read("templates/manifest.json")); policies=m.fetch("updatePolicies").keys; missing=m.fetch("files").reject{|f| policies.include?(f.fetch("updatePolicy"))}; abort("unknown policy: #{missing.inspect}") unless missing.empty?; absent=m.fetch("files").reject{|f| f.fetch("kind") == "symlink" || File.exist?(f.fetch("source"))}; abort("missing source: #{absent.inspect}") unless absent.empty?; puts "files=#{m.fetch("files").size}, policies=#{policies.join(",")}"'
• test -f docs/migrations/README.md
• test -f docs/migrations/v0.1.0-to-v0.2.0.md
• grep -nE '^## (대상 버전|변경 요약|추가 파일|수정 파일|적용 저장소 수동 확인|충돌 가능성|검증|후속 작업)$' docs/migrations/v0.1.0-to-v0.2.0.md
• grep -nE '^## 배포와 업데이트|배포와-업데이트' README.md 결과 없음 확인
• grep -nE 'GitHub Release|manifest|migration|version|\.hyper-waterfall' README.md docs/agent-entrypoint.md templates/mydocs/manual/*.md
• grep -nE 'framework-install|framework-update|manifest|migration' templates/mydocs/manual/task_workflow_guide.md README.md
• git diff --check

관련 이슈

• 프레임워크 설치·업데이트 lifecycle 프로토콜 정리 #8 framework-install / framework-update Skill 추가
• 프로토콜 기반 update PR 워크플로우 정착 #9 update PR 워크플로우 정착
• npm CLI MVP로 init/update/doctor 제공 #10 npm CLI MVP로 init/update/doctor 제공
• 추가 배포 채널 확장안 검토 #11 추가 배포 채널 확장안 검토

후속 이슈 제안

• 없음. 위 후속 작업은 이미 M020 이슈로 분리했습니다.

남은 리스크

• 실제 v0.2.0 GitHub Release/tag 생성과 checksum 확정은 이번 PR 범위가 아닙니다.
• framework-install, framework-update, update PR 자동화, npm CLI는 후속 이슈에서 구현해야 합니다.
• 적용 저장소에서 docs/migrations/를 복사할지, 프레임워크 저장소의 고정 링크로 참조할지는 #9에서 확정해야 합니다.