Fix smoke 1차 follow-up gaps: player resolver, type target, filter, utf8 (#12)

docs/guides/smoke-test.md

@@ -224,6 +224,24 @@ Smoke test 완료 후:
 3. 10회 재생 reliability 수치 → player DoD #7 update
 4. 이슈 #2 또는 새 이슈에 리포트 코멘트
 
+## 한글 yaml 확인 팁 (issue #12 Gap D)
+
+`ScenarioWriter`는 UTF-8 (BOM 없음)으로 저장한다. PowerShell `Get-Content`는
+시스템 코드페이지로 디코딩해서 한글이 깨져 보일 수 있다. 파일 자체의 정합성을
+확인하려면 다음 중 하나를 사용한다:
+
+```powershell
+# 권장: 명시적 UTF-8 디코딩
+Get-Content -Encoding UTF8 scenarios/box-v4.yaml
+
+# 또는 출력 시 BOM 없이 다시 저장해 비교
+Get-Content -Encoding UTF8 scenarios/box-v4.yaml | Out-File -Encoding UTF8 tmp.yaml
+```
+
+`UiaPathResolverTests.UiaPathParser_ParsesNameAttribute` 와
+`ScenarioWriter_RoundTrip_PreservesKorean` 가 한글 path/속성 round-trip을
+회귀로 잡는다.
+
 ## v3 이후 과제
 
 - recorder IME 조합 키 처리