From 5065ea8e60a32c104699a5428622662e028e997c Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 12 Mar 2026 01:40:06 +0000
Subject: [PATCH 1/4] Initial plan


From b8a551bffeca9baa357f931fad876fcb8c7971b0 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Thu, 12 Mar 2026 01:52:11 +0000
Subject: [PATCH 2/4] feat: add context descriptions to prompt selection screen

- Improve PromptSelectionDialog confirm view title and description to
  explain what prompts are and what happens when confirmed
- Improve PromptSelectionDialog select view title and description to
  clarify prompt purpose and local vs portal distinction
- Replace plain-text source indicators with Badge components for
  clearer visual communication in both dialog views
- Update CustomPromptManager description to explain the active prompt
  role and that it can be overridden at runtime

Co-authored-by: tomek-i <3699937+tomek-i@users.noreply.github.com>
---
 .../custom-prompt/CustomPromptManager.tsx     |  3 +-
 .../workflow/PromptSelectionDialog.tsx        | 47 +++++++++++--------
 2 files changed, 29 insertions(+), 21 deletions(-)

diff --git a/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx b/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx
index 444166a6..e9a6fc3d 100644
--- a/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx
+++ b/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx
@@ -231,7 +231,8 @@ export function CustomPromptSettingsPanel({
         <header className="flex flex-col gap-1">
           <h2 className="text-xl font-semibold">Custom Prompt Manager</h2>
           <p className="text-muted-foreground text-sm">
-            Manage your saved prompts and choose which one YakShaver should use.
+            Manage your prompt templates. The active prompt is the default template YakShaver uses
+            when writing GitHub issues from your recordings — you can always override it at runtime.
           </p>
         </header>
         <ScrollArea className="flex-1">
diff --git a/src/ui/src/components/workflow/PromptSelectionDialog.tsx b/src/ui/src/components/workflow/PromptSelectionDialog.tsx
index 75358f10..f96bafa0 100644
--- a/src/ui/src/components/workflow/PromptSelectionDialog.tsx
+++ b/src/ui/src/components/workflow/PromptSelectionDialog.tsx
@@ -12,6 +12,7 @@ import {
   AlertDialogHeader,
   AlertDialogTitle,
 } from "../ui/alert-dialog";
+import { Badge } from "../ui/badge";
 import { Button } from "../ui/button";
 import { Input } from "../ui/input";
 import { ScrollArea } from "../ui/scroll-area";
@@ -131,20 +132,21 @@ export function PromptSelectionDialog({
         {view === "confirm" ? (
           <>
             <AlertDialogHeader>
-              <AlertDialogTitle>Confirm Project Prompt Selection</AlertDialogTitle>
+              <AlertDialogTitle>Confirm Prompt Selection</AlertDialogTitle>
               <AlertDialogDescription>
-                YakShaver has selected a Project prompt for this video. Do you want to proceed with
-                this prompt?
+                YakShaver analysed your video and selected the most relevant prompt template below.
+                Prompts control how your GitHub issue is written — confirm to proceed, or switch to
+                a different one.
               </AlertDialogDescription>
             </AlertDialogHeader>
 
             <div className="bg-secondary/20 p-4 rounded-md space-y-2 mt-2">
-              <h3 className="font-medium text-lg text-primary">
-                {initialProject.name}{" "}
-                <span className="text-secondary-foreground/60 text-sm font-normal">
-                  ({initialProject.source === "local" ? "local prompt" : "portal prompt"})
-                </span>
-              </h3>
+              <div className="flex items-center gap-2 flex-wrap">
+                <h3 className="font-medium text-lg text-primary">{initialProject.name}</h3>
+                <Badge variant="outline">
+                  {initialProject.source === "local" ? "local" : "portal"}
+                </Badge>
+              </div>
               {initialProject.description && (
                 <p className="text-sm text-muted-foreground">{initialProject.description}</p>
               )}
@@ -194,9 +196,13 @@ export function PromptSelectionDialog({
         ) : (
           <>
             <AlertDialogHeader>
-              <AlertDialogTitle>Select a Prompt for your project</AlertDialogTitle>
+              <AlertDialogTitle>Select a Prompt</AlertDialogTitle>
               <AlertDialogDescription>
-                Search and select the correct prompt for this video.
+                Prompts are templates that control how YakShaver writes your GitHub issue. Select
+                the one that best fits your project.{" "}
+                <span className="text-foreground/60">
+                  Local prompts are saved on your device; portal prompts are synced from SSW Portal.
+                </span>
               </AlertDialogDescription>
             </AlertDialogHeader>
 
@@ -230,17 +236,18 @@ export function PromptSelectionDialog({
                         }`}
                         onClick={() => setTempSelectedProjectId(project.id)}
                       >
-                        <div className="font-medium">
-                          {project.name}{" "}
-                          <span
-                            className={`text-xs font-normal ${
+                        <div className="flex items-center gap-2 flex-wrap">
+                          <span className="font-medium">{project.name}</span>
+                          <Badge
+                            variant="outline"
+                            className={
                               tempSelectedProjectId === project.id
-                                ? "text-primary-foreground/80"
-                                : "text-muted-foreground"
-                            }`}
+                                ? "border-primary-foreground/40 text-primary-foreground/80"
+                                : undefined
+                            }
                           >
-                            ({project.source === "local" ? "local prompt" : "portal prompt"})
-                          </span>
+                            {project.source === "local" ? "local" : "portal"}
+                          </Badge>
                         </div>
                         {project.description && (
                           <div

From 3a1d6c1180ce1c4d438859122088b102b38e1851 Mon Sep 17 00:00:00 2001
From: Thomas Iwainski <Tomek.iwainski@gmail.com>
Date: Thu, 12 Mar 2026 16:53:09 +1100
Subject: [PATCH 3/4] Apply suggestions from code review

Co-authored-by: Thomas Iwainski <Tomek.iwainski@gmail.com>
---
 .../settings/custom-prompt/CustomPromptManager.tsx          | 2 +-
 src/ui/src/components/workflow/PromptSelectionDialog.tsx    | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx b/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx
index e9a6fc3d..c1e6c7b4 100644
--- a/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx
+++ b/src/ui/src/components/settings/custom-prompt/CustomPromptManager.tsx
@@ -232,7 +232,7 @@ export function CustomPromptSettingsPanel({
           <h2 className="text-xl font-semibold">Custom Prompt Manager</h2>
           <p className="text-muted-foreground text-sm">
             Manage your prompt templates. The active prompt is the default template YakShaver uses
-            when writing GitHub issues from your recordings — you can always override it at runtime.
+            when writing issues from your recordings.
           </p>
         </header>
         <ScrollArea className="flex-1">
diff --git a/src/ui/src/components/workflow/PromptSelectionDialog.tsx b/src/ui/src/components/workflow/PromptSelectionDialog.tsx
index f96bafa0..a6958c20 100644
--- a/src/ui/src/components/workflow/PromptSelectionDialog.tsx
+++ b/src/ui/src/components/workflow/PromptSelectionDialog.tsx
@@ -135,7 +135,7 @@ export function PromptSelectionDialog({
               <AlertDialogTitle>Confirm Prompt Selection</AlertDialogTitle>
               <AlertDialogDescription>
                 YakShaver analysed your video and selected the most relevant prompt template below.
-                Prompts control how your GitHub issue is written — confirm to proceed, or switch to
+                Prompts control how your issue is written — confirm to proceed, or switch to
                 a different one.
               </AlertDialogDescription>
             </AlertDialogHeader>
@@ -198,10 +198,10 @@ export function PromptSelectionDialog({
             <AlertDialogHeader>
               <AlertDialogTitle>Select a Prompt</AlertDialogTitle>
               <AlertDialogDescription>
-                Prompts are templates that control how YakShaver writes your GitHub issue. Select
+                Prompts are templates that control how YakShaver writes your issue. Select
                 the one that best fits your project.{" "}
                 <span className="text-foreground/60">
-                  Local prompts are saved on your device; portal prompts are synced from SSW Portal.
+                  Local prompts are saved on your device; portal prompts are synced from YakShaver Portal.
                 </span>
               </AlertDialogDescription>
             </AlertDialogHeader>

From b1fa26eebd31abef2fa23fc3a00531abc5299552 Mon Sep 17 00:00:00 2001
From: Tom Iwainski <tomiwainski@ssw.com.au>
Date: Thu, 12 Mar 2026 16:55:42 +1100
Subject: [PATCH 4/4] Update PromptSelectionDialog.tsx

---
 .../src/components/workflow/PromptSelectionDialog.tsx | 11 ++++++-----
 1 file changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/ui/src/components/workflow/PromptSelectionDialog.tsx b/src/ui/src/components/workflow/PromptSelectionDialog.tsx
index a6958c20..c21a5723 100644
--- a/src/ui/src/components/workflow/PromptSelectionDialog.tsx
+++ b/src/ui/src/components/workflow/PromptSelectionDialog.tsx
@@ -135,8 +135,8 @@ export function PromptSelectionDialog({
               <AlertDialogTitle>Confirm Prompt Selection</AlertDialogTitle>
               <AlertDialogDescription>
                 YakShaver analysed your video and selected the most relevant prompt template below.
-                Prompts control how your issue is written — confirm to proceed, or switch to
-                a different one.
+                Prompts control how your issue is written — confirm to proceed, or switch to a
+                different one.
               </AlertDialogDescription>
             </AlertDialogHeader>
 
@@ -198,10 +198,11 @@ export function PromptSelectionDialog({
             <AlertDialogHeader>
               <AlertDialogTitle>Select a Prompt</AlertDialogTitle>
               <AlertDialogDescription>
-                Prompts are templates that control how YakShaver writes your issue. Select
-                the one that best fits your project.{" "}
+                Prompts are templates that control how YakShaver writes your issue. Select the one
+                that best fits your project.{" "}
                 <span className="text-foreground/60">
-                  Local prompts are saved on your device; portal prompts are synced from YakShaver Portal.
+                  Local prompts are saved on your device; portal prompts are synced from YakShaver
+                  Portal.
                 </span>
               </AlertDialogDescription>
             </AlertDialogHeader>