Task #71: 다국어 적용 smoke 검증과 migration guide 작성

[postmelee]

요약

• 대상 타스크: Closes 다국어 적용 smoke 검증과 migration guide 작성 #71
• 왜: M050 다국어 적용 지원의 마지막 검증으로 locale pack 적용 가능성과 기존 한국어-only 저장소 migration 기준을 고정합니다.
• 무엇: locale별 smoke matrix, v0.2.0 -> v0.3.0 migration guide, migration 작성 규칙, manifest availability 완료 표현을 정리했습니다.
• 리뷰 포인트: docs/localization-smoke.md, docs/migrations/v0.2.0-to-v0.3.0.md, templates/manifest.json의 다국어 적용 smoke 검증과 migration guide 작성 #71 완료 상태 표현을 먼저 확인하면 됩니다.

변경 내역

• Stage 1 (b3614eb): en, ko, zh-CN 신규 적용 dry-run baseline과 manifest localization 계약을 기록했습니다.
• Stage 2 (4b52353): unsupported locale, 기존 update locale 보존/전환, placeholder와 승인 게이트를 smoke 결과로 정리했습니다.
• Stage 3 (91aa1ae): 기존 한국어-only 적용 저장소를 위한 v0.2.0 -> v0.3.0 migration guide를 작성했습니다.
• Stage 4 (7b8000f): stale 다국어 적용 smoke 검증과 migration guide 작성 #71 handoff 표현을 제거하고 M050 다국어 검증 완료 상태를 정리했습니다.

영향 영역

영역	변경	리뷰 포인트
다국어 smoke 문서	docs/localization-smoke.md 신규 작성	dry-run 기반 한계와 Stage 1-4 결과가 분리되어 있는지
migration 기준	docs/migrations/v0.2.0-to-v0.3.0.md, docs/migrations/README.md	unknown locale, ko 보존, locale 전환 승인 기준이 명확한지
manifest/test	templates/manifest.json, test/cli-smoke.test.js	#70/#71 완료 상태 표현과 테스트 기대값이 일치하는지

작업 문서

• 수행 계획서: task_m050_71.md
• 구현 계획서: task_m050_71_impl.md
• 최종 보고서: task_m050_71_report.md

핵심 리뷰 포인트

• fr unsupported locale이 실패나 조용한 fallback이 아니라 supported: no와 fallback 후보로 보고되는지 확인해 주세요.
• 기존 locale 미기록 저장소는 자동 한국어 추론이 아니라 unknown으로 보고하고, ko 보존 또는 전환은 별도 승인으로 분리했습니다.
• 실제 write mode, release/tag, npm publish는 이번 PR 범위가 아니며 migration guide와 최종 보고서의 후속 작업으로 남겼습니다.

검증

자동 검증

주제	검증 방법	결과	근거
CLI와 manifest smoke	npm test	OK	11개 테스트 pass
stale #71 표현 제거	`rg -n "후속 #71	#71에서 이어진다	smoke 검증과 migration guide는 #71
whitespace 검증	git diff --check	OK	출력 없음

수동/시나리오 검증

시나리오	확인 절차	결과	자료
신규 적용 locale baseline	init --locale en/ko/zh-CN --dry-run 결과 확인	OK	localization-smoke.md
기존 update locale 보존/전환	update --dry-run, update --locale zh-CN --dry-run 결과 확인	OK	Stage 2 보고서
migration guide 필수 섹션	grep -nE로 필수 섹션과 locale 근거 확인	OK	Stage 3 보고서

CI/원격 검증

PR 생성 전에는 원격 CI가 존재하지 않아 실행하지 않았습니다. PR 생성 후 GitHub Checks에서 확인합니다.

검증 한계

• 이번 검증은 dry-run과 문서/검색 기반입니다. 실제 적용 저장소 write mode, symlink 생성, .hyper-waterfall/version.json 쓰기는 수행하지 않았습니다.
• v0.3.0 GitHub Release/tag, npm publish, Homebrew/Docker/plugin 배포는 별도 release task 범위입니다.

관련 이슈

없음

후속 이슈 제안

• v0.3.0 release task에서 GitHub Release/tag, manifest version metadata, checksum, release notes 확정
• 실제 적용 저장소 write mode smoke
• manual/Skill locale mirror semantic review 자동화 또는 보조 스크립트

남은 리스크

• templates/manifest.json의 version metadata와 checksum 상태는 실제 v0.3.0 release task에서 다시 확정해야 합니다.
• 과거 mydocs/working/과 mydocs/report/ 기록에는 작성 당시 handoff 표현이 남아 있을 수 있습니다. 이번 PR은 현재 기준 문서와 사용자-facing 문서의 stale 표현 제거에 한정했습니다.