UI 복잡 버전 234 RED→GREEN 완료(docs/UI_USECASES.md §A~§J): 라이브 테마 전환(DynamicResource 전환+ThemeResolver+HighContrast 테마, 재시작 없음), 디자인 토큰 체계·WCAG 대비 결함 5건 수정, 설정창 카테고리 내비/검색 재구성+AppConfig 40여 속성, 다운로드 관리자(속도/ETA/세그먼트맵/전체 일시정지-이어받기/CSV 내보내기/예약 게이트/중복 확인), 라이브러리·아카이브·작업공간·재생목록·즐겨찾기 편집 뷰, 접근성(자동화 속성 30여 개·커스텀 피어·docs/ACCESSIBILITY.md), 인터랙션(휠 클릭 새 탭·XButton 탐색·F12·영역 캡처·프로필 전환), 상태/알림(토스트·알림센터·온보딩·CrashReportDialog). 보강 테스트 35건+실창 E2E 4건(StaDispatcher 기반 — 프록시 설정이 기시작 핸들러를 건드리는 크래시 실결함 수정 포함) — 453/453 GREEN. 이전 미커밋 작업(CI 워크플로·Mdns·QueueHub·UpdateChecker·AGENTS/CLAUDE·빌드 스크립트) 일괄 포함

.claude/skills/release/SKILL.md

@@ -0,0 +1,53 @@
+---
+name: release
+description: VideoDownloader 배포 절차. Windows 설치자(x64/arm64) 생성과 macOS/Linux 원격 빌드머신 빌드를 수행한다. "배포", "설치자 만들어", "릴리스", "publish" 요청에 사용.
+---
+
+# 배포
+
+배포는 되돌리기 어렵다. **각 단계 전에 사용자 확인을 받는다.** 요청받지 않은 배포를 임의로 하지 않는다.
+
+## 0. 사전 점검 (필수)
+
+```powershell
+dotnet test VideoDownloader.Tests
+git status --short
+```
+
+- 테스트 실패가 있으면 배포하지 않는다.
+- 커밋되지 않은 변경이 있으면 사용자에게 알린다. 원격 빌드는 `git archive HEAD` 로 소스를 보내므로
+  **커밋되지 않은 변경은 원격 빌드에 반영되지 않는다.**
+
+## 1. Windows 설치자
+
+```powershell
+./build/publish.ps1 -Config Release -Version <버전>
+```
+
+- 하는 일: `VideoDownloader.App` 을 `win-x64`/`win-arm64` self-contained 로 publish (`publish/<arch>/`)
+  → Inno Setup 으로 설치자 컴파일 → `out/VideoDownloader-Setup-<arch>.exe`
+- 필요: **Inno Setup 6** (`winget install --id JRSoftware.InnoSetup -e`).
+  없으면 스크립트가 명시적으로 throw 한다.
+- 특정 아키텍처만: `-Archs x64`
+- arm64 첫 빌드는 yt-dlp/WebView2 런타임 관련으로 실패할 수 있다. 실패 메시지를 그대로 사용자에게 전달한다.
+- 완료 시 스크립트가 산출물 크기를 출력한다. **그 출력을 인용해 보고한다.**
+
+## 2. macOS / Linux 원격 빌드
+
+```bash
+bash build/remote/build-remote.sh all      # 또는 linux | mac
+```
+
+- 하는 일: `git archive HEAD` 로 현재 커밋 소스를 빌드머신에 SSH 전송 →
+  `Cli` + `Avalonia` 를 RID별 self-contained publish → `out/remote/<rid>/artifacts-<rid>.tar.gz` 수집
+- 자격 증명은 `.env` 의 `MAC_OS_HOST`/`LINUX_OS_HOST` 등을 쓴다.
+  **`.env` 내용을 읽어서 출력하거나 로그에 남기지 않는다.**
+- 빌드머신이 절전이면 SSH 가 끊긴다. 재연결 후 재시도한다.
+- Avalonia 12.1 은 빌드머신에 .NET 10 SDK 가 있어야 한다. 8만 있으면 CS0103 으로 실패한다.
+
+## 3. 배포 후
+
+- 산출물 경로와 크기를 보고한다.
+- `out/`, `publish/` 는 gitignore 대상이다. 커밋하지 않는다.
+- 릴리스 배포처(GitHub Releases 등)에 올리는 것은 **별도 승인 사항**이다. 임의로 업로드하지 않는다.
+- 배포 체계 전반은 `docs/DEPLOYMENT_PLAN.md` 참고.

.claude/skills/tdd/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: tdd
+description: VideoDownloader 에서 기능을 추가하거나 버그를 고칠 때 쓰는 RED→GREEN→증거 폐쇄루프 절차. 실패 테스트를 먼저 만들고, 최소 구현으로 통과시키고, 실행 증거까지 남긴다. "기능 추가", "버그 수정", "TDD로", "테스트부터" 같은 작업에 사용.
+---
+
+# TDD 폐쇄루프
+
+이 저장소는 RED→GREEN→증거로 개발해 왔다. 이 순서를 건너뛰지 않는다.
+
+## 0. 기준선 확보 (건너뛰지 말 것)
+
+```powershell
+dotnet test VideoDownloader.Tests
+```
+
+지금 몇 개가 통과하는지 **숫자를 기록**한다. 이미 깨져 있다면 그것부터 사용자에게 알린다.
+내 변경으로 깨진 것과 원래 깨져 있던 것을 섞지 않기 위해 반드시 먼저 한다.
+
+## 1. RED — 실패를 먼저 본다
+
+고칠 동작을 **재현하는 테스트**를 쓴다.
+
+- 위치: `VideoDownloader.Tests/<영역>/<대상>Tests.cs`
+  (영역 = `Browser` · `E2E` · `Infrastructure` · `Mobile` · `Platform` · `Server`)
+- 순수 로직이면 `Core`/`Mobile.Core` 쪽으로 밀어 넣어 UI 없이 테스트되게 만든다.
+  WPF 의존이 꼭 필요하면 `Infrastructure/WpfTestApp.cs` 패턴을 따른다.
+- 사용자 데이터 경로를 건드리는 테스트는 `VD_DATA_DIR` 로 격리한다.
+
+```powershell
+dotnet test VideoDownloader.Tests --filter "FullyQualifiedName~<새테스트이름>"
+```
+
+**실패하는 것을 눈으로 확인한다.** 여기서 통과해 버리면 테스트가 대상을 못 잡고 있는 것이다.
+테스트를 고쳐서 진짜 실패하게 만든 다음 진행한다.
+
+## 2. GREEN — 최소 구현
+
+- 테스트를 통과시키는 가장 작은 변경만 한다. 겸사겸사 리팩터링하지 않는다.
+- 에러를 삼키지 않는다. 빈 `catch`, 가짜 폴백 금지. 근본 원인을 고친다.
+- 거대 파일(`MainWindow.xaml.cs` 86KB)은 Grep 으로 위치를 찾아 필요한 구간만 읽고 고친다.
+
+```powershell
+dotnet test VideoDownloader.Tests
+```
+
+**전체**가 통과해야 한다. 기준선보다 테스트 수가 줄면 무언가를 지운 것이다 — 되돌린다.
+
+## 3. 증거 — 테스트로 부족한 것
+
+UI·플랫폼 동작을 바꿨다면 테스트 GREEN 만으로는 "된다"는 근거가 아니다.
+
+| 바꾼 것 | 확인 방법 |
+|---|---|
+| WPF 화면·상호작용 | `dotnet run --project VideoDownloader.App` 로 실제 창을 띄워 확인 |
+| WebView2 감지·쿠키 | 실제 사이트를 열어 미디어가 목록에 잡히는지 확인 |
+| 서버 API | 앱 기동 후 해당 엔드포인트 호출 |
+| MAUI 화면 | Android 에뮬레이터에 배포해 확인 |
+| 다운로드 엔진 | `dotnet run --project VideoDownloader.Cli -- <검증 옵션>` |
+
+무엇을 어떻게 확인했는지 보고에 쓴다. "확인했습니다"만 쓰지 말고 관측한 내용을 쓴다.
+
+## 4. 마무리
+
+- `docs/BACKLOG.md` 해당 항목 `- [ ]` → `- [x]`
+- 계획 대비 구현 상태가 바뀌었으면 `docs/IMPLEMENTATION_AUDIT.md` 갱신
+- 보고에는 **실제 테스트 출력의 숫자**를 인용한다 (예: "164/164 통과"). 기억으로 쓰지 않는다.
+
+## 막혔을 때
+
+- 원인을 모르겠으면 추측으로 코드를 바꾸지 말고, 먼저 재현 범위를 좁히는 테스트를 더 쓴다.
+- 그래도 안 되면 무엇을 시도했고 무엇이 관측됐는지 정리해 사용자에게 보고한다.
+  통과하지 못한 것을 통과한 것처럼 쓰지 않는다.

.claude/skills/verify/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: verify
+description: VideoDownloader 변경사항이 완료 기준(Definition of Done)을 만족하는지 전수 점검한다. 빌드·테스트·경고·문서 동기화·산출물 오염까지 확인하고 통과/미통과를 판정한다. "다 됐나 확인", "검증해줘", "완료 기준 점검", 작업을 마무리하기 직전에 사용.
+---
+
+# 완료 검증
+
+작업을 "완료"로 보고하기 전에 아래를 순서대로 실행하고, 각 항목의 **실제 출력**을 근거로 판정한다.
+하나라도 실패하면 완료가 아니다. 고치거나, 못 고치는 이유를 명시한다.
+
+## 1. 테스트
+
+```powershell
+dotnet test VideoDownloader.Tests
+```
+
+- 실패 0건인가?
+- 통과 수가 작업 전보다 줄지 않았는가? (현재 기준선 164)
+- 새로 추가한 동작을 실제로 검증하는 테스트가 있는가? 없으면 지금 쓴다.
+
+## 2. 빌드 · 경고
+
+```powershell
+dotnet build VideoDownloader.App
+```
+
+- 오류 0인가?
+- **내가 새로 만든 경고가 있는가?** 기존 경고(`MainWindow.xaml.cs`·테스트의 CS8602 몇 건,
+  xUnit 분석기 경고)는 알려진 것이다. 개수가 늘었으면 내가 늘린 것이다 — 고친다.
+
+모바일을 건드렸다면 (MAUI 워크로드가 설치돼 있을 때):
+
+```powershell
+dotnet build VideoDownloader.Mobile -f net10.0-android
+```
+
+## 3. 실행 증거
+
+UI·플랫폼 동작을 바꿨는데 실행해 보지 않았다면 여기서 멈추고 실행한다.
+`/tdd` 스킬의 "3. 증거" 표를 따른다. 무엇을 관측했는지 기록한다.
+
+## 4. 저장소 위생
+
+```powershell
+git status --short
+```
+
+- 산출물(`out/`, `publish/`, `bin/`, `obj/`)이 변경 목록에 보이는가? → `.gitignore` 가 뚫린 것이다.
+- `.env` 가 보이는가? → **즉시 멈추고 사용자에게 알린다.** 실제 자격 증명이 들어 있다.
+- 의도하지 않은 파일이 섞였는가?
+
+```powershell
+git diff --stat
+```
+
+- 변경 규모가 작업 범위와 맞는가? 요청하지 않은 리팩터링이 섞이지 않았는가?
+
+## 5. 문서 동기화
+
+- `docs/BACKLOG.md` — 완료 항목 체크박스 반영했는가?
+- `docs/IMPLEMENTATION_AUDIT.md` — 계획 대비 구현 상태가 바뀌었으면 갱신했는가?
+- 명령·구조·규약이 바뀌었으면 `AGENTS.md` 와 `README.md` 도 갱신했는가?
+
+## 6. 판정 보고
+
+아래 형식으로 사용자에게 보고한다. **실제 출력에서 숫자를 인용한다.**
+
+```
+검증 결과
+- 테스트: <통과>/<전체> 통과, 실패 <n>건
+- 빌드: 오류 <n>, 신규 경고 <n>
+- 실행 증거: <무엇을 어떻게 확인했는지 / 해당 없음>
+- 저장소: 변경 <n>건, 산출물 오염 없음
+- 문서: <갱신한 파일 / 갱신 불필요>
+판정: 완료 | 미완료(사유: …)
+```
+
+미통과 항목을 숨기거나 완곡하게 쓰지 않는다.