diff --git a/AGENTS.md b/AGENTS.md
index b9a67ce17..5babb1a40 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -83,6 +83,7 @@ This section applies to any agent (Claude, Codex, Cursor, opencode, ...) working
 - Keep UI and analysis engine decoupled through shared contracts.
 - Prefer minimal, test-first changes for production code.
 - Prefer practical, friendly, rehearsal-first wording over academic or authority-heavy language.
+- When YouTube import fails, customer-facing copy must name Paste another YouTube link as the next rehearsal action. The field-level message stays redacted; the recovery action only focuses the existing YouTube field.
 - Do not reduce the product to a chord analyzer when form, timing, player coordination, playable ranges, simplification, and setup cues are the real rehearsal blockers.
 - Do not frame usability as a reason to accept weak analysis quality; BandScope should aim for both easy use and high accuracy.
 
diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md
index ca0df5ac4..1176679c5 100644
--- a/ARCHITECTURE.md
+++ b/ARCHITECTURE.md
@@ -6,6 +6,7 @@ Last updated: 2026-03-11
 
 - Product identity, UX tone, copy rules, and prioritization tie-breakers live in `docs/brand-story.md`.
 - Future PRDs, TRDs, onboarding copy, empty states, error messages, and marketing copy should use that document as the single brand source of truth.
+- Failed YouTube import names Paste another YouTube link as the next action. Buyer-visible copy stays redacted and does not retry the network from the recovery card.
 
 ## Security source
 
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 0b6f7e784..3974db067 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,7 @@
 
 ### Added
 
+- When a YouTube link cannot be imported, the workspace names Paste another YouTube link as the next rehearsal action and keeps the failed URL ready to replace.
 - Name tonight's first playable range on the ready rehearsal map and tell the player to check that span on their instrument before the section.
 - Display the analyzed song tempo (BPM) as a badge in the rehearsal workspace.
 - 각 합주 역할(Role)별 개인 연습 진행도를 0~100% 범위로 기록 및 시각화할 수 있는 연습 진척도(`practiceProgress`) 트래커 기능 추가. UI 컨트롤(슬라이더 및 +/- 버튼)과 한/영 다국어 지원 포함.
diff --git a/CLAUDE.md b/CLAUDE.md
index b5a34c1fa..07f377f5e 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -6,7 +6,9 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 `AGENTS.md` is the canonical agent operating guide — read and follow it before making changes. It defines the security workflow (`Security Notes`), supply-chain workflow, cross-platform build rules, GitHub bootstrap rules, code style, and safety guardrails. This file complements it with commands and architecture; when in doubt, `AGENTS.md` and the docs it references win.
 
-Agent execution and delegation rules live in `docs/agents/README.md`. PR canonicalization rules live in `docs/workflow/pr-continuity.md`.
+When YouTube import fails, the workspace must name Paste another YouTube link as the next action. The recovery action only focuses the YouTube field.
+
+Agent execution and delegation rules live in `docs/agents/README.md`. PR continuity and duplicate-handling policy live in `docs/workflow/pr-continuity.md`.
 
 ## Common commands
 
diff --git a/apps/desktop/src/App.test.tsx b/apps/desktop/src/App.test.tsx
index 3eed386f8..5b7a48b24 100644
--- a/apps/desktop/src/App.test.tsx
+++ b/apps/desktop/src/App.test.tsx
@@ -1162,11 +1162,13 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      const alert = screen.getByRole("alert");
-      expect(alert).toHaveTextContent(/This video is age restricted/i);
-      expect(alert).toHaveAttribute("id", "selection-error");
+      const fieldError = document.getElementById("selection-error");
+      expect(fieldError).toHaveTextContent(/This video is age restricted/i);
+      expect(fieldError).toHaveAttribute("id", "selection-error");
       expect(input).toHaveAttribute("aria-invalid", "true");
-      expect(input).toHaveAttribute("aria-describedby", alert.id);
+      expect(input).toHaveAttribute("aria-describedby", "selection-error");
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy();
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
@@ -1182,7 +1184,8 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      expect(screen.getByText(/Network Error/i)).toBeTruthy();
+      expect(screen.getAllByText(/Network Error/i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
@@ -1197,7 +1200,8 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
@@ -1209,7 +1213,8 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
@@ -1221,7 +1226,8 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
@@ -1233,7 +1239,8 @@ describe("App", () => {
     fireEvent.click(screen.getByRole("button", { name: /Import YouTube/i }));
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
     expect(tauriInvoke).not.toHaveBeenCalled();
   });
@@ -1246,7 +1253,8 @@ describe("App", () => {
     fireEvent.click(screen.getByRole("button", { name: /Import YouTube/i }));
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
     expect(tauriInvoke).not.toHaveBeenCalled();
   });
@@ -1259,11 +1267,63 @@ describe("App", () => {
     fireEvent.click(screen.getByRole("button", { name: /Import YouTube/i }));
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
     expect(tauriInvoke).not.toHaveBeenCalled();
   });
 
+  it("focuses the YouTube field from the import-failure next action", async () => {
+    render(<App />);
+    const input = screen.getByRole("textbox", { name: /YouTube URL/i });
+    fireEvent.change(input, { target: { value: "not-a-url" } });
+    fireEvent.click(screen.getByRole("button", { name: /Import YouTube/i }));
+
+    await waitFor(() => {
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
+    });
+
+    fireEvent.click(screen.getByRole("button", { name: "Paste another YouTube link" }));
+
+    expect(document.activeElement).toBe(input);
+    expect(input).toHaveValue("not-a-url");
+  });
+
+  it("redacts URL-shaped YouTube import diagnostics before they become buyer copy", async () => {
+    tauriInvoke.mockRejectedValueOnce(
+      new Error("download failed: https://youtube.com/watch?v=secret-token")
+    );
+
+    render(<App />);
+    const input = screen.getByPlaceholderText(/YouTube URL.../i);
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: /Import YouTube/i }));
+
+    await waitFor(() => {
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy();
+    });
+    expect(document.getElementById("selection-error")?.textContent).toMatch(/download failed: \[link\]/i);
+    expect(screen.queryByText(/secret-token/i)).toBeNull();
+    expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
+  });
+
+  it("localizes the YouTube import-failure next action", async () => {
+    const languageSpy = vi.spyOn(window.navigator, "language", "get").mockReturnValue("ko-KR");
+
+    try {
+      render(<App />);
+      const input = screen.getByRole("textbox", { name: /유튜브 URL/i });
+      fireEvent.change(input, { target: { value: "not-a-url" } });
+      fireEvent.click(screen.getByRole("button", { name: /유튜브 가져오기/i }));
+      await waitFor(() => {
+        expect(screen.getByRole("heading", { name: "그 유튜브 링크로는 오늘 합주를 시작할 수 없습니다" })).toBeTruthy();
+      });
+      expect(screen.getByRole("button", { name: "다른 유튜브 링크 붙여넣기" })).toBeTruthy();
+    } finally {
+      languageSpy.mockRestore();
+    }
+  });
+
 
   it("loads a project and updates the UI", async () => {
     mockLoadProject.mockResolvedValueOnce(succeededResult().result);
@@ -1523,7 +1583,8 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
@@ -1548,7 +1609,8 @@ describe("App", () => {
     fireEvent.click(button);
 
     await waitFor(() => {
-      expect(screen.getByText(/Failed to import YouTube URL./i)).toBeTruthy();
+      expect(screen.getAllByText(/Failed to import YouTube URL./i).length).toBeGreaterThan(0);
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
     });
   });
 
diff --git a/apps/desktop/src/App.tsx b/apps/desktop/src/App.tsx
index f3d678454..2d7196d5d 100644
--- a/apps/desktop/src/App.tsx
+++ b/apps/desktop/src/App.tsx
@@ -388,6 +388,8 @@ export function App() {
   /** Documented. */
   const handleStartAnalysis = async () => {
     const submittedBootstrap = selectedBootstrap;
+    setSelectionError(null);
+    setSelectionErrorSource(null);
     setJobError(null);
     setJobResult(null);
     setJobResultBootstrap(null);
@@ -429,8 +431,21 @@ export function App() {
     setJobStatus(null);
   };
 
-  /** Documented. */
+  /**
+   * Import the current YouTube URL through BandScope's existing downloader boundary.
+   *
+   * Security Notes:
+   * - The URL field and bridge failure detail are untrusted input.
+   * - URL admission remains fail-closed through `isSupportedYoutubeUrl` before the downloader is invoked.
+   * - Buyer-visible failures pass through `safeErrorDetail`, which removes URL, local-path, and secret-shaped details.
+   * - The recovery action only focuses/selects the existing field; it never performs a second network request.
+   */
   const handleImportYoutube = async () => {
+    if (isImporting) {
+      return;
+    }
+
+    setJobError(null);
     setSelectionError(null);
     setSelectionErrorSource(null);
     const normalizedUrl = youtubeUrl.trim();
@@ -456,24 +471,43 @@ export function App() {
         setSelectionError(safeErrorDetail(selection.error.message, t("youtubeImportFailed")));
         setSelectionErrorSource("youtube");
       }
-    } catch {
-      setSelectionError(t("youtubeImportFailed"));
+    } catch (error) {
+      const fallback = t("youtubeImportFailed");
+      const detail = safeErrorDetail(error, fallback);
+      setSelectionError(detail === fallback ? fallback : `${fallback} ${detail}`);
       setSelectionErrorSource("youtube");
     } finally {
       setIsImporting(false);
     }
   };
 
+  /** Focus the YouTube field so the next paste replaces the failed link. */
+  const handlePasteAnotherYoutubeLink = () => {
+    youtubeInputRef.current?.focus();
+    youtubeInputRef.current?.select();
+  };
+
+  /** Clear only the YouTube-owned recovery state, preserving unrelated source errors. */
+  const dismissYoutubeSelectionError = () => {
+    if (selectionErrorSource === "youtube") {
+      setSelectionError(null);
+      setSelectionErrorSource(null);
+    }
+  };
+
   /** Documented. */
   const handleClearYoutubeUrl = () => {
     youtubeInputRef.current?.focus();
     setYoutubeUrl("");
+    dismissYoutubeSelectionError();
   };
 
   /** Documented. */
   const handleLoadProject = async () => {
     try {
       const song = await loadProject();
+      setSelectionError(null);
+      setSelectionErrorSource(null);
       setJobResult(song);
       setJobResultBootstrap(null);
       setJobError(null);
@@ -511,6 +545,18 @@ export function App() {
     if (analysisInFlight || isStarting) {
       return <LoadingState />;
     }
+    if (selectionError && selectionErrorSource === "youtube") {
+      return (
+        <ErrorState
+          error={selectionError}
+          title={t("youtubeImportFailureTitle")}
+          guidance={t("youtubeImportFailureGuidance")}
+          actionLabel={t("pasteAnotherYoutubeLink")}
+          onAction={handlePasteAnotherYoutubeLink}
+          actionDisabled={isImporting}
+        />
+      );
+    }
     if (jobResult) {
       return <Workspace song={jobResult} sourceBootstrap={jobResultBootstrap} onSongUpdate={handleSongUpdate} />;
     }
@@ -518,6 +564,7 @@ export function App() {
   };
 
   const currentView: RehearsalView = jobResult && activeView === "score" ? "score" : "workspace";
+  const youtubeRecoveryVisible = Boolean(selectionError && selectionErrorSource === "youtube");
 
   /** Resolve label, enablement, and active state for one sidebar item. */
   const navButtonState = (item: (typeof NAV_ITEMS)[number]) => {
@@ -701,7 +748,10 @@ export function App() {
                         placeholder={t("youtubePlaceholder")}
                         value={youtubeUrl}
                         maxLength={MAX_YOUTUBE_URL_LENGTH}
-                        onChange={(e) => setYoutubeUrl(e.target.value)}
+                        onChange={(e) => {
+                          setYoutubeUrl(e.target.value);
+                          dismissYoutubeSelectionError();
+                        }}
                         disabled={analysisInFlight || isStarting || isImporting}
                         className="h-10 w-full border-0 bg-transparent pr-9 text-slate-100 placeholder:text-slate-500 focus-visible:ring-cyan-300"
                         aria-label={t("youtubeUrlAriaLabel")}
@@ -737,7 +787,7 @@ export function App() {
               <div className="grid grid-cols-1 gap-2 sm:grid-cols-3 2xl:flex 2xl:flex-wrap 2xl:justify-end">
                 <Button
                   onClick={handleLoadProject}
-                  disabled={analysisInFlight || isStarting}
+                  disabled={analysisInFlight || isStarting || isImporting}
                   variant="outline"
                   className="min-h-11 border-white/10 bg-white/5 font-semibold text-slate-100 hover:bg-white/10 hover:text-white"
                   aria-label={t("openProject")}
@@ -825,7 +875,13 @@ export function App() {
                 )}
 
                 {selectionError && (
-                  <div id={selectionErrorSource === "youtube" ? "selection-error" : undefined} className="rounded-full border border-rose-300/25 bg-rose-400/10 px-3 py-1 font-semibold text-rose-100" role="alert" aria-live="assertive" aria-atomic="true">
+                  <div
+                    id={selectionErrorSource === "youtube" ? "selection-error" : undefined}
+                    className="rounded-full border border-rose-300/25 bg-rose-400/10 px-3 py-1 font-semibold text-rose-100"
+                    role={selectionErrorSource === "youtube" ? undefined : "alert"}
+                    aria-live={selectionErrorSource === "youtube" ? undefined : "assertive"}
+                    aria-atomic={selectionErrorSource === "youtube" ? undefined : "true"}
+                  >
                     {selectionError}
                   </div>
                 )}
@@ -842,7 +898,7 @@ export function App() {
           </header>
 
           <section className="animate-in fade-in duration-500 ease-out fill-mode-both">
-            {currentView === "score" && jobResult ? (
+            {currentView === "score" && jobResult && !youtubeRecoveryVisible ? (
               <ScoreView
                 song={jobResult}
                 projectId={jobResultBootstrap?.projectId ?? null}
diff --git a/apps/desktop/src/App.youtubeImportFailureVisibility.test.tsx b/apps/desktop/src/App.youtubeImportFailureVisibility.test.tsx
new file mode 100644
index 000000000..29344292c
--- /dev/null
+++ b/apps/desktop/src/App.youtubeImportFailureVisibility.test.tsx
@@ -0,0 +1,290 @@
+import { createDemoRehearsalSong, type ProjectBootstrapSummary } from "@bandscope/shared-types";
+import { fireEvent, render, screen, waitFor } from "@testing-library/react";
+import { beforeEach, describe, expect, it, vi } from "vitest";
+import { App } from "./App";
+import type { LocalAudioSelectionResult } from "./lib/analysis";
+
+const analysisMocks = vi.hoisted(() => ({
+  getAnalysisJobStatus: vi.fn(),
+  importYoutubeUrl: vi.fn(),
+  isSupportedYoutubeUrl: vi.fn(() => true),
+  loadProject: vi.fn(),
+  saveProject: vi.fn(),
+  selectLocalAudioSource: vi.fn(),
+  startAnalysisJob: vi.fn(),
+  subscribeToAnalysisJobUpdates: vi.fn(async () => () => undefined)
+}));
+
+vi.mock("./lib/analysis", () => ({
+  createDefaultAnalysisRequest: () => ({
+    sourceKind: "demo",
+    sourceLabel: "Late Night Set",
+    roleFocus: ["bass-guitar", "keys-right", "lead-vocal"]
+  }),
+  getAnalysisJobStatus: analysisMocks.getAnalysisJobStatus,
+  importYoutubeUrl: analysisMocks.importYoutubeUrl,
+  isSupportedYoutubeUrl: analysisMocks.isSupportedYoutubeUrl,
+  loadProject: analysisMocks.loadProject,
+  MAX_YOUTUBE_URL_LENGTH: 2048,
+  saveProject: analysisMocks.saveProject,
+  selectLocalAudioSource: analysisMocks.selectLocalAudioSource,
+  startAnalysisJob: analysisMocks.startAnalysisJob,
+  subscribeToAnalysisJobUpdates: analysisMocks.subscribeToAnalysisJobUpdates
+}));
+
+vi.mock("./features/score/ScoreView", () => ({
+  ScoreView: () => <div>Score view</div>
+}));
+
+const localBootstrap = {
+  projectId: "project-1",
+  sourceMode: "reference",
+  projectRoot: "/tmp/bandscope/projects/project-1",
+  cacheRoot: "/tmp/bandscope/cache/project-1",
+  tempRoot: "/tmp/bandscope/temp/project-1",
+  source: {
+    sourcePath: "/tmp/bandscope/song.wav",
+    fileName: "song.wav",
+    extension: "wav",
+    fileSizeBytes: 1024
+  }
+} satisfies ProjectBootstrapSummary;
+
+/**
+ * Security Notes:
+ * - Untrusted input: YouTube import failure copy, including URL-shaped diagnostics.
+ * - Trust boundary: mocked import bridge → buyer-visible recovery card.
+ * - Safe failure: the named action only focuses the YouTube field; it does not retry the network.
+ * - Privacy: live URLs and local paths must not appear in the recovery heading or action label.
+ */
+describe("App YouTube import failure visibility", () => {
+  beforeEach(() => {
+    for (const mock of Object.values(analysisMocks)) {
+      mock.mockReset();
+    }
+    analysisMocks.isSupportedYoutubeUrl.mockReturnValue(true);
+    analysisMocks.subscribeToAnalysisJobUpdates.mockResolvedValue(() => undefined);
+    analysisMocks.loadProject.mockResolvedValue(createDemoRehearsalSong());
+    analysisMocks.importYoutubeUrl.mockResolvedValue({
+      ok: false,
+      error: {
+        code: "invalid_request",
+        message: "This video is age restricted."
+      }
+    });
+  });
+
+  it("surfaces YouTube import failure even when a rehearsal result is already loaded", async () => {
+    render(<App />);
+
+    fireEvent.click(screen.getByRole("button", { name: "Open Project" }));
+    await waitFor(() => expect(screen.getByText("Late Night Set")).toBeTruthy());
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+
+    await waitFor(() => {
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy();
+      expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
+    });
+    expect(screen.getAllByText(/This video is age restricted/i).length).toBeGreaterThan(0);
+    expect(screen.queryByText(/https:\/\/youtube\.com/i)).toBeNull();
+  });
+
+  it("surfaces recovery over score view and restores score after clearing the failed URL", async () => {
+    render(<App />);
+
+    fireEvent.click(screen.getByRole("button", { name: "Open Project" }));
+    await waitFor(() => expect(screen.getByText("Late Night Set")).toBeTruthy());
+    fireEvent.click(screen.getByRole("button", { name: "Score" }));
+    expect(screen.getByText("Score view")).toBeTruthy();
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+    expect(screen.queryByText("Score view")).toBeNull();
+
+    fireEvent.click(screen.getByRole("button", { name: "Clear YouTube URL" }));
+
+    expect(input).toHaveProperty("value", "");
+    expect(input.getAttribute("aria-invalid")).toBeNull();
+    expect(screen.queryByRole("heading", { name: "That YouTube link can't start tonight" })).toBeNull();
+    expect(screen.getByText("Score view")).toBeTruthy();
+  });
+
+  it("dismisses loaded-workspace recovery when the failed URL is edited", async () => {
+    render(<App />);
+
+    fireEvent.click(screen.getByRole("button", { name: "Open Project" }));
+    await waitFor(() => expect(screen.getByText("Late Night Set")).toBeTruthy());
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=next123DEF45" } });
+
+    expect(input.getAttribute("aria-invalid")).toBeNull();
+    expect(screen.queryByRole("heading", { name: "That YouTube link can't start tonight" })).toBeNull();
+    expect(screen.getByText("Late Night Set")).toBeTruthy();
+  });
+
+  it("clears stale YouTube recovery after a project opens successfully", async () => {
+    render(<App />);
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+
+    fireEvent.click(screen.getByRole("button", { name: "Open Project" }));
+
+    await waitFor(() => expect(screen.getByText("Late Night Set")).toBeTruthy());
+    expect(screen.queryByRole("heading", { name: "That YouTube link can't start tonight" })).toBeNull();
+  });
+
+  it("clears stale YouTube recovery when analysis starts from an admitted local source", async () => {
+    analysisMocks.selectLocalAudioSource.mockResolvedValue({ ok: true, bootstrap: localBootstrap });
+    analysisMocks.startAnalysisJob.mockResolvedValue({
+      jobId: "job-1",
+      state: "succeeded",
+      requestedAt: "2026-08-22T00:00:00.000Z",
+      updatedAt: "2026-08-22T00:00:01.000Z",
+      progressLabel: "Analysis ready",
+      result: createDemoRehearsalSong()
+    });
+    render(<App />);
+
+    fireEvent.click(screen.getByRole("button", { name: "Choose local audio" }));
+    await waitFor(() => expect(analysisMocks.selectLocalAudioSource).toHaveBeenCalledTimes(1));
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+
+    fireEvent.click(screen.getByRole("button", { name: "Start analysis" }));
+
+    await waitFor(() => expect(analysisMocks.startAnalysisJob).toHaveBeenCalledTimes(1));
+    expect(screen.getByText("Late Night Set")).toBeTruthy();
+    expect(screen.queryByRole("heading", { name: "That YouTube link can't start tonight" })).toBeNull();
+  });
+
+  it("announces a YouTube failure through one assertive alert while keeping field description", async () => {
+    render(<App />);
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+    expect(screen.getAllByRole("alert")).toHaveLength(1);
+    expect(screen.getByRole("alert").textContent).toContain("This video is age restricted.");
+    expect(input.getAttribute("aria-describedby")).toBe("selection-error");
+    expect(document.getElementById("selection-error")?.textContent).toContain("This video is age restricted.");
+  });
+
+  it("keeps a redacted thrown import detail instead of replacing it with a generic message", async () => {
+    analysisMocks.importYoutubeUrl.mockRejectedValueOnce(
+      new Error("download failed: https://youtube.com/watch?v=secret-token")
+    );
+    render(<App />);
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+    expect(document.getElementById("selection-error")?.textContent).toContain("download failed: [link]");
+    expect(document.getElementById("selection-error")?.textContent).not.toContain("secret-token");
+  });
+
+  it("does not start a second YouTube import while the first request is pending", async () => {
+    let releaseImport!: (value: LocalAudioSelectionResult) => void;
+    analysisMocks.importYoutubeUrl.mockImplementationOnce(
+      () =>
+        new Promise<LocalAudioSelectionResult>((resolve) => {
+          releaseImport = resolve;
+        })
+    );
+    render(<App />);
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    const importButton = screen.getByRole("button", { name: "Import YouTube" });
+    fireEvent.click(importButton);
+    fireEvent.click(importButton);
+
+    await waitFor(() => expect(analysisMocks.importYoutubeUrl).toHaveBeenCalledTimes(1));
+    expect(importButton).toHaveProperty("disabled", true);
+
+    releaseImport({
+      ok: false,
+      error: { code: "invalid_request", message: "This video is age restricted." }
+    });
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+  });
+
+  it("disables project opening while a YouTube import request is pending", async () => {
+    let releaseImport!: (value: LocalAudioSelectionResult) => void;
+    analysisMocks.importYoutubeUrl.mockImplementationOnce(
+      () =>
+        new Promise<LocalAudioSelectionResult>((resolve) => {
+          releaseImport = resolve;
+        })
+    );
+    render(<App />);
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+
+    const openProjectButton = screen.getByRole("button", { name: "Open Project" });
+    await waitFor(() => expect(openProjectButton).toHaveProperty("disabled", true));
+    fireEvent.click(openProjectButton);
+    expect(analysisMocks.loadProject).not.toHaveBeenCalled();
+
+    releaseImport({
+      ok: false,
+      error: { code: "invalid_request", message: "This video is age restricted." }
+    });
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+  });
+
+  it("shows YouTube recovery instead of a stale project error after a new import fails", async () => {
+    analysisMocks.loadProject.mockRejectedValueOnce(new Error("broken project"));
+    render(<App />);
+
+    fireEvent.click(screen.getByRole("button", { name: "Open Project" }));
+    await waitFor(() => expect(screen.getByRole("alert").textContent).toContain("broken project"));
+
+    const input = screen.getByRole("textbox", { name: "YouTube URL" });
+    fireEvent.change(input, { target: { value: "https://youtube.com/watch?v=abc123DEF45" } });
+    fireEvent.click(screen.getByRole("button", { name: "Import YouTube" }));
+
+    await waitFor(() =>
+      expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy()
+    );
+    expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
+  });
+});
diff --git a/apps/desktop/src/features/workspace/WorkspaceStates.test.tsx b/apps/desktop/src/features/workspace/WorkspaceStates.test.tsx
new file mode 100644
index 000000000..d9be965de
--- /dev/null
+++ b/apps/desktop/src/features/workspace/WorkspaceStates.test.tsx
@@ -0,0 +1,99 @@
+import { fireEvent, render, screen } from "@testing-library/react";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import { EmptyState, ErrorState, LoadingState } from "./WorkspaceStates";
+
+const originalLanguage = window.navigator.language;
+
+function setNavigatorLanguage(language: string) {
+  Object.defineProperty(window.navigator, "language", {
+    configurable: true,
+    value: language
+  });
+}
+
+/**
+ * Security Notes:
+ * - Untrusted input: YouTube import failure copy rendered into the recovery card.
+ * - Trust boundary: workspace error card → named next action; no URL, path, or network access.
+ * - Safe failure: the action only focuses the existing YouTube field.
+ * - Privacy: tests use canned copy and never pass live URLs into the card body.
+ */
+describe("WorkspaceStates YouTube import failure", () => {
+  afterEach(() => {
+    setNavigatorLanguage(originalLanguage);
+  });
+
+  it("names pasting another YouTube link as the next rehearsal action", () => {
+    const onAction = vi.fn();
+    render(
+      <ErrorState
+        title="That YouTube link can't start tonight"
+        guidance="Paste a standard YouTube watch, Shorts, or youtu.be link. After import, BandScope keeps the audio on this device."
+        actionLabel="Paste another YouTube link"
+        onAction={onAction}
+      />
+    );
+
+    fireEvent.click(screen.getByRole("button", { name: "Paste another YouTube link" }));
+
+    expect(onAction).toHaveBeenCalledTimes(1);
+    expect(screen.getByRole("heading", { name: "That YouTube link can't start tonight" })).toBeTruthy();
+    expect(screen.getByText(/keeps the audio on this device/i)).toBeTruthy();
+  });
+
+  it("keeps the recovery action outside the assertive alert region", () => {
+    render(
+      <ErrorState
+        error="This video is age restricted."
+        title="That YouTube link can't start tonight"
+        guidance="Paste another supported link."
+        actionLabel="Paste another YouTube link"
+        onAction={vi.fn()}
+      />
+    );
+
+    const alert = screen.getByRole("alert");
+    expect(alert.textContent).toContain("This video is age restricted.");
+    expect(alert.querySelector("button")).toBeNull();
+    expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeTruthy();
+  });
+
+  it("disables the next action while import is already running", () => {
+    const onAction = vi.fn();
+    render(
+      <ErrorState
+        title="That YouTube link can't start tonight"
+        actionLabel="Paste another YouTube link"
+        onAction={onAction}
+        actionDisabled
+      />
+    );
+
+    expect(screen.getByRole("button", { name: "Paste another YouTube link" })).toBeDisabled();
+    fireEvent.click(screen.getByRole("button", { name: "Paste another YouTube link" }));
+    expect(onAction).not.toHaveBeenCalled();
+  });
+
+  it("keeps analysis failures message-only when no recovery action is provided", () => {
+    render(<ErrorState error="engine unavailable" />);
+
+    expect(screen.getByRole("heading", { name: "An error occurred during analysis. Please try again." })).toBeTruthy();
+    expect(screen.queryByRole("button", { name: /paste another youtube link/i })).toBeNull();
+  });
+
+  it("localizes empty, loading, and YouTube-import-failure titles", () => {
+    setNavigatorLanguage("ko-KR");
+    render(
+      <>
+        <EmptyState />
+        <LoadingState />
+        <ErrorState title="그 유튜브 링크로는 오늘 합주를 시작할 수 없습니다" actionLabel="다른 유튜브 링크 붙여넣기" onAction={vi.fn()} />
+      </>
+    );
+
+    expect(screen.getByRole("heading", { name: "분석 준비 완료" })).toBeTruthy();
+    expect(screen.getByRole("heading", { name: "오디오 분석 중" })).toBeTruthy();
+    expect(screen.getByRole("heading", { name: "그 유튜브 링크로는 오늘 합주를 시작할 수 없습니다" })).toBeTruthy();
+    expect(screen.getByRole("button", { name: "다른 유튜브 링크 붙여넣기" })).toBeTruthy();
+  });
+});
diff --git a/apps/desktop/src/features/workspace/WorkspaceStates.tsx b/apps/desktop/src/features/workspace/WorkspaceStates.tsx
index 8f9aba1b1..600469ddf 100644
--- a/apps/desktop/src/features/workspace/WorkspaceStates.tsx
+++ b/apps/desktop/src/features/workspace/WorkspaceStates.tsx
@@ -1,6 +1,7 @@
 import { createTranslator, detectPreferredLocale } from "../../i18n";
+import { Button } from "@/components/ui/button";
 import { Card, CardContent } from "@/components/ui/card";
-import { Loader2, Music, AlertCircle } from "lucide-react";
+import { Loader2, Music, AlertCircle, Link2 } from "lucide-react";
 
 /** Documented. */
 export function EmptyState() {
@@ -38,17 +39,49 @@ export function LoadingState() {
   );
 }
 
-/** Documented. */
-export function ErrorState({ error }: { error?: string }) {
+/** Recovery action for a workspace error that still has a next rehearsal step. */
+export interface ErrorStateProps {
+  error?: string;
+  title?: string;
+  guidance?: string;
+  actionLabel?: string;
+  onAction?: () => void;
+  actionDisabled?: boolean;
+}
+
+/** Render a workspace failure and name the next rehearsal action when one exists. */
+export function ErrorState({
+  error,
+  title,
+  guidance,
+  actionLabel,
+  onAction,
+  actionDisabled = false
+}: ErrorStateProps) {
   const t = createTranslator(detectPreferredLocale());
   return (
-    <Card className="border-rose-300/30 bg-rose-950/40 shadow-[0_18px_70px_rgba(0,0,0,0.25)] backdrop-blur-xl" role="alert" aria-live="assertive" aria-atomic="true">
+    <Card className="border-rose-300/30 bg-rose-950/40 shadow-[0_18px_70px_rgba(0,0,0,0.25)] backdrop-blur-xl">
       <CardContent className="flex flex-col items-center justify-center py-20 text-center">
-        <div className="mb-4 rounded-full border border-rose-300/30 bg-rose-300/10 p-4 text-rose-200 shadow-sm">
-          <AlertCircle className="size-8" aria-hidden="true" />
+        <div role="alert" aria-live="assertive" aria-atomic="true" className="flex flex-col items-center">
+          <div className="mb-4 rounded-full border border-rose-300/30 bg-rose-300/10 p-4 text-rose-200 shadow-sm">
+            <AlertCircle className="size-8" aria-hidden="true" />
+          </div>
+          <h3 className="mb-2 text-lg font-black text-rose-100">{title ?? t("workspaceErrorState")}</h3>
+          {error && <p className="mt-2 rounded-md bg-rose-300/10 px-4 py-2 text-sm font-medium text-rose-100">{error}</p>}
+          {guidance && <p className="mt-3 max-w-md text-sm text-rose-100/80">{guidance}</p>}
         </div>
-        <h3 className="mb-2 text-lg font-black text-rose-100">{t("workspaceErrorState")}</h3>
-        {error && <p className="mt-2 rounded-md bg-rose-300/10 px-4 py-2 text-sm font-medium text-rose-100">{error}</p>}
+        {onAction && actionLabel && (
+          <Button
+            type="button"
+            onClick={onAction}
+            disabled={actionDisabled}
+            className="mt-8 min-h-11 bg-gradient-to-r from-cyan-400 to-violet-500 font-black text-slate-950 shadow-[0_14px_38px_rgba(34,211,238,0.28)] hover:from-cyan-300 hover:to-violet-400"
+            aria-label={actionLabel}
+          >
+            <Link2 className="mr-2 size-4" aria-hidden="true" />
+            {actionLabel}
+          </Button>
+        )}
       </CardContent>
     </Card>
   );
diff --git a/apps/desktop/src/locales/en/common.json b/apps/desktop/src/locales/en/common.json
index d803a765e..72c7b322b 100644
--- a/apps/desktop/src/locales/en/common.json
+++ b/apps/desktop/src/locales/en/common.json
@@ -93,6 +93,9 @@
   "importYoutube": "Import YouTube",
   "importingYoutube": "Importing...",
   "youtubeImportFailed": "Failed to import YouTube URL.",
+  "youtubeImportFailureTitle": "That YouTube link can't start tonight",
+  "youtubeImportFailureGuidance": "Paste a standard YouTube watch, Shorts, or youtu.be link. After import, BandScope keeps the audio on this device.",
+  "pasteAnotherYoutubeLink": "Paste another YouTube link",
   "brandMarkAriaLabel": "BandScope circular equalizer mark",
   "rehearsalCockpit": "Rehearsal cockpit",
   "navWorkspace": "Workspace",
diff --git a/apps/desktop/src/locales/ko/common.json b/apps/desktop/src/locales/ko/common.json
index 0f6c6c66d..2206216bd 100644
--- a/apps/desktop/src/locales/ko/common.json
+++ b/apps/desktop/src/locales/ko/common.json
@@ -93,6 +93,9 @@
   "importYoutube": "유튜브 가져오기",
   "importingYoutube": "가져오는 중...",
   "youtubeImportFailed": "유튜브 URL 가져오기에 실패했습니다.",
+  "youtubeImportFailureTitle": "그 유튜브 링크로는 오늘 합주를 시작할 수 없습니다",
+  "youtubeImportFailureGuidance": "표준 YouTube watch, Shorts 또는 youtu.be 링크를 붙여넣으세요. 가져온 뒤에는 오디오가 이 기기에만 남습니다.",
+  "pasteAnotherYoutubeLink": "다른 유튜브 링크 붙여넣기",
   "brandMarkAriaLabel": "BandScope 원형 이퀄라이저 마크",
   "rehearsalCockpit": "합주 컨트롤룸",
   "navWorkspace": "작업 공간",