Task #24 Stage 2: release 기준 문서 정합성 보강

postmelee · postmelee · commit 6b14eb9ad89d · 2026-05-09T01:17:13.000+09:00
diff --git a/docs/releases/v0.2.0.md b/docs/releases/v0.2.0.md
@@ -17,6 +17,18 @@
 | migration guide | `docs/migrations/v0.1.0-to-v0.2.0.md` | 대상 버전, 추가/수정 파일, 수동 확인, 충돌 가능성, 검증 기준을 포함해야 한다. |
 | checksum 상태 | `pending-release` | release/tag 생성 전에는 값이 비어 있을 수 있고, release 생성 승인 뒤 확정해야 한다. |
 
+## 정합성 대조 결과 (2026-05-09)
+
+| 대상 | 확인 결과 | 조치 |
+|---|---|---|
+| `package.json` | package version이 `0.2.0`이다. | 수정 없음 |
+| `templates/manifest.json` | `frameworkVersion: 0.2.0`, `plannedTag: v0.2.0`, `baselineTag: v0.1.0`, `release.status: planned`, checksum `pending-release` 상태다. | 수정 없음 |
+| `docs/migrations/v0.1.0-to-v0.2.0.md` | 대상 version, canonical 배포 단위, manifest 위치, checksum 상태, 보류 항목이 release 전 기준과 일치한다. | 수정 없음 |
+| `README.md` | 기존 적용 저장소 업데이트가 GitHub Release/tag, manifest, migration guide를 기준으로 판단된다고 설명한다. | 수정 없음 |
+| `docs/distribution-channels.md` | GitHub Release/tag + manifest + migration guide를 P0 canonical 기준으로 두고, npm/Homebrew/Docker/plugin을 실행 채널로 분리한다. | 수정 없음 |
+
+Stage 2 기준으로 version/tag 필드 불일치나 canonical 기준 충돌은 발견되지 않았다. 따라서 `templates/manifest.json`, README, migration guide, 배포 채널 전략 문서는 변경하지 않고, 이 release 준비 문서에 대조 결과만 남긴다.
+
 ## release 전 체크리스트
 
 ### manifest/version
diff --git a/mydocs/working/task_m020_24_stage2.md b/mydocs/working/task_m020_24_stage2.md
@@ -0,0 +1,49 @@
+# task_m020_24_stage2.md - manifest, migration, 안내 문서 정합성 보강 완료보고서
+
+GitHub Issue: [#24](https://github.com/postmelee/hyper-waterfall/issues/24)
+구현계획서: [`task_m020_24_impl.md`](../plans/task_m020_24_impl.md)
+Stage: 2
+
+## 단계 목적
+
+Stage 2는 `package.json`, `templates/manifest.json`, migration guide, README, 배포 채널 전략 문서의 `0.2.0` / `v0.2.0` / canonical 기준 표현을 대조하고, 불일치가 있으면 최소 보강하는 단계다.
+
+## 산출물
+
+| 파일 | 변경 요약 |
+|---|---|
+| `docs/releases/v0.2.0.md` | `정합성 대조 결과 (2026-05-09)` 섹션 추가. package, manifest, migration guide, README, distribution strategy의 version/tag/canonical 기준 충돌 없음과 무변경 판단 기록 |
+
+## 본문 변경 정도 / 본문 무손실 여부
+
+기존 Stage 1 release 준비 문서에 12줄을 추가했다. `templates/manifest.json`, `README.md`, `docs/distribution-channels.md`, `docs/migrations/v0.1.0-to-v0.2.0.md`, `package.json`은 대조만 수행했고 수정하지 않았다. manifest의 version/tag 필드와 checksum 상태는 기존 값을 보존했다.
+
+## 검증 결과
+
+실행 명령:
+
+```bash
+ruby -rjson -e 'JSON.parse(File.read("templates/manifest.json"))'
+rg -n '0.2.0|v0.2.0|plannedTag|baselineTag|GitHub Release|manifest|migration|pending-release' templates/manifest.json docs/migrations/v0.1.0-to-v0.2.0.md README.md docs/distribution-channels.md docs/releases/v0.2.0.md package.json
+git diff --check
+```
+
+결과:
+
+- OK: `templates/manifest.json` JSON parse 통과.
+- OK: `rg`가 `package.json`, `templates/manifest.json`, migration guide, README, `docs/distribution-channels.md`, `docs/releases/v0.2.0.md`에서 `0.2.0`, `v0.2.0`, `plannedTag`, `baselineTag`, `GitHub Release`, `manifest`, `migration`, `pending-release` 관련 기준을 확인했다.
+- OK: `git diff --check` 출력 없이 통과.
+
+## 잔여 위험
+
+- 실제 `v0.2.0` Git tag와 GitHub Release 존재 여부는 Stage 3에서 `git tag --list --sort=version:refname`과 `gh release list --repo postmelee/hyper-waterfall --limit 20`로 확인한다.
+- checksum 값은 아직 확정하지 않았다. release/tag 생성 승인 전까지 `pending-release` 상태를 유지한다.
+
+## 다음 단계 영향
+
+- Stage 3은 `docs/releases/v0.2.0.md`의 체크리스트와 release notes 초안을 최종 정리하고, tag/release 미생성 상태와 manifest parse를 통합 검증한다.
+- Stage 3에서도 실제 `git tag`, `gh release create`, npm publish 명령은 실행하지 않는다.
+
+## 승인 요청
+
+- Stage 2 산출물과 검증 결과를 승인하면 Stage 3으로 진행한다.
