feat(panel): dense tooltip pass — work surfaces (270 tips)

Task lifecycle actions get a 25-action tip map, every dialog field and
git panel control annotated; fixes two round-1 disabled-button tips
that could never fire and a double data-state stamp on tab-progress.

panel/src/app/(dashboard)/prompter/page.tsx

@@ -3,6 +3,7 @@
 import { useEffect, useRef } from "react";
 import { Loader2, Sparkles, X } from "lucide-react";
 import { Button } from "@/components/ui/button";
+import { HelpTip } from "@/components/ui/help-tip";
 import { usePrompter } from "@/hooks/use-prompter";
 import { Team } from "@/types";
 import {
@@ -77,16 +78,25 @@ export default function PrompterPage() {
         </div>
         {/* End chat — reap the agent and return to the form (any chat state) */}
         {!showForm && state !== "success" && (
+          <HelpTip label="Stops the agent session and clears this chat — you'll return to the intake form">
+            {/* disabled sets pointer-events:none on the Button, which would
+                swallow hover — the tip sits on a wrapping span instead. */}
+            <span
+              className="ml-auto"
+              tabIndex={state === "launching" ? undefined : 0}
+            >
               <Button
                 variant="ghost"
                 size="sm"
-            className="ml-auto text-muted-foreground"
+                className="text-muted-foreground"
                 onClick={startAnother}
                 disabled={state === "launching"}
               >
                 <X className="mr-1 h-4 w-4" />
                 End chat
               </Button>
+            </span>
+          </HelpTip>
         )}
       </div>
 

panel/src/app/(dashboard)/tasks/[taskId]/page.tsx

@@ -29,6 +29,7 @@ import { AlertTriangle, ArrowLeft } from "lucide-react";
 import Link from "next/link";
 import { useRouter } from "next/navigation";
 import { toast } from "sonner";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface TaskDetailPageProps {
   params: Promise<{ taskId: string }>;
@@ -415,12 +416,14 @@ export default function TaskDetailPage({ params }: TaskDetailPageProps) {
   if (error || !task) {
     return (
       <div className="space-y-6">
+        <HelpTip label="Returns to the task list, preserving whatever filters/sort/page you had set there.">
           <Link href="/tasks" prefetch={false}>
             <Button variant="ghost" size="sm">
               <ArrowLeft className="h-4 w-4 mr-2" />
               Back to Tasks
             </Button>
           </Link>
+        </HelpTip>
 
         <Card>
           <CardContent className="pt-6">
@@ -432,9 +435,11 @@ export default function TaskDetailPage({ params }: TaskDetailPageProps) {
                   "The task you're looking for doesn't exist or has been deleted."}
               </p>
               <div className="flex justify-center gap-4">
+                <HelpTip label="Leaves this not-found error and returns to the full task list.">
                   <Link href="/tasks" prefetch={false}>
                     <Button>View All Tasks</Button>
                   </Link>
+                </HelpTip>
               </div>
             </div>
           </CardContent>
@@ -474,12 +479,14 @@ export default function TaskDetailPage({ params }: TaskDetailPageProps) {
         task.team !== Team.MAIN_PM && (
           <div className="flex justify-end gap-2">
             {task.team === Team.BOARD && (
+              <HelpTip label="Re-opens the intake chat, threading in the board's review notes so the draft can be revised.">
                 <Button
                   variant="outline"
                   onClick={() => router.push(`/prompter?redraft=${task.id}`)}
                 >
                   Re-draft with board feedback
                 </Button>
+              </HelpTip>
             )}
             <ApproveAndStartButton task={task} />
           </div>

panel/src/app/(dashboard)/tasks/page.tsx

@@ -18,6 +18,7 @@ import type { TaskFilters as TaskApiFilters } from "@/lib/api/tasks";
 import { Skeleton } from "@/components/ui/skeleton";
 import { usePageRefresh } from "@/hooks";
 import { useScrollRestorationStore } from "@/lib/stores";
+import { HelpTip } from "@/components/ui/help-tip";
 
 function TasksPageContent() {
   const router = useRouter();
@@ -304,9 +305,11 @@ function TasksPageContent() {
       <div className="flex items-center justify-between">
         <div>
           <h1 className="text-3xl font-bold tracking-tight">Tasks</h1>
+          <HelpTip label="Filters, sort, and pagination all persist in the URL — this view is bookmarkable and shareable.">
             <p className="text-muted-foreground">
               Manage and track all tasks across teams
             </p>
+          </HelpTip>
         </div>
         <div className="flex items-center gap-2">
           <CreateTaskDialog />

panel/src/components/git/__tests__/code-snippet.test.tsx

@@ -71,6 +71,9 @@ describe("CodeSnippet", () => {
     // The active line's content is "b"; its row carries the highlight class.
     const row = screen.getByText("b").parentElement;
     expect(row?.className).toContain("bg-blue-500/15");
+    // The active line's number is now a real HelpTip trigger (Radix injects
+    // data-state via asChild), not a bare span.
+    expect(screen.getByText("2").getAttribute("data-state")).toBe("closed");
   });
 
   it("renders the fail-open hint on an error", () => {

panel/src/components/git/code-snippet.tsx

@@ -4,6 +4,7 @@ import { useGitFile } from "@/hooks/use-git";
 import { Skeleton } from "@/components/ui/skeleton";
 import { ScrollArea } from "@/components/ui/scroll-area";
 import { cn } from "@/lib/utils";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface CodeSnippetProps {
   branch: string | null | undefined;
@@ -64,9 +65,11 @@ export function CodeSnippet({
                     "bg-blue-500/15 ring-1 ring-inset ring-blue-500/30",
                 )}
               >
+                <HelpTip label={isActive ? "The line flagged in this finding" : ""}>
                   <span className="select-none w-8 shrink-0 text-right text-muted-foreground/60">
                     {lineNo}
                   </span>
+                </HelpTip>
                 <span className="whitespace-pre">{text || " "}</span>
               </div>
             );
@@ -74,10 +77,12 @@ export function CodeSnippet({
         </pre>
       </ScrollArea>
       {data.truncated && (
-        <p className="border-t px-2 py-1 text-[10px] text-muted-foreground">
+        <HelpTip label="Only a window around the flagged line is loaded, not the whole file — widen `context` to see more.">
-          showing lines {data.start_line}–{data.start_line + lines.length - 1}{" "}
+          <p className="border-t px-2 py-1 text-[10px] text-muted-foreground w-fit">
-          of {data.total_lines}
+            showing lines {data.start_line}–
+            {data.start_line + lines.length - 1} of {data.total_lines}
           </p>
+        </HelpTip>
       )}
     </div>
   );

panel/src/components/git/git-actions-panel.tsx

@@ -149,6 +149,23 @@ export function GitActionsPanel({
         <Dialog
           open={showCommitDialog}
           onOpenChange={handleCommitDialogOpenChange}
+        >
+          {/* HelpTip+span wraps the whole DialogTrigger, not the Button
+              itself — the Button stays DialogTrigger's asChild target so
+              Radix's Slot merge is undisturbed, and the outer span keeps the
+              tip hoverable even while disabled (disabled sets
+              pointer-events:none on the button, which would swallow hover on
+              anything nested inside it). */}
+          <HelpTip
+            label={
+              hasStagedChanges
+                ? "Records the staged files as a local commit — doesn't push to the remote."
+                : "Nothing staged yet — stage files first before a commit can be made."
+            }
+          >
+            <span
+              className="block w-full"
+              tabIndex={!hasStagedChanges ? 0 : undefined}
             >
               <DialogTrigger asChild>
                 <Button
@@ -165,13 +182,19 @@ export function GitActionsPanel({
                   )}
                 </Button>
               </DialogTrigger>
+            </span>
+          </HelpTip>
           <DialogContent>
             <DialogHeader>
               <DialogTitle>Commit Changes</DialogTitle>
             </DialogHeader>
             <div className="space-y-4 py-4">
               <div className="space-y-2">
-                <label className="text-sm font-medium">Commit Message</label>
+                <HelpTip label="Becomes the commit's message — shows up in the log panel and the PR's commit history.">
+                  <label className="text-sm font-medium w-fit">
+                    Commit Message
+                  </label>
+                </HelpTip>
                 <Textarea
                   placeholder="Describe your changes..."
                   value={commitMessage}
@@ -216,6 +239,17 @@ export function GitActionsPanel({
         </Dialog>
 
         {/* Push Action */}
+        <HelpTip
+          label={
+            canPush
+              ? "git push -u origin <branch>. Uploads your local commits to GitHub — never force, safe to repeat."
+              : "Nothing to push — no local commits sit ahead of the remote branch yet."
+          }
+        >
+          <span
+            className="block w-full"
+            tabIndex={!canPush ? 0 : undefined}
+          >
             <Button
               className="w-full justify-start"
               variant={canPush ? "default" : "outline"}
@@ -237,9 +271,22 @@ export function GitActionsPanel({
                 </HelpTip>
               )}
             </Button>
+          </span>
+        </HelpTip>
 
         {/* Create PR Action */}
         <Dialog open={showPRDialog} onOpenChange={handlePRDialogOpenChange}>
+          <HelpTip
+            label={
+              canCreatePR
+                ? "Opens GitHub's PR creation flow for this branch against main."
+                : "Already on main with nothing ahead of it — there's no branch content to open a PR for."
+            }
+          >
+            <span
+              className="block w-full"
+              tabIndex={!canCreatePR ? 0 : undefined}
+            >
               <DialogTrigger asChild>
                 <Button
                   className="w-full justify-start"
@@ -250,18 +297,24 @@ export function GitActionsPanel({
                   Create Pull Request
                 </Button>
               </DialogTrigger>
+            </span>
+          </HelpTip>
           <DialogContent className="max-w-lg">
             <DialogHeader>
               <DialogTitle>Create Pull Request</DialogTitle>
             </DialogHeader>
             <div className="space-y-4 py-4">
-              <div className="flex items-center gap-2 text-sm text-muted-foreground">
+              <HelpTip label="Source branch on the left merges into the target branch on the right.">
+                <div className="flex items-center gap-2 text-sm text-muted-foreground w-fit">
                   <Badge variant="outline">{status?.current_branch}</Badge>
                   <span>→</span>
                   <Badge variant="outline">main</Badge>
                 </div>
+              </HelpTip>
               <div className="space-y-2">
-                <label className="text-sm font-medium">Title</label>
+                <HelpTip label="Becomes the pull request's title on GitHub.">
+                  <label className="text-sm font-medium w-fit">Title</label>
+                </HelpTip>
                 <Input
                   placeholder="PR title..."
                   value={prTitle}
@@ -269,7 +322,11 @@ export function GitActionsPanel({
                 />
               </div>
               <div className="space-y-2">
-                <label className="text-sm font-medium">Description</label>
+                <HelpTip label="The PR's body on GitHub — markdown supported, shown to reviewers.">
+                  <label className="text-sm font-medium w-fit">
+                    Description
+                  </label>
+                </HelpTip>
                 <Textarea
                   placeholder="Describe your changes..."
                   value={prBody}
@@ -300,6 +357,8 @@ export function GitActionsPanel({
           open={showMergeDialog}
           onOpenChange={handleMergeDialogOpenChange}
         >
+          <HelpTip label="Merges an open PR via GitHub's API — squash by default, falls back to merge/rebase if blocked by branch protection.">
+            <span className="block w-full">
               <DialogTrigger asChild>
                 <Button className="w-full justify-start" variant="outline">
                   {isMerging ? (
@@ -310,13 +369,19 @@ export function GitActionsPanel({
                   Merge PR
                 </Button>
               </DialogTrigger>
+            </span>
+          </HelpTip>
           <DialogContent className="max-w-sm">
             <DialogHeader>
               <DialogTitle>Merge Pull Request</DialogTitle>
             </DialogHeader>
             <div className="space-y-4 py-4">
               <div className="space-y-2">
-                <label className="text-sm font-medium">PR Number</label>
+                <HelpTip label="The GitHub PR number to merge, e.g. the 42 in .../pull/42.">
+                  <label className="text-sm font-medium w-fit">
+                    PR Number
+                  </label>
+                </HelpTip>
                 <Input
                   type="number"
                   placeholder="e.g. 42"
@@ -351,6 +416,8 @@ export function GitActionsPanel({
         </Dialog>
 
         {/* Pull Action */}
+        <HelpTip label="Fetches origin, then fast-forwards your branch onto it. Refuses (no merge commit) if history has diverged.">
+          <span className="block w-full">
             <Button
               className="w-full justify-start"
               variant="outline"
@@ -364,8 +431,12 @@ export function GitActionsPanel({
               )}
               Pull from Remote
             </Button>
+          </span>
+        </HelpTip>
 
         {/* Fetch Action */}
+        <HelpTip label="Updates remote-tracking refs from origin only — never touches your working directory or local branch.">
+          <span className="block w-full">
             <Button
               className="w-full justify-start"
               variant="outline"
@@ -379,9 +450,13 @@ export function GitActionsPanel({
               )}
               Fetch Remote
             </Button>
+          </span>
+        </HelpTip>
 
         {/* Rebase Action — destructive, requires confirmation */}
         <AlertDialog>
+          <HelpTip label="Rewrites this branch's commit history on top of another branch. Requires a force-push afterward — use with care.">
+            <span className="block w-full">
               <AlertDialogTrigger asChild>
                 <Button
                   className="w-full justify-start"
@@ -396,6 +471,8 @@ export function GitActionsPanel({
                   Rebase onto Remote
                 </Button>
               </AlertDialogTrigger>
+            </span>
+          </HelpTip>
           <AlertDialogContent className="border-destructive bg-destructive/5">
             <AlertDialogHeader>
               <AlertDialogTitle>Rebase onto target branch?</AlertDialogTitle>
@@ -407,7 +484,11 @@ export function GitActionsPanel({
               </AlertDialogDescription>
             </AlertDialogHeader>
             <div className="px-6 py-2 space-y-2">
-              <label className="text-sm font-medium">Target branch</label>
+              <HelpTip label="Branch/ref to replay commits onto, e.g. origin/main. On conflict, rebase auto-aborts — your tree stays untouched.">
+                <label className="text-sm font-medium w-fit">
+                  Target branch
+                </label>
+              </HelpTip>
               <Input
                 placeholder="Remote ref (e.g. origin/HEAD)"
                 value={rebaseTargetBranch}

panel/src/components/git/git-branch-panel.tsx

@@ -92,19 +92,27 @@ export function GitBranchPanel({
             Branches
           </span>
           <Dialog open={showCreateDialog} onOpenChange={setShowCreateDialog}>
+            <HelpTip label="Creates a new branch named {type}/{team}/{task-id}, branched from the task's parent branch (or the project default).">
+              <span className="inline-block">
                 <DialogTrigger asChild>
                   <Button size="sm" variant="outline">
                     <Plus className="h-3 w-3 mr-1" />
                     New
                   </Button>
                 </DialogTrigger>
+              </span>
+            </HelpTip>
             <DialogContent>
               <DialogHeader>
                 <DialogTitle>Create Task Branch</DialogTitle>
               </DialogHeader>
               <div className="space-y-4 py-4">
                 <div className="space-y-2">
-                  <label className="text-sm font-medium">Branch Type</label>
+                  <HelpTip label="Sets the branch-name prefix (feature/bug/chore/docs/hotfix) — doesn't otherwise change behavior.">
+                    <label className="text-sm font-medium w-fit">
+                      Branch Type
+                    </label>
+                  </HelpTip>
                   <Select
                     value={newBranchType}
                     onValueChange={(v) => setNewBranchType(v as BranchType)}
@@ -122,7 +130,11 @@ export function GitBranchPanel({
                   </Select>
                 </div>
                 <div className="space-y-2">
-                  <label className="text-sm font-medium">Task ID</label>
+                  <HelpTip label="Identifies the task this branch is for — gets embedded in the branch name (shortened to 8 chars).">
+                    <label className="text-sm font-medium w-fit">
+                      Task ID
+                    </label>
+                  </HelpTip>
                   <Input
                     placeholder="Enter task ID..."
                     value={taskId}
@@ -156,13 +168,26 @@ export function GitBranchPanel({
           <div className="space-y-3">
             {/* Local Branches */}
             <div>
-              <h4 className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-1">
+              <HelpTip label="Branches that exist in your local clone's .git — checking one out is instant, no fetch needed.">
+                <h4 className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-1 w-fit">
                   Local ({localBranches.length})
                 </h4>
+              </HelpTip>
               <div className="space-y-0.5">
                 {localBranches.map((branch) => (
-                  <Button
+                  <HelpTip
                     key={branch.name}
+                    label={
+                      branch.is_current
+                        ? "This is the branch you're already on."
+                        : "Switches your workspace to this branch (git checkout). Non-conflicting uncommitted changes carry over."
+                    }
+                  >
+                    <span
+                      className="block"
+                      tabIndex={branch.is_current ? 0 : undefined}
+                    >
+                      <Button
                         onClick={() =>
                           !branch.is_current && onCheckout(branch.name)
                         }
@@ -191,6 +216,8 @@ export function GitBranchPanel({
                           </HelpTip>
                         )}
                       </Button>
+                    </span>
+                  </HelpTip>
                 ))}
               </div>
             </div>
@@ -198,14 +225,20 @@ export function GitBranchPanel({
             {/* Remote Branches */}
             {remoteBranches.length > 0 && (
               <div>
-                <h4 className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-1 flex items-center gap-1">
+                <HelpTip label="Branches on origin without a local counterpart yet — checking one out creates a local tracking branch.">
+                  <h4 className="text-xs font-semibold text-muted-foreground uppercase tracking-wider mb-1 flex items-center gap-1 w-fit">
                     <Cloud className="h-3 w-3" />
                     Remote ({remoteBranches.length})
                   </h4>
+                </HelpTip>
                 <div className="space-y-0.5">
                   {remoteBranches.map((branch) => (
-                    <Button
+                    <HelpTip
                       key={branch.name}
+                      label="Creates a local branch tracking this remote ref and switches to it."
+                    >
+                      <span className="block">
+                        <Button
                           onClick={() => onCheckout(branch.name)}
                           disabled={isCheckingOut}
                           variant="ghost"
@@ -215,6 +248,8 @@ export function GitBranchPanel({
                             {branch.name}
                           </span>
                         </Button>
+                      </span>
+                    </HelpTip>
                   ))}
                 </div>
               </div>

panel/src/components/git/git-browser.tsx

@@ -18,6 +18,7 @@ import { GitDiffViewer } from "./git-diff-viewer";
 import { GitActionsPanel } from "./git-actions-panel";
 import { GitBranch, FolderGit2 } from "lucide-react";
 import { useGitBrowser } from "@/hooks/use-git-browser";
+import { HelpTip } from "@/components/ui/help-tip";
 
 function GitBrowserContent() {
   const {
@@ -80,6 +81,8 @@ function GitBrowserContent() {
         </div>
         <div className="flex items-center gap-2">
           {/* Project Selector */}
+          <HelpTip label="Switches every panel below (status, branches, log, diff) to this project's clone on disk.">
+            <span className="w-full sm:w-64">
               <Select value={projectSlug} onValueChange={handleProjectChange}>
                 <SelectTrigger className="w-full sm:w-64">
                   <FolderGit2 className="h-4 w-4 mr-2" />
@@ -99,6 +102,8 @@ function GitBrowserContent() {
                   )}
                 </SelectContent>
               </Select>
+            </span>
+          </HelpTip>
         </div>
       </div>
 

panel/src/components/git/git-diff-viewer.tsx

@@ -104,21 +104,30 @@ export function GitDiffViewer({
     <Card>
       <CardHeader className="pb-2">
         <div className="flex items-center justify-between gap-2">
-          <CardTitle className="text-sm flex items-center gap-2">
+          <HelpTip label="Green = added lines, red = removed, blue = hunk header (@@ ... @@ shows the surrounding line range).">
+            <CardTitle className="text-sm flex items-center gap-2 w-fit">
               <FileCode className="h-4 w-4" />
               Changes
             </CardTitle>
+          </HelpTip>
+          <HelpTip
+            label={
+              wrap
+                ? "Long lines wrap to fit the panel — click to scroll horizontally instead."
+                : "Long lines overflow with horizontal scroll — click to wrap them instead."
+            }
+          >
             <Button
               variant={wrap ? "secondary" : "ghost"}
               size="sm"
               className="h-7 px-2 text-xs"
               aria-pressed={wrap}
               onClick={() => setWrap((w) => !w)}
-            title="Toggle line wrap"
             >
               <WrapText className="h-3.5 w-3.5 mr-1" />
               Wrap
             </Button>
+          </HelpTip>
         </div>
       </CardHeader>
       <CardContent className="p-0">

panel/src/components/git/git-log-panel.tsx

@@ -62,17 +62,22 @@ export function GitLogPanel({
         <CardTitle className="text-sm flex items-center gap-2">
           <GitCommit className="h-4 w-4" />
           Commit History
+          <HelpTip label="Commits reachable from this branch, newest first.">
             <Badge variant="secondary" className="ml-auto text-xs">
               {log.branch}
             </Badge>
+          </HelpTip>
         </CardTitle>
       </CardHeader>
       <CardContent className="p-0">
         <ScrollArea className="h-80">
           <div className="p-4 space-y-0">
             {log.commits.map((commit, index) => (
-              <Button
+              <HelpTip
                 key={commit.hash}
+                label={onSelectCommit ? "Select this commit" : ""}
+              >
+              <Button
                 onClick={() => onSelectCommit?.(commit)}
                 variant="ghost"
                 className={cn(
@@ -120,16 +125,19 @@ export function GitLogPanel({
                         <User className="h-3 w-3" />
                         {commit.author}
                       </span>
-                      <span className="flex items-center gap-1">
+                      <HelpTip label={new Date(commit.date).toLocaleString()}>
+                        <span className="flex items-center gap-1 w-fit">
                           <Calendar className="h-3 w-3" />
                           {formatDistanceToNow(new Date(commit.date), {
                             addSuffix: true,
                           })}
                         </span>
+                      </HelpTip>
                     </div>
                   </div>
                 </div>
               </Button>
+              </HelpTip>
             ))}
           </div>
         </ScrollArea>

panel/src/components/git/git-status-panel.tsx

@@ -70,20 +70,24 @@ export function GitStatusPanel({ status, isLoading }: GitStatusPanelProps) {
             Repository Status
           </span>
           {!hasChanges && (
+            <HelpTip label="No staged, modified, or untracked files — the working tree matches HEAD.">
               <Badge variant="outline" className="text-green-600">
                 <CheckCircle className="h-3 w-3 mr-1" />
                 Clean
               </Badge>
+            </HelpTip>
           )}
         </CardTitle>
       </CardHeader>
       <CardContent className="space-y-4">
         {/* Branch Info */}
         <div className="flex items-center gap-4 text-sm">
-          <div className="flex items-center gap-2">
+          <HelpTip label="The branch currently checked out in this project's workspace.">
+            <div className="flex items-center gap-2 w-fit">
               <GitBranch className="h-4 w-4 text-muted-foreground" />
               <span className="font-medium">{status.current_branch}</span>
             </div>
+          </HelpTip>
           {(status.ahead > 0 || status.behind > 0) && (
             <div className="flex items-center gap-2">
               {status.ahead > 0 && (

panel/src/components/kanban/core/kanban-board.tsx

@@ -16,6 +16,7 @@ import {
   TooltipContent,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
+import { HelpTip } from "@/components/ui/help-tip";
 import { ChevronLeft, ChevronRight } from "lucide-react";
 import { toast } from "sonner";
 import {
@@ -391,6 +392,13 @@ export function KanbanBoard({
         {/* Mobile: single-column view with prev/next navigator (hidden on sm+) */}
         <div className="sm:hidden flex flex-1 min-h-0 flex-col">
           <div className="flex items-center gap-2 mb-4 shrink-0">
+            {/* Buttons wrapped in a span, not tipped directly: disabled sets
+                pointer-events:none on the Button and would swallow hover. */}
+            <HelpTip label="Swipe to the previous lifecycle stage — each column is one task status">
+              <span
+                className="shrink-0"
+                tabIndex={activeColumnIndex === 0 ? undefined : 0}
+              >
                 <Button
                   variant="outline"
                   size="icon"
@@ -401,24 +409,37 @@ export function KanbanBoard({
                 >
                   <ChevronLeft className="h-5 w-5" />
                 </Button>
+              </span>
+            </HelpTip>
             <p className="flex-1 text-center text-sm font-semibold">
               <span className="text-muted-foreground font-normal text-xs mr-1">
                 {activeColumnIndex + 1}/{columns.length}
               </span>
               {columns[activeColumnIndex]?.title}
             </p>
+            <HelpTip label="Swipe to the next lifecycle stage — each column is one task status">
+              <span
+                className="shrink-0"
+                tabIndex={
+                  activeColumnIndex === columns.length - 1 ? undefined : 0
+                }
+              >
                 <Button
                   variant="outline"
                   size="icon"
                   className="min-h-11 min-w-11 shrink-0"
                   onClick={() =>
-                setActiveColumnIndex((i) => Math.min(columns.length - 1, i + 1))
+                    setActiveColumnIndex((i) =>
+                      Math.min(columns.length - 1, i + 1),
+                    )
                   }
                   disabled={activeColumnIndex === columns.length - 1}
                   aria-label="Next column"
                 >
                   <ChevronRight className="h-5 w-5" />
                 </Button>
+              </span>
+            </HelpTip>
           </div>
           {columns[activeColumnIndex] && (
             <KanbanColumn

panel/src/components/kanban/core/kanban-card.tsx

@@ -17,6 +17,7 @@ import {
   TooltipProvider,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
+import { HelpTip } from "@/components/ui/help-tip";
 import { PriorityIndicator } from "../shared/priority-indicator";
 import { BlockedBadge } from "../shared/blocked-badge";
 import { AssigneeAvatar } from "../shared/assignee-avatar";
@@ -109,12 +110,13 @@ export function KanbanCard({
           <div className="flex-1 min-w-0 overflow-hidden">
             <Link href={"/tasks/" + task.id} className="block" prefetch={false}>
               <p className="font-medium text-sm line-clamp-2 hover:underline break-words">
-                <span
+                <HelpTip
-                  className="font-mono text-muted-foreground"
+                  label={`Full ID ${task.id} — the 8-char prefix is what commits and branch names for this task use`}
-                  title={task.id}
                 >
+                  <span className="font-mono text-muted-foreground">
                     #{task.id.slice(0, 8)}
-                </span>{" "}
+                  </span>
+                </HelpTip>{" "}
                 {task.title}
               </p>
             </Link>
@@ -144,9 +146,11 @@ export function KanbanCard({
 
         <div className="flex items-center justify-between mt-2">
           <div className="flex items-center gap-1 flex-wrap">
+            <HelpTip label="Delivery cell that owns this task — only its agents can claim it">
               <Badge variant="outline" className="text-xs">
                 {task.team.replace(/_/g, " ")}
               </Badge>
+            </HelpTip>
             <TaskTypeBadge type={task.task_type} showLabel={false} />
             {task.sequence != null && (
               <Tooltip>

panel/src/components/kanban/core/kanban-column.tsx

@@ -8,6 +8,8 @@ import {
   TooltipContent,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
+import { HelpTip } from "@/components/ui/help-tip";
+import { taskStatusDescription } from "@/components/tasks/task-status-badge";
 import { KanbanCard } from "./kanban-card";
 import { useDroppable } from "@dnd-kit/core";
 import { cn } from "@/lib/utils";
@@ -55,9 +57,19 @@ export function KanbanColumn({
       )}
     >
       <div className="flex items-center justify-between mb-3">
-        <h3 className="font-semibold text-sm text-gray-800 dark:text-gray-100">
+        {/* Reuses the canonical per-status copy (task-status-badge.tsx) so a
+            column header explains what a drag-drop here actually does. */}
+        <HelpTip
+          label={
+            taskStatusDescription(status)
+              ? `Dropping a card here fires this transition: ${taskStatusDescription(status)}`
+              : null
+          }
+        >
+          <h3 className="font-semibold text-sm text-gray-800 dark:text-gray-100 w-fit">
             {title}
           </h3>
+        </HelpTip>
         <Tooltip>
           <TooltipTrigger asChild>
             <Badge

panel/src/components/prompter/batch-review-card.tsx

@@ -267,6 +267,7 @@ export function BatchReviewCard({
         )}
 
         <div className="flex flex-wrap gap-2 pt-1">
+          <HelpTip label="Dismisses this review and returns to chat — nothing is launched, the draft batch is kept">
             <Button
               variant="outline"
               size="sm"
@@ -276,6 +277,7 @@ export function BatchReviewCard({
               <MessageCircle className="mr-1.5 h-3.5 w-3.5" />
               Keep chatting
             </Button>
+          </HelpTip>
           {/* Board review & Start → the Board reviews the whole batch first */}
           <HelpTip label="Routes the whole MegaTask through the Product Owner and Head of Marketing for review before any work starts.">
             <Button

panel/src/components/prompter/board-review-sent-card.tsx

@@ -78,6 +78,7 @@ export function BoardReviewSentCard({
       </CardContent>
 
       <CardFooter className="gap-2 pt-0">
+        <HelpTip label="Opens the umbrella task in a new tab — use Approve & Start there once the board finishes">
           <Button variant="outline" size="sm" asChild className="flex-1">
             <Link
               prefetch={false}
@@ -89,10 +90,13 @@ export function BoardReviewSentCard({
               View umbrella task
             </Link>
           </Button>
+        </HelpTip>
+        <HelpTip label="Ends this session and resets to a fresh intake chat">
           <Button size="sm" className="flex-1" onClick={onStartAnother}>
             <RefreshCw className="mr-1.5 h-3.5 w-3.5" />
             Start another
           </Button>
+        </HelpTip>
       </CardFooter>
     </Card>
   );

panel/src/components/prompter/chat-composer.tsx

@@ -8,6 +8,7 @@ import {
   TooltipContent,
   TooltipTrigger,
 } from "@/components/ui/tooltip";
+import { HelpTip } from "@/components/ui/help-tip";
 import { Textarea } from "@/components/ui/textarea";
 
 interface ChatComposerProps {
@@ -57,6 +58,7 @@ export function ChatComposer({
       className="flex items-end gap-2 border-t bg-background px-4 py-3"
       style={{ paddingBottom: "max(0.75rem, env(safe-area-inset-bottom))" }}
     >
+      <HelpTip label="Enter sends; Shift+Enter inserts a newline">
         <Textarea
           ref={textareaRef}
           value={value}
@@ -67,6 +69,7 @@ export function ChatComposer({
           rows={2}
           className="flex-1 resize-none text-sm"
         />
+      </HelpTip>
       <Tooltip>
         <TooltipTrigger asChild>
           <Button

panel/src/components/prompter/chat-messages.tsx

@@ -7,6 +7,7 @@ import ReactMarkdown from "react-markdown";
 import remarkGfm from "remark-gfm";
 import { cn } from "@/lib/utils";
 import { CopyButton } from "@/components/ui/copy-button";
+import { HelpTip } from "@/components/ui/help-tip";
 import type { ChatMessage, StartRoute } from "@/hooks/use-prompter";
 import { DraftProposalCard } from "./draft-proposal-card";
 
@@ -110,7 +111,11 @@ export function ChatMessages({
           return (
             <div key={msg.id} className="flex justify-start">
               <div className="group relative flex max-w-[70%] items-start gap-2 rounded-2xl rounded-tl-sm border border-destructive/30 bg-destructive/10 px-4 py-3 text-sm text-destructive">
-                <AlertTriangle className="mt-0.5 h-4 w-4 shrink-0" />
+                <HelpTip label="A request to the agent failed — this message did not come from it">
+                  <span className="mt-0.5 shrink-0" tabIndex={0}>
+                    <AlertTriangle className="h-4 w-4" />
+                  </span>
+                </HelpTip>
                 <span>{msg.content}</span>
                 <CopyButton
                   value={msg.content}

panel/src/components/prompter/draft-proposal-card.tsx

@@ -88,17 +88,23 @@ export function DraftProposalCard({
           </CardTitle>
           <div className="flex flex-wrap items-center gap-1 shrink-0">
             {draft.team && (
+              <HelpTip label="Delivery cell this task will be routed to">
                 <Badge variant="secondary" className="text-xs">
                   {draft.team}
                 </Badge>
+              </HelpTip>
             )}
+            <HelpTip label="How urgently agents work this once created — higher priority is claimed first">
               <Badge variant="outline" className="text-xs">
                 {priorityLabel}
               </Badge>
+            </HelpTip>
             {draft.task_type && (
+              <HelpTip label="Kind of work this is — affects which role picks it up">
                 <Badge variant="outline" className="text-xs">
                   {draft.task_type}
                 </Badge>
+              </HelpTip>
             )}
             <CopyButton value={draftToText(draft)} className="ml-0.5" />
           </div>
@@ -161,6 +167,7 @@ export function DraftProposalCard({
       </CardContent>
 
       <CardFooter className="flex-wrap gap-2 pt-0">
+        <HelpTip label="Dismisses this card and returns to chat — nothing is launched, the draft is kept">
           <Button
             variant="outline"
             size="sm"
@@ -170,6 +177,7 @@ export function DraftProposalCard({
             <MessageCircle className="mr-1.5 h-3.5 w-3.5" />
             Keep chatting
           </Button>
+        </HelpTip>
         {/* Board review & Start → PENDING, assigned to PO + HoM for review */}
         <HelpTip label="Routes this task through the Product Owner and Head of Marketing for review before any work starts.">
           <Button

panel/src/components/prompter/intake-form.tsx

@@ -139,9 +139,11 @@ export function IntakeForm({
               onValueChange={onProjectId}
               disabled={isPreparing}
             >
+              <HelpTip label="Only this project's repo is cloned and read by the agent">
                 <SelectTrigger>
                   <SelectValue placeholder="Select a project…" />
                 </SelectTrigger>
+              </HelpTip>
               <SelectContent>
                 {projects.map((p) => (
                   <SelectItem key={p.id} value={p.id}>
@@ -201,9 +203,11 @@ export function IntakeForm({
                 onValueChange={onProductId}
                 disabled={isPreparing}
               >
+                <HelpTip label="Every cell repo mapped to this product is cloned and read by the agent">
                   <SelectTrigger>
                     <SelectValue placeholder="Select a product…" />
                   </SelectTrigger>
+                </HelpTip>
                 <SelectContent>
                   {products.map((p) => (
                     <SelectItem key={p.id} value={p.id}>
@@ -229,6 +233,7 @@ export function IntakeForm({
             What do you want to build?{" "}
             <span className="text-destructive">*</span>
           </Label>
+          <HelpTip label="Kicks off the interview — you can refine details in chat afterward">
             <Textarea
               id="intake-initial-message"
               value={initialMessage}
@@ -237,6 +242,7 @@ export function IntakeForm({
               rows={4}
               disabled={isPreparing}
             />
+          </HelpTip>
         </div>
 
         {/* Button's own disabled:pointer-events-none would swallow hover, so

panel/src/components/prompter/success-card.tsx

@@ -41,9 +41,11 @@ export function SuccessCard({
       <CardContent className="pb-3 space-y-2">
         <p className="text-sm font-medium">{taskTitle}</p>
         <div className="flex items-center gap-2">
+          <HelpTip label="Delivery cell this task was routed to">
             <Badge variant="secondary" className="text-xs">
               {team.replace("_", " ")}
             </Badge>
+          </HelpTip>
           <HelpTip label={`Full task ID: ${taskId}`}>
             <span className="text-xs text-muted-foreground">
               ID: {taskId.slice(0, 8)}…
@@ -53,6 +55,7 @@ export function SuccessCard({
       </CardContent>
 
       <CardFooter className="gap-2 pt-0">
+        <HelpTip label="Opens the new task's detail page in a new tab">
           <Button variant="outline" size="sm" asChild className="flex-1">
             <Link
               prefetch={false}
@@ -64,10 +67,13 @@ export function SuccessCard({
               View Task
             </Link>
           </Button>
+        </HelpTip>
+        <HelpTip label="Ends this session and resets to a fresh intake chat">
           <Button size="sm" className="flex-1" onClick={onStartAnother}>
             <RefreshCw className="mr-1.5 h-3.5 w-3.5" />
             Start Another
           </Button>
+        </HelpTip>
       </CardFooter>
     </Card>
   );

panel/src/components/tasks/acceptance-criteria-editor.tsx

@@ -10,6 +10,7 @@ import {
 import { Input } from "@/components/ui/input";
 import { Label } from "@/components/ui/label";
 import { Plus, X, GripVertical } from "lucide-react";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface AcceptanceCriteriaEditorProps {
   criteria: string[];
@@ -53,12 +54,16 @@ export function AcceptanceCriteriaEditor({
   return (
     <div className="space-y-3">
       <div className="flex items-center justify-between">
+        <HelpTip label="QA and reviewers check each of these directly against the shipped work to decide pass/fail.">
           <Label>
             Acceptance Criteria <span className="text-destructive">*</span>
           </Label>
+        </HelpTip>
+        <HelpTip label="How many criteria are defined so far — at least one is required to submit.">
           <span className="text-xs text-muted-foreground">
             {criteria.length} item{criteria.length !== 1 ? "s" : ""}
           </span>
+        </HelpTip>
       </div>
 
       {/* Existing criteria list */}
@@ -70,11 +75,13 @@ export function AcceptanceCriteriaEditor({
               <span className="text-sm text-muted-foreground w-6">
                 {index + 1}.
               </span>
+              <HelpTip label="Edit this criterion's text directly — changes save as you type.">
                 <Input
                   value={criterion}
                   onChange={(e) => handleUpdate(index, e.target.value)}
                   className="flex-1 h-8"
                 />
+              </HelpTip>
               <Tooltip>
                 <TooltipTrigger asChild>
                   <Button
@@ -96,6 +103,7 @@ export function AcceptanceCriteriaEditor({
 
       {/* Add new criterion */}
       <div className="flex items-center gap-2">
+        <HelpTip label="A specific, testable condition — Enter or Add appends it to the list above.">
           <Input
             value={newCriterion}
             onChange={(e) => setNewCriterion(e.target.value)}
@@ -103,6 +111,12 @@ export function AcceptanceCriteriaEditor({
             placeholder="Enter acceptance criterion and press Enter..."
             className="flex-1"
           />
+        </HelpTip>
+        <HelpTip label="Appends the text on the left as a new criterion; disabled until you type something.">
+          <span
+            className="inline-block"
+            tabIndex={!newCriterion.trim() ? 0 : undefined}
+          >
             <Button
               type="button"
               variant="outline"
@@ -112,6 +126,8 @@ export function AcceptanceCriteriaEditor({
               <Plus className="h-4 w-4 mr-1" />
               Add
             </Button>
+          </span>
+        </HelpTip>
       </div>
 
       {/* Helper text */}

panel/src/components/tasks/approve-and-start-button.tsx

@@ -74,6 +74,7 @@ export function ApproveAndStartButton({ task }: ApproveAndStartButtonProps) {
 
   return (
     <>
+      <HelpTip label="Hands this task to the Main PM and unblocks any BACKLOG child tasks (CEO-only).">
         <Button
           size="sm"
           className="bg-green-600 hover:bg-green-700"
@@ -82,6 +83,7 @@ export function ApproveAndStartButton({ task }: ApproveAndStartButtonProps) {
           <Rocket className="h-4 w-4 mr-1" />
           Approve &amp; Start
         </Button>
+      </HelpTip>
 
       <Dialog
         open={open}
@@ -97,7 +99,9 @@ export function ApproveAndStartButton({ task }: ApproveAndStartButtonProps) {
           </DialogHeader>
 
           <div className="space-y-2">
+            <HelpTip label="Fetched live only while this dialog is open — read it before approving.">
               <Label>Board review (Product Owner &amp; Head of Marketing)</Label>
+            </HelpTip>
             {boardLoading ? (
               <p className="text-xs text-muted-foreground">
                 Loading board review…
@@ -140,9 +144,16 @@ export function ApproveAndStartButton({ task }: ApproveAndStartButtonProps) {
           </div>
 
           <DialogFooter>
+            <HelpTip label="Closes without approving; the note above is discarded.">
               <Button variant="outline" onClick={closeDialog}>
                 Cancel
               </Button>
+            </HelpTip>
+            <HelpTip label="Submits the approval note and hands the task to the Main PM.">
+              <span
+                className="inline-block"
+                tabIndex={approveAndStartMutation.isPending ? 0 : undefined}
+              >
                 <Button
                   onClick={handleConfirm}
                   disabled={approveAndStartMutation.isPending}
@@ -152,6 +163,8 @@ export function ApproveAndStartButton({ task }: ApproveAndStartButtonProps) {
                     ? "Starting..."
                     : "Approve & Start"}
                 </Button>
+              </span>
+            </HelpTip>
           </DialogFooter>
         </DialogContent>
       </Dialog>

panel/src/components/tasks/create-task-dialog.tsx

@@ -233,9 +233,11 @@ export function CreateTaskDialog() {
         <form onSubmit={handleSubmit} className="space-y-6 mt-4">
           {/* Title */}
           <div className="space-y-2">
+            <HelpTip label="5-200 characters. Shown in the task list, task detail, and used as the default PR title.">
               <Label htmlFor="title">
                 Title <span className="text-destructive">*</span>
               </Label>
+            </HelpTip>
             <Input
               id="title"
               value={title}
@@ -262,9 +264,11 @@ export function CreateTaskDialog() {
           {/* Team, Priority, Complexity, Status, Nature */}
           <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-5 gap-4">
             <div className="space-y-2">
+              <HelpTip label="Which cell owns this task — governs claim eligibility and the branch name (feature/{team}/...).">
                 <Label>
                   Team <span className="text-destructive">*</span>
                 </Label>
+              </HelpTip>
               <Select value={team} onValueChange={(v) => setTeam(v as Team)}>
                 <SelectTrigger className="w-full">
                   <SelectValue />
@@ -279,7 +283,9 @@ export function CreateTaskDialog() {
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Pending is claimable immediately; Backlog waits for PM setup (dependencies/session) before it can be activated.">
                 <Label>Status</Label>
+              </HelpTip>
               <Select
                 value={status}
                 onValueChange={(v) => setStatus(v as TaskStatus)}
@@ -297,7 +303,9 @@ export function CreateTaskDialog() {
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Orders claim/dispatch queues — P0 tasks surface first. Doesn't force who claims it or block lower priorities.">
                 <Label>Priority</Label>
+              </HelpTip>
               <Select
                 value={String(priority)}
                 onValueChange={(v) => setPriority(parseInt(v, 10))}
@@ -315,7 +323,9 @@ export function CreateTaskDialog() {
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Medium/High auto-routes a code task to the cell or Main PM to break down; a bare High dev task with no subtasks self-blocks.">
                 <Label>Complexity</Label>
+              </HelpTip>
               <Select
                 value={complexity}
                 onValueChange={(v) => setComplexity(v as Complexity)}
@@ -333,7 +343,9 @@ export function CreateTaskDialog() {
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Filtering only: Non-Technical root tasks awaiting PM review surface in the Board's strategic queue.">
                 <Label>Nature</Label>
+              </HelpTip>
               <Select
                 value={nature}
                 onValueChange={(v) => setNature(v as TaskNature)}
@@ -373,7 +385,9 @@ export function CreateTaskDialog() {
                 type="button"
                 className="w-full justify-between"
               >
+                <HelpTip label="Parent task, agent assignment, task type, and repo/product routing.">
                   <span>Advanced Options</span>
+                </HelpTip>
                 {advancedOpen ? (
                   <ChevronDown className="h-4 w-4" />
                 ) : (
@@ -384,7 +398,9 @@ export function CreateTaskDialog() {
             <CollapsibleContent className="space-y-4 pt-4">
               {/* Parent Task */}
               <div className="space-y-2">
+                <HelpTip label="Nests this task under another — its claim order is then gated by sequence relative to siblings under the same parent.">
                   <Label>Parent Task (for subtasks)</Label>
+                </HelpTip>
                 <TaskSelector
                   value={parentTaskId}
                   onChange={setParentTaskId}
@@ -398,7 +414,9 @@ export function CreateTaskDialog() {
 
               {/* Assign To */}
               <div className="space-y-2">
+                <HelpTip label="Pin a specific agent; leave unassigned to let the orchestrator route by role, team, and availability.">
                   <Label>Assign To</Label>
+                </HelpTip>
                 <AgentSelector
                   value={assignedTo}
                   onChange={setAssignedTo}
@@ -415,9 +433,11 @@ export function CreateTaskDialog() {
               <div className="space-y-4 pt-4 border-t">
                 <div className="flex items-center gap-2 mb-2">
                   <GitBranch className="h-4 w-4 text-muted-foreground" />
+                  <HelpTip label="Every task type follows the same branch → commits → PR workflow; these fields just route it.">
                     <span className="font-medium text-sm">
                       Git & Work Configuration
                     </span>
+                  </HelpTip>
                 </div>
 
                 {/* Task Type */}
@@ -447,7 +467,9 @@ export function CreateTaskDialog() {
 
                 {/* Project — required UNLESS a Product is picked (fan-out task) */}
                 <div className="space-y-2">
+                  <HelpTip label="The repo the branch/PR are opened against once this task is claimed.">
                     <Label>Project</Label>
+                  </HelpTip>
                   <ProjectSelector
                     value={projectId || null}
                     onChange={(value) => setProjectId(value || "")}
@@ -467,7 +489,9 @@ export function CreateTaskDialog() {
 
                 {/* Product (optional) — drives per-cell project routing of subtasks */}
                 <div className="space-y-2">
+                  <HelpTip label="Fan-out: each delegated subtask routes to that cell's own mapped project instead of one repo.">
                     <Label>Product</Label>
+                  </HelpTip>
                   <Select
                     value={productId || "none"}
                     onValueChange={(v) => setProductId(v === "none" ? "" : v)}
@@ -497,6 +521,7 @@ export function CreateTaskDialog() {
 
           {/* Actions */}
           <div className="flex justify-end gap-2 pt-4 border-t">
+            <HelpTip label="Discards everything entered above without creating a task.">
               <Button
                 type="button"
                 variant="outline"
@@ -507,9 +532,17 @@ export function CreateTaskDialog() {
               >
                 Cancel
               </Button>
+            </HelpTip>
+            <HelpTip label="Validates the required fields, then creates the task via the API.">
+              <span
+                className="inline-block"
+                tabIndex={createTask.isPending ? 0 : undefined}
+              >
                 <Button type="submit" disabled={createTask.isPending}>
                   {createTask.isPending ? "Creating..." : "Create Task"}
                 </Button>
+              </span>
+            </HelpTip>
           </div>
         </form>
       </DialogContent>

panel/src/components/tasks/dependency-selector.tsx

@@ -20,6 +20,7 @@ import {
   PopoverTrigger,
 } from "@/components/ui/popover";
 import { Search, X, Link2 } from "lucide-react";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface DependencySelectorProps {
   selectedIds: string[];
@@ -68,7 +69,9 @@ export function DependencySelector({
 
   return (
     <div className="space-y-2">
+      <HelpTip label="This task cannot be claimed until every dependency listed here reaches a terminal state.">
         <Label>Dependencies (optional)</Label>
+      </HelpTip>
 
       {/* Selected dependencies */}
       {selectedTasks.length > 0 && (
@@ -81,9 +84,14 @@ export function DependencySelector({
               <div className="flex items-center gap-2 min-w-0">
                 <Link2 className="h-4 w-4 text-muted-foreground shrink-0" />
                 <span className="text-sm truncate">{task.title}</span>
-                <Badge variant="outline" className="font-mono text-xs shrink-0">
+                <HelpTip label="First 8 characters of this task's full ID.">
+                  <Badge
+                    variant="outline"
+                    className="font-mono text-xs shrink-0"
+                  >
                     {task.id.slice(0, 8)}
                   </Badge>
+                </HelpTip>
               </div>
               <Tooltip>
                 <TooltipTrigger asChild>
@@ -106,6 +114,7 @@ export function DependencySelector({
 
       {/* Add dependency popover */}
       <Popover open={open} onOpenChange={setOpen}>
+        <HelpTip label="Only shows tasks that aren't already completed or cancelled — those can't block anything.">
           <PopoverTrigger asChild>
             <Button
               type="button"
@@ -116,8 +125,10 @@ export function DependencySelector({
               Search tasks to add as dependencies...
             </Button>
           </PopoverTrigger>
+        </HelpTip>
         <PopoverContent className="w-80 sm:w-96 p-0" align="start">
           <div className="p-2 border-b">
+            <HelpTip label="Matches against task title or ID as you type.">
               <Input
                 value={search}
                 onChange={(e) => setSearch(e.target.value)}
@@ -125,6 +136,7 @@ export function DependencySelector({
                 className="h-8"
                 autoFocus
               />
+            </HelpTip>
           </div>
           <ScrollArea className="h-[240px]">
             {filteredTasks.length === 0 ? (
@@ -136,8 +148,15 @@ export function DependencySelector({
                 {filteredTasks.map((task) => {
                   const isSelected = selectedIds.includes(task.id);
                   return (
-                    <Button
+                    <HelpTip
                       key={task.id}
+                      label={
+                        isSelected
+                          ? "Click to remove this dependency"
+                          : "Click to add this dependency"
+                      }
+                    >
+                      <Button
                         type="button"
                         variant="ghost"
                         className={`w-full h-auto justify-start gap-2 p-2 font-normal whitespace-normal ${
@@ -166,6 +185,7 @@ export function DependencySelector({
                           </div>
                         </div>
                       </Button>
+                    </HelpTip>
                   );
                 })}
               </div>

panel/src/components/tasks/docs-status-badge.tsx

@@ -81,6 +81,13 @@ export function DocsStatusBadge({
   // Full variant with labels
   return (
     <div className={cn("flex flex-col gap-2", className)}>
+      <HelpTip
+        label={
+          docsComplete
+            ? DOCS_DESCRIPTIONS.complete
+            : "Blocks the awaiting_documentation → awaiting_pm_review handoff until the documenter marks it done."
+        }
+      >
         <div className="flex items-center justify-between text-sm">
           <span className="flex items-center gap-1 text-muted-foreground">
             <FileCheck className="h-4 w-4" />
@@ -95,6 +102,14 @@ export function DocsStatusBadge({
             {docsComplete ? "Complete" : "Pending"}
           </span>
         </div>
+      </HelpTip>
+      <HelpTip
+        label={
+          prCreated
+            ? PR_DESCRIPTIONS.created
+            : "The PR is opened before QA review, not after — this task hasn't reached that step yet."
+        }
+      >
         <div className="flex items-center justify-between text-sm">
           <span className="flex items-center gap-1 text-muted-foreground">
             <GitPullRequest className="h-4 w-4" />
@@ -109,6 +124,7 @@ export function DocsStatusBadge({
             {prCreated ? "Created" : "Pending"}
           </span>
         </div>
+      </HelpTip>
     </div>
   );
 }

panel/src/components/tasks/edit-task-dialog.tsx

@@ -166,7 +166,9 @@ function EditTaskDialogInner({
         <form onSubmit={handleSubmit} className="space-y-6 mt-4">
           {/* Title */}
           <div className="space-y-2">
+            <HelpTip label="5-200 characters. Shown in the task list, task detail, and used as the default PR title.">
               <Label htmlFor="edit-title">Title</Label>
+            </HelpTip>
             <Input
               id="edit-title"
               value={title}
@@ -187,7 +189,9 @@ function EditTaskDialogInner({
           {/* Team, Priority, Complexity, Nature */}
           <div className="grid grid-cols-2 md:grid-cols-4 gap-4">
             <div className="space-y-2">
+              <HelpTip label="Which cell owns this task — governs claim eligibility. Changing it after a branch exists doesn't rename the branch.">
                 <Label>Team</Label>
+              </HelpTip>
               <Select value={team} onValueChange={(v) => setTeam(v as Team)}>
                 <SelectTrigger>
                   <SelectValue />
@@ -202,7 +206,9 @@ function EditTaskDialogInner({
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Orders claim/dispatch queues — P0 tasks surface first. Doesn't force who claims it or block lower priorities.">
                 <Label>Priority</Label>
+              </HelpTip>
               <Select
                 value={String(priority)}
                 onValueChange={(v) => setPriority(parseInt(v, 10))}
@@ -220,7 +226,9 @@ function EditTaskDialogInner({
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Medium/High auto-routes a code task to the cell or Main PM to break down; a bare High dev task with no subtasks self-blocks.">
                 <Label>Complexity</Label>
+              </HelpTip>
               <Select
                 value={complexity}
                 onValueChange={(v) => setComplexity(v as Complexity)}
@@ -238,7 +246,9 @@ function EditTaskDialogInner({
               </Select>
             </div>
             <div className="space-y-2">
+              <HelpTip label="Filtering only: Non-Technical root tasks awaiting PM review surface in the Board's strategic queue.">
                 <Label>Nature</Label>
+              </HelpTip>
               <Select
                 value={nature}
                 onValueChange={(v) => setNature(v as TaskNature)}
@@ -265,7 +275,9 @@ function EditTaskDialogInner({
                 type="button"
                 className="w-full justify-between"
               >
+                <HelpTip label="Agent assignment, target date, task type, and repo routing.">
                   <span>Advanced Options</span>
+                </HelpTip>
                 {advancedOpen ? (
                   <ChevronDown className="h-4 w-4" />
                 ) : (
@@ -276,7 +288,9 @@ function EditTaskDialogInner({
             <CollapsibleContent className="space-y-4 pt-4">
               {/* Assigned To */}
               <div className="space-y-2">
+                <HelpTip label="Pin a specific agent; leave unassigned to let the orchestrator route by role, team, and availability.">
                   <Label>Assigned To</Label>
+                </HelpTip>
                 <AgentSelector
                   value={assignedTo}
                   onChange={setAssignedTo}
@@ -287,7 +301,9 @@ function EditTaskDialogInner({
 
               {/* Target Date */}
               <div className="space-y-2">
+                <HelpTip label="Informational deadline only — nothing in the lifecycle enforces or auto-escalates on it.">
                   <Label>Target Date</Label>
+                </HelpTip>
                 <Input
                   type="datetime-local"
                   value={targetDate}
@@ -328,7 +344,9 @@ function EditTaskDialogInner({
 
                 {/* Project Selector (required - all tasks follow git workflow) */}
                 <div className="space-y-2">
+                  <HelpTip label="The repo the branch/PR are opened against. Locked once a branch exists — see below.">
                     <Label>Project</Label>
+                  </HelpTip>
                   <ProjectSelector
                     value={projectId || null}
                     onChange={(value) => setProjectId(value || "")}
@@ -347,6 +365,7 @@ function EditTaskDialogInner({
 
           {/* Actions */}
           <div className="flex justify-end gap-2 pt-4 border-t">
+            <HelpTip label="Discards any edits made above and closes without saving.">
               <Button
                 type="button"
                 variant="outline"
@@ -354,9 +373,17 @@ function EditTaskDialogInner({
               >
                 Cancel
               </Button>
+            </HelpTip>
+            <HelpTip label="Sends the changed fields to the API and updates the task in place.">
+              <span
+                className="inline-block"
+                tabIndex={updateTask.isPending ? 0 : undefined}
+              >
                 <Button type="submit" disabled={updateTask.isPending}>
                   {updateTask.isPending ? "Saving..." : "Save Changes"}
                 </Button>
+              </span>
+            </HelpTip>
           </div>
         </form>
       </DialogContent>

panel/src/components/tasks/git-status-badge.tsx

@@ -52,10 +52,12 @@ export function GitStatusBadge({
   if (task.pr_number) {
     return (
       <MaybeLink href={task.pr_url ?? pullUrl(repoUrl, task.pr_number)}>
+        <HelpTip label="Opens this task's pull request on GitHub in a new tab.">
           <Badge className="gap-1 text-xs bg-purple-500/10 text-purple-600 dark:text-purple-400">
             <GitPullRequest className="h-3 w-3" />
             PR #{task.pr_number}
           </Badge>
+        </HelpTip>
       </MaybeLink>
     );
   }

panel/src/components/tasks/markdown-editor.tsx

@@ -41,12 +41,20 @@ export function MarkdownEditor({
         >
           <TabsList className="h-8">
             <TabsTrigger value="write" className="text-xs px-2 h-6">
+              <HelpTip label="Edit the raw markdown text.">
+                <span className="flex items-center">
                   <Edit3 className="h-3 w-3 mr-1" />
                   Write
+                </span>
+              </HelpTip>
             </TabsTrigger>
             <TabsTrigger value="preview" className="text-xs px-2 h-6">
+              <HelpTip label="Renders the markdown as it will appear elsewhere in the app.">
+                <span className="flex items-center">
                   <Eye className="h-3 w-3 mr-1" />
                   Preview
+                </span>
+              </HelpTip>
             </TabsTrigger>
           </TabsList>
         </Tabs>
@@ -76,9 +84,11 @@ export function MarkdownEditor({
           <span>Markdown supported</span>
         </HelpTip>
         {minLength && (
+          <HelpTip label="Submission is blocked until the count reaches this minimum.">
             <span className={value.length < minLength ? "text-destructive" : ""}>
               {value.length}/{minLength} min characters
             </span>
+          </HelpTip>
         )}
       </div>
 

panel/src/components/tasks/task-actions.tsx

@@ -41,6 +41,7 @@ import {
 import { toast } from "sonner";
 import { EditTaskDialog } from "./edit-task-dialog";
 import { RequiredNotesDialog } from "./task-detail/task-action-dialogs";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface TaskActionsProps {
   task: Task;
@@ -169,59 +170,77 @@ export function TaskActions({
         <DropdownMenuContent align="end">
           {/* Edit option */}
           {showEdit && canEdit && (
+            <HelpTip label="Opens the edit dialog to change title, description, team, priority, and more.">
               <DropdownMenuItem onClick={() => setEditOpen(true)}>
                 <Pencil className="h-4 w-4 mr-2" />
                 Edit
               </DropdownMenuItem>
+            </HelpTip>
           )}
 
           {/* Backlog status info */}
           {isBacklog && (
             <>
+              <HelpTip label="Backlog tasks need PM setup (dependencies/session) before they become claimable.">
+                <span className="block" tabIndex={0}>
                   <DropdownMenuItem disabled className="text-muted-foreground">
                     <Clock className="h-4 w-4 mr-2" />
                     Awaiting PM Activation
                   </DropdownMenuItem>
+                </span>
+              </HelpTip>
               <DropdownMenuSeparator />
             </>
           )}
 
           {/* Lifecycle actions */}
           {task.status === TaskStatus.PENDING && (
+            <HelpTip label="Locks this task to you (pending → claimed).">
               <DropdownMenuItem onClick={() => handleAction("claim")}>
                 <Play className="h-4 w-4 mr-2" />
                 Claim
               </DropdownMenuItem>
+            </HelpTip>
           )}
           {task.status === TaskStatus.CLAIMED && (
+            <HelpTip label="Begins active work (claimed → in_progress).">
               <DropdownMenuItem onClick={() => handleAction("start")}>
                 <Play className="h-4 w-4 mr-2" />
                 Start
               </DropdownMenuItem>
+            </HelpTip>
           )}
           {task.status === TaskStatus.IN_PROGRESS && (
+            <HelpTip label="Stops work temporarily; can be resumed later (in_progress → paused).">
               <DropdownMenuItem onClick={() => handleAction("pause")}>
                 <Pause className="h-4 w-4 mr-2" />
                 Pause
               </DropdownMenuItem>
+            </HelpTip>
           )}
           {task.status === TaskStatus.PAUSED && (
+            <HelpTip label="Resumes paused work (paused → in_progress).">
               <DropdownMenuItem onClick={() => handleAction("resume")}>
                 <Play className="h-4 w-4 mr-2" />
                 Resume
               </DropdownMenuItem>
+            </HelpTip>
           )}
           {task.status === TaskStatus.BLOCKED && (
+            <HelpTip label="Clears the block and restores the original owner (blocked → in_progress or pending).">
               <DropdownMenuItem onClick={() => handleAction("unblock")}>
                 <Play className="h-4 w-4 mr-2" />
                 Unblock
               </DropdownMenuItem>
+            </HelpTip>
           )}
           {task.status === TaskStatus.CANCELLED && (
+            <HelpTip label="Resurrects a cancelled task back to pending — an audited privileged override.">
               <DropdownMenuItem onClick={() => handleAction("reopen")}>
                 <Play className="h-4 w-4 mr-2" />
                 Reopen
               </DropdownMenuItem>
+            </HelpTip>
           )}
 
           {task.status !== TaskStatus.COMPLETED &&
@@ -230,10 +249,13 @@ export function TaskActions({
               <>
                 <DropdownMenuSeparator />
 
+                <HelpTip label="Directly completes the task — requires the normal review chain done, or this is your own PM root.">
                   <DropdownMenuItem onClick={() => handleAction("complete")}>
                     <CheckCircle className="h-4 w-4 mr-2" />
                     Complete
                   </DropdownMenuItem>
+                </HelpTip>
+                <HelpTip label="Cancels this task and every subtask beneath it; the reason becomes the audit record.">
                   <DropdownMenuItem
                     onClick={() => handleAction("cancel")}
                     className="text-orange-600"
@@ -241,11 +263,13 @@ export function TaskActions({
                     <XCircle className="h-4 w-4 mr-2" />
                     Cancel
                   </DropdownMenuItem>
+                </HelpTip>
               </>
             )}
 
           {/* Cancel for backlog tasks (allowed - can remove from backlog) */}
           {isBacklog && (
+            <HelpTip label="Removes this task from the backlog and cancels any subtasks; the reason becomes the audit record.">
               <DropdownMenuItem
                 onClick={() => handleAction("cancel")}
                 className="text-orange-600"
@@ -253,12 +277,14 @@ export function TaskActions({
                 <XCircle className="h-4 w-4 mr-2" />
                 Cancel
               </DropdownMenuItem>
+            </HelpTip>
           )}
 
           {/* Delete option */}
           {showDelete && canDelete && (
             <>
               <DropdownMenuSeparator />
+              <HelpTip label="Permanently deletes this task and every subtask beneath it — cannot be undone.">
                 <DropdownMenuItem
                   onClick={() => setDeleteOpen(true)}
                   className="text-red-600"
@@ -266,6 +292,7 @@ export function TaskActions({
                   <Trash2 className="h-4 w-4 mr-2" />
                   Delete
                 </DropdownMenuItem>
+              </HelpTip>
             </>
           )}
         </DropdownMenuContent>
@@ -314,13 +341,17 @@ export function TaskActions({
             </AlertDialogDescription>
           </AlertDialogHeader>
           <AlertDialogFooter>
+            <HelpTip label="Closes without deleting anything.">
               <AlertDialogCancel>Cancel</AlertDialogCancel>
+            </HelpTip>
+            <HelpTip label="Deletes the task and cascades to every subtask beneath it, leaf-first.">
               <AlertDialogAction
                 onClick={handleDelete}
                 className="bg-red-600 hover:bg-red-700"
               >
                 {deleteTask.isPending ? "Deleting..." : "Delete"}
               </AlertDialogAction>
+            </HelpTip>
           </AlertDialogFooter>
         </AlertDialogContent>
       </AlertDialog>

panel/src/components/tasks/task-detail/__tests__/tab-progress-collapse.test.tsx

@@ -44,11 +44,15 @@ describe("TabProgress progress-update collapse", () => {
     const task = buildTask({ progress_updates: makeUpdates(30) });
     const { container } = render(<TabProgress task={task} />);
 
-    // Each update's collapse trigger is the only <button> in its <li> that
+    // Scope to the collapse trigger specifically via its test id — the row
-    // carries Radix's data-state attribute; list order matches sort order
+    // also carries a delete button wrapped in a HelpTip/Tooltip, which
-    // (newest first), so the first two entries are the 2 most recent.
+    // stamps its own Radix data-state, so a bare "button[data-state]"
+    // selector would match both. List order matches sort order (newest
+    // first), so the first two entries are the 2 most recent.
     const triggers = Array.from(
-      container.querySelectorAll("li button[data-state]"),
+      container.querySelectorAll(
+        'li button[data-testid="progress-update-trigger"]',
+      ),
     );
     expect(triggers).toHaveLength(30);
     expect(triggers[0]).toHaveAttribute("data-state", "open");

panel/src/components/tasks/task-detail/__tests__/task-detail-readability.test.tsx

@@ -54,8 +54,14 @@ describe("Task detail readability: long progress history + long criteria list",
     const task = buildTask({ progress_updates: makeUpdates(32) });
     const { container } = render(<TabProgress task={task} />);
 
+    // Scope to the collapse trigger specifically via its test id — the row
+    // also carries a delete button wrapped in a HelpTip/Tooltip, which
+    // stamps its own Radix data-state, so a bare "button[data-state]"
+    // selector would match both.
     const triggers = Array.from(
-      container.querySelectorAll("li button[data-state]"),
+      container.querySelectorAll(
+        'li button[data-testid="progress-update-trigger"]',
+      ),
     );
     expect(triggers).toHaveLength(32);
     const openCount = triggers.filter(

panel/src/components/tasks/task-detail/acceptance-criteria.tsx

@@ -180,19 +180,27 @@ export function AcceptanceCriteria({ task }: AcceptanceCriteriaProps) {
 
   return (
     <CollapsibleSection
-      title="Acceptance Criteria"
+      title={
+        <HelpTip label="What proves this task is done — reviewers and the auto-submit gate check coverage against these">
+          <span className="w-fit">Acceptance Criteria</span>
+        </HelpTip>
+      }
       content={criteriaText}
       open={isAdding || editingIndex !== null ? true : undefined}
       actions={
         <div className="flex items-center gap-2">
-          <span className="text-sm text-muted-foreground">
+          <HelpTip label="Criteria whose checkbox is checked, out of the total">
+            <span className="text-sm text-muted-foreground w-fit">
               {completedCount}/{criteria.length} completed
             </span>
+          </HelpTip>
           {!isAdding && (
+            <HelpTip label="Adds a new empty criterion to this list">
               <Button size="sm" variant="ghost" onClick={() => setIsAdding(true)}>
                 <Plus className="h-4 w-4 mr-1" />
                 Add
               </Button>
+            </HelpTip>
           )}
         </div>
       }

panel/src/components/tasks/task-detail/checkpoint-card.tsx

@@ -5,6 +5,7 @@ import { Card, CardContent } from "@/components/ui/card";
 import { Bookmark, Clock, User, ListTodo, FileText } from "lucide-react";
 import { getAgentDisplayName } from "@/lib/agent-utils";
 import { formatAbsoluteTimestamp } from "@/lib/utils";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface CheckpointCardProps {
   checkpoint: Checkpoint;
@@ -14,10 +15,12 @@ export function CheckpointCard({ checkpoint }: CheckpointCardProps) {
   return (
     <Card className="overflow-hidden">
       <div className="bg-primary/10 px-4 py-2 flex items-center justify-between">
+        <HelpTip label="A saved state snapshot an agent leaves so work can resume later without re-deriving context">
           <div className="flex items-center gap-2">
             <Bookmark className="h-4 w-4 text-primary" />
             <span className="font-medium text-sm">Checkpoint</span>
           </div>
+        </HelpTip>
         <div className="flex items-center gap-2 text-xs text-muted-foreground">
           <Clock className="h-3 w-3" />
           {formatAbsoluteTimestamp(checkpoint.timestamp)}
@@ -32,7 +35,9 @@ export function CheckpointCard({ checkpoint }: CheckpointCardProps) {
 
         {/* State Summary */}
         <div className="mb-4">
-          <h4 className="text-sm font-medium mb-1">State Summary</h4>
+          <HelpTip label="What the agent understood to be true about the task when this checkpoint was saved">
+            <h4 className="text-sm font-medium mb-1 w-fit">State Summary</h4>
+          </HelpTip>
           <p className="text-sm text-muted-foreground whitespace-pre-wrap">
             {checkpoint.state_summary}
           </p>
@@ -41,10 +46,12 @@ export function CheckpointCard({ checkpoint }: CheckpointCardProps) {
         {/* Remaining Work */}
         {checkpoint.remaining_work.length > 0 && (
           <div className="mb-4">
-            <div className="flex items-center gap-2 mb-2">
+            <HelpTip label="Sub-steps the agent identified as still outstanding at checkpoint time">
+              <div className="flex items-center gap-2 mb-2 w-fit">
                 <ListTodo className="h-4 w-4 text-muted-foreground" />
                 <h4 className="text-sm font-medium">Remaining Work</h4>
               </div>
+            </HelpTip>
             <ul className="list-disc list-inside text-sm text-muted-foreground space-y-1">
               {checkpoint.remaining_work.map((item, idx) => (
                 <li key={idx}>{item}</li>
@@ -56,10 +63,12 @@ export function CheckpointCard({ checkpoint }: CheckpointCardProps) {
         {/* Notes */}
         {checkpoint.notes && (
           <div>
-            <div className="flex items-center gap-2 mb-2">
+            <HelpTip label="Free-form notes the checkpointing agent left for whoever resumes this task">
+              <div className="flex items-center gap-2 mb-2 w-fit">
                 <FileText className="h-4 w-4 text-muted-foreground" />
                 <h4 className="text-sm font-medium">Notes</h4>
               </div>
+            </HelpTip>
             <p className="text-sm text-muted-foreground whitespace-pre-wrap">
               {checkpoint.notes}
             </p>

panel/src/components/tasks/task-detail/progress-timeline.tsx

@@ -6,6 +6,7 @@ import { Progress } from "@/components/ui/progress";
 import { MessageSquare, Clock } from "lucide-react";
 import { getAgentDisplayName } from "@/lib/agent-utils";
 import { formatAbsoluteTimestamp } from "@/lib/utils";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface ProgressTimelineProps {
   updates: ProgressUpdate[];
@@ -45,17 +46,21 @@ export function ProgressTimeline({ updates }: ProgressTimelineProps) {
     <Card>
       <CardHeader className="pb-3">
         <div className="flex items-center justify-between">
-          <CardTitle className="text-lg">Progress Updates</CardTitle>
+          <HelpTip label="Timestamped status updates posted while agents work this task, newest first">
+            <CardTitle className="text-lg w-fit">Progress Updates</CardTitle>
+          </HelpTip>
           <span className="text-sm text-muted-foreground">
             {updates.length} update{updates.length !== 1 ? "s" : ""}
           </span>
         </div>
         {latestWithPercentage && (
           <div className="mt-2">
+            <HelpTip label="The most recent percentage reported — self-reported or derived from completed plan steps">
               <div className="flex items-center justify-between text-sm mb-1">
                 <span className="text-muted-foreground">Overall Progress</span>
                 <span className="font-medium">{currentProgress}%</span>
               </div>
+            </HelpTip>
             <Progress value={currentProgress} className="h-2" />
           </div>
         )}
@@ -100,9 +105,11 @@ export function ProgressTimeline({ updates }: ProgressTimelineProps) {
                             value={update.percentage}
                             className="h-1.5 flex-1"
                           />
+                          <HelpTip label="This update's reported completion percentage, out of 100">
                             <span className="text-xs text-muted-foreground w-10 text-right">
                               {update.percentage}%
                             </span>
+                          </HelpTip>
                         </div>
                       </div>
                     )}

panel/src/components/tasks/task-detail/subtasks-list.tsx

@@ -65,7 +65,8 @@ export function SubtasksList({ task }: SubtasksListProps) {
     <Card>
       <CardHeader className="pb-3">
         <div className="flex items-center justify-between">
-          <CardTitle className="text-lg flex items-center gap-2">
+          <HelpTip label="Direct children of this task; badge is completed/total">
+            <CardTitle className="text-lg flex items-center gap-2 w-fit">
               <ListTree className="h-5 w-5" />
               Subtasks
               {totalCount > 0 && (
@@ -74,12 +75,14 @@ export function SubtasksList({ task }: SubtasksListProps) {
                 </Badge>
               )}
             </CardTitle>
+          </HelpTip>
           <div className="flex items-center gap-2">
             {totalCount > 0 && (
               <span className="text-sm text-muted-foreground">
                 {completionPercent}% complete
               </span>
             )}
+            <HelpTip label="Opens the Tasks list, pre-filtered to this parent and team, to create a new subtask">
               <Link
                 href={`/tasks?parent=${task.id}&team=${task.team}`}
                 prefetch={false}
@@ -89,6 +92,7 @@ export function SubtasksList({ task }: SubtasksListProps) {
                   Add
                 </Button>
               </Link>
+            </HelpTip>
           </div>
         </div>
       </CardHeader>

panel/src/components/tasks/task-detail/tab-collision.tsx

@@ -77,7 +77,9 @@ function SiblingCard({ sib }: { sib: CollisionSibling }) {
             </code>
           )}
           {sib.pr_number != null && (
+            <HelpTip label="This sibling's pull request number, if one has been opened yet">
               <Badge variant="outline">#{sib.pr_number}</Badge>
+            </HelpTip>
           )}
           {sib.adds_migration && (
             <HelpTip label={MIGRATION_TIP}>
@@ -130,9 +132,11 @@ function SiblingCard({ sib }: { sib: CollisionSibling }) {
 
         {sib.undeclared.length > 0 && (
           <div className="rounded border border-amber-300 dark:border-amber-800 bg-amber-50 dark:bg-amber-950/40 p-2 text-xs">
-            <span className="text-amber-700 dark:text-amber-300 font-medium">
+            <HelpTip label="Files this sibling actually touched in commits but never declared in its collision surface">
+              <span className="text-amber-700 dark:text-amber-300 font-medium w-fit">
                 Drift — touched but not declared:
               </span>
+            </HelpTip>
             <div className="mt-1 flex flex-wrap gap-1">
               {sib.undeclared.map((f) => (
                 <code
@@ -197,9 +201,11 @@ export function TabCollision({ task }: TabCollisionProps) {
     <div className="space-y-4">
       <DeclaredSurfaceCard data={data} />
       <div>
-        <h3 className="text-sm font-semibold mb-3">
+        <HelpTip label="Siblings whose declared file surface overlaps yours, or that share a migration/shared-file chain">
+          <h3 className="text-sm font-semibold mb-3 w-fit">
             {siblings.length} colliding sibling{siblings.length > 1 ? "s" : ""}
           </h3>
+        </HelpTip>
         <div className="space-y-3">
           {siblings.map((sib) => (
             <SiblingCard key={sib.id} sib={sib} />
@@ -218,7 +224,9 @@ function DeclaredSurfaceCard({ data }: { data: CollisionMap }) {
   return (
     <Card>
       <CardContent className="pt-4 space-y-2">
-        <h3 className="text-sm font-semibold">Declared surface</h3>
+        <HelpTip label="The file globs, migration flag, and shared-surface flag this task pre-declared for sequencing">
+          <h3 className="text-sm font-semibold w-fit">Declared surface</h3>
+        </HelpTip>
         {hasSurface ? (
           <>
             {data.intends_to_touch.length > 0 && (

panel/src/components/tasks/task-detail/tab-commits.tsx

@@ -20,6 +20,7 @@ import {
 } from "lucide-react";
 import { toast } from "sonner";
 import { getAgentDisplayName } from "@/lib/agent-utils";
+import { formatAbsoluteTimestamp } from "@/lib/utils";
 import { HelpTip } from "@/components/ui/help-tip";
 
 interface TabCommitsProps {
@@ -114,13 +115,15 @@ export function TabCommits({ task }: TabCommitsProps) {
     <Card>
       <CardHeader className="pb-3">
         <div className="grid grid-cols-3 items-center gap-4">
-          <CardTitle className="text-lg flex items-center gap-2">
+          <HelpTip label="Commits attributed to this task — new ones link automatically as devs push">
+            <CardTitle className="text-lg flex items-center gap-2 w-fit">
               <GitCommit className="h-5 w-5" />
               Linked Commits
               <span className="text-sm font-normal text-muted-foreground">
                 ({commits.length})
               </span>
             </CardTitle>
+          </HelpTip>
           <div className="flex items-center justify-center gap-2">
             {task.branch_name && (
               <HelpTip label="Git branch this task is being worked on">
@@ -149,6 +152,7 @@ export function TabCommits({ task }: TabCommitsProps) {
           </div>
           <div className="flex justify-end">
             {!isAdding && (
+              <HelpTip label="Manually attach a commit hash — normally commits link automatically via the commit verb">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -157,6 +161,7 @@ export function TabCommits({ task }: TabCommitsProps) {
                   <Plus className="h-4 w-4 mr-1" />
                   Link
                 </Button>
+              </HelpTip>
             )}
           </div>
         </div>
@@ -167,9 +172,11 @@ export function TabCommits({ task }: TabCommitsProps) {
           <div className="border rounded-lg p-4 mb-4 space-y-3">
             <div className="grid grid-cols-2 gap-3">
               <div>
-                <label className="text-sm font-medium mb-1 block">
+                <HelpTip label="7-40 character git SHA; a short hash is fine">
+                  <label className="text-sm font-medium mb-1 block w-fit">
                     Commit Hash
                   </label>
+                </HelpTip>
                 <Input
                   ref={hashRef}
                   value={newHash}
@@ -179,9 +186,11 @@ export function TabCommits({ task }: TabCommitsProps) {
                 />
               </div>
               <div>
-                <label className="text-sm font-medium mb-1 block">
+                <HelpTip label="Free-text description shown wherever this commit is displayed">
+                  <label className="text-sm font-medium mb-1 block w-fit">
                     Commit Message
                   </label>
+                </HelpTip>
                 <Input
                   value={newMessage}
                   onChange={(e) => setNewMessage(e.target.value)}
@@ -224,10 +233,12 @@ export function TabCommits({ task }: TabCommitsProps) {
             <p className="text-sm mt-2 mb-4">
               Commits will be linked as developers push code for this task.
             </p>
+            <HelpTip label="Manually attach a commit hash if auto-linking missed one">
               <Button variant="outline" onClick={() => setIsAdding(true)}>
                 <Plus className="h-4 w-4 mr-2" />
                 Link Commit Manually
               </Button>
+            </HelpTip>
           </div>
         ) : (
           <div className="space-y-3">
@@ -266,10 +277,12 @@ export function TabCommits({ task }: TabCommitsProps) {
                           )}
 
                           {/* Time */}
+                          <HelpTip label={formatAbsoluteTimestamp(commit.timestamp)}>
                             <span className="flex items-center gap-1">
                               <Clock className="h-3 w-3" />
                               {formatTime(commit.timestamp)}
                             </span>
+                          </HelpTip>
                         </div>
                       </div>
                     </div>

panel/src/components/tasks/task-detail/tab-dependencies.tsx

@@ -26,6 +26,17 @@ interface TabDependenciesProps {
   task: Task;
 }
 
+// Grounded in roboco/services/gateway/claim_guards.py: dependency_ids
+// genuinely gates claim (a task can't be claimed until every dependency
+// reaches completed/cancelled); blocker_ids is the pure-informational
+// inverse ("tasks this one is blocking") and does not itself gate anything.
+const FIELD_TIPS: Record<DependencyListProps["field"], string> = {
+  dependency_ids:
+    "Tasks that must reach completed/cancelled before this one can be claimed.",
+  blocker_ids:
+    "Tasks that depend on this one — informational; does not block this task's own claim.",
+};
+
 interface DependencyListProps {
   task: Task;
   field: "dependency_ids" | "blocker_ids";
@@ -124,19 +135,33 @@ function DependencyList({
       <CardHeader>
         <div className="flex items-center justify-between">
           <CardTitle className="text-lg flex items-center gap-2">
+            <HelpTip label={FIELD_TIPS[field]}>
+              <span className="flex items-center gap-2">
                 {icon}
                 {title}
+              </span>
+            </HelpTip>
             {ids.length > 0 && field === "blocker_ids" && (
+              <HelpTip label="Number of other tasks currently depending on this one">
                 <Badge variant="destructive" className="ml-2">
                   {ids.length}
                 </Badge>
+              </HelpTip>
             )}
           </CardTitle>
           {!isAdding && (
+            <HelpTip
+              label={
+                field === "dependency_ids"
+                  ? "Add a task ID this task must wait on"
+                  : "Add a task ID that this task is blocking"
+              }
+            >
               <Button size="sm" variant="ghost" onClick={() => setIsAdding(true)}>
                 <Plus className="h-4 w-4 mr-1" />
                 Add
               </Button>
+            </HelpTip>
           )}
         </div>
       </CardHeader>
@@ -167,9 +192,17 @@ function DependencyList({
                       </span>
                     </Link>
                   </HelpTip>
+                  <HelpTip
+                    label={
+                      field === "dependency_ids"
+                        ? "Click the id to open this dependency task"
+                        : "This task is blocking the linked task's claim"
+                    }
+                  >
                     <Badge variant="outline" className={badgeClass}>
                       {badgeLabel}
                     </Badge>
+                  </HelpTip>
                   <HelpTip label="Remove this dependency">
                     <Button
                       size="sm"
@@ -198,6 +231,7 @@ function DependencyList({
                   className="h-8 text-sm flex-1 font-mono"
                   disabled={updateTask.isPending}
                 />
+                <HelpTip label="Discard and cancel">
                   <Button
                     size="sm"
                     variant="ghost"
@@ -209,6 +243,14 @@ function DependencyList({
                   >
                     <X className="h-4 w-4" />
                   </Button>
+                </HelpTip>
+                <HelpTip
+                  label={
+                    field === "dependency_ids"
+                      ? "Add this task ID as a dependency"
+                      : "Add this task ID as a blocked task"
+                  }
+                >
                   <Button
                     size="sm"
                     onClick={handleAdd}
@@ -217,6 +259,7 @@ function DependencyList({
                   >
                     <Check className="h-4 w-4" />
                   </Button>
+                </HelpTip>
               </li>
             )}
           </ul>
@@ -367,8 +410,12 @@ export function TabDependencies({ task }: TabDependenciesProps) {
         <CardHeader>
           <div className="flex items-center justify-between">
             <CardTitle className="text-lg flex items-center gap-2">
+              <HelpTip label="The coordination task this one was delegated under, if any">
+                <span className="flex items-center gap-2">
                   <ArrowUp className="h-5 w-5 text-purple-500" />
                   Parent Task
+                </span>
+              </HelpTip>
             </CardTitle>
           </div>
         </CardHeader>
@@ -386,6 +433,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 className="h-8 text-sm flex-1 font-mono"
                 disabled={updateTask.isPending}
               />
+              <HelpTip label="Discard and cancel">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -397,6 +445,8 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 >
                   <X className="h-4 w-4" />
                 </Button>
+              </HelpTip>
+              <HelpTip label="Save this parent task ID">
                 <Button
                   size="sm"
                   onClick={handleParentSave}
@@ -406,6 +456,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 >
                   <Check className="h-4 w-4" />
                 </Button>
+              </HelpTip>
             </div>
           ) : task.parent_task_id ? (
             <div
@@ -427,6 +478,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
               <Badge variant="outline" className="ml-auto">
                 View Parent
               </Badge>
+              <HelpTip label="Opens editing to change or clear the parent task — does not delete anything">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -438,6 +490,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 >
                   <Trash2 className="h-3 w-3 text-destructive" />
                 </Button>
+              </HelpTip>
             </div>
           ) : (
             <p
@@ -455,8 +508,12 @@ export function TabDependencies({ task }: TabDependenciesProps) {
         <CardHeader>
           <div className="flex items-center justify-between">
             <CardTitle className="text-lg flex items-center gap-2">
+              <HelpTip label="A same-parent sibling with a strictly lower sequence must go terminal before this one can be claimed; ties run in parallel">
+                <span className="flex items-center gap-2">
                   <Hash className="h-5 w-5 text-amber-500" />
                   Sequence
+                </span>
+              </HelpTip>
             </CardTitle>
           </div>
         </CardHeader>
@@ -475,6 +532,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 className="h-8 text-sm flex-1"
                 disabled={updateTask.isPending}
               />
+              <HelpTip label="Discard and cancel">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -483,6 +541,8 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 >
                   <X className="h-4 w-4" />
                 </Button>
+              </HelpTip>
+              <HelpTip label="Save this sequence number">
                 <Button
                   size="sm"
                   onClick={handleSequenceSave}
@@ -492,6 +552,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 >
                   <Check className="h-4 w-4" />
                 </Button>
+              </HelpTip>
             </div>
           ) : (
             <div
@@ -504,6 +565,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
               <span className="ml-2 text-xs text-muted-foreground">
                 Order within siblings — lower runs first
               </span>
+              <HelpTip label="Edit the sequence number">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -515,6 +577,7 @@ export function TabDependencies({ task }: TabDependenciesProps) {
                 >
                   <Pencil className="h-3 w-3" />
                 </Button>
+              </HelpTip>
             </div>
           )}
         </CardContent>

panel/src/components/tasks/task-detail/tab-findings.tsx

@@ -119,7 +119,11 @@ function FindingCard({
         </div>
         {finding.evidence && (
           <details className="text-xs text-muted-foreground">
-            <summary className="cursor-pointer select-none">Evidence</summary>
+            <HelpTip label="The raw evidence text the reviewer captured for this finding">
+              <summary className="cursor-pointer select-none w-fit">
+                Evidence
+              </summary>
+            </HelpTip>
             <pre className="mt-1 whitespace-pre-wrap rounded bg-muted/50 p-2">
               {finding.evidence}
             </pre>
@@ -174,20 +178,31 @@ export function TabFindings({ task }: TabFindingsProps) {
       {(data?.summary.length ?? 0) > 0 && (
         <div className="flex flex-wrap gap-2">
           {data!.summary.map((s) => (
-            <Badge key={s.origin} variant="outline">
+            <HelpTip
+              key={s.origin}
+              label="Closed combines addressed, verified, and waived findings"
+            >
+              <Badge variant="outline">
                 {ORIGIN_LABEL[s.origin] ?? s.origin}: {s.open} open ·{" "}
                 {s.addressed + s.verified + s.waived} closed
               </Badge>
+            </HelpTip>
           ))}
         </div>
       )}
       {rounds.map((group) => (
         <div key={group.round} className="space-y-3">
           <div className="flex items-center gap-2">
-            <h3 className="text-sm font-semibold">Round {group.round}</h3>
+            <HelpTip label="Each bounce back to the assignee starts a new round">
+              <h3 className="text-sm font-semibold w-fit">
+                Round {group.round}
+              </h3>
+            </HelpTip>
+            <HelpTip label="Which reviewer stage raised this round's findings">
               <Badge variant="outline">
                 {ORIGIN_LABEL[group.origin] ?? group.origin}
               </Badge>
+            </HelpTip>
           </div>
           <div className="space-y-3">
             {group.items.map((f) => (

panel/src/components/tasks/task-detail/tab-notes.tsx

@@ -62,7 +62,17 @@ function prReviewBadge(task: Task): React.ReactNode {
     failed: { label: "Failed", cls: "bg-red-500" },
   };
   const v = map[verdict] ?? { label: verdict, cls: "bg-gray-500" };
-  return <Badge className={`ml-2 ${v.cls} text-white`}>{v.label}</Badge>;
+  const tip: Record<string, string> = {
+    approved: "The PR reviewer approved this task's assembled PR.",
+    passed: "The PR reviewer passed the in-path gate — on to PM review.",
+    changes_requested: "The PR reviewer asked for changes before merging.",
+    failed: "The PR reviewer failed this task back to needs_revision.",
+  };
+  return (
+    <HelpTip label={tip[verdict]}>
+      <Badge className={`ml-2 ${v.cls} text-white`}>{v.label}</Badge>
+    </HelpTip>
+  );
 }
 
 // The card background mirrors the PR reviewer's verdict, so a FAILED review reads
@@ -269,14 +279,17 @@ function EditableNoteCard({
                 </TabsTrigger>
               </TabsList>
             </Tabs>
+            <HelpTip label="Discard changes without saving">
               <Button
                 size="sm"
                 variant="ghost"
                 onClick={handleCancel}
                 disabled={updateTask.isPending}
+                aria-label="Cancel edit"
               >
                 <X className="h-4 w-4" />
               </Button>
+            </HelpTip>
             <Button
               size="sm"
               onClick={handleSave}
@@ -362,7 +375,11 @@ export function TabNotes({ task }: TabNotesProps) {
         task={task}
         field="dev_notes"
         title="Developer Notes"
-        icon={<Code className="h-5 w-5" />}
+        icon={
+          <HelpTip label="Written by the developer — approach, decisions, anything QA should know">
+            <Code className="h-5 w-5" />
+          </HelpTip>
+        }
         bgClass="bg-muted/50"
       />
 
@@ -371,7 +388,11 @@ export function TabNotes({ task }: TabNotesProps) {
         task={task}
         field="doc_notes"
         title="Documenter Notes"
-        icon={<BookText className="h-5 w-5" />}
+        icon={
+          <HelpTip label="Written by the documenter during the awaiting_documentation phase">
+            <BookText className="h-5 w-5" />
+          </HelpTip>
+        }
         bgClass="bg-muted/50"
       />
 
@@ -382,6 +403,15 @@ export function TabNotes({ task }: TabNotesProps) {
         title="QA Notes"
         icon={<TestTube className="h-5 w-5" />}
         badge={
+          <HelpTip
+            label={
+              task.qa_verified === true
+                ? "QA passed this task on to documentation."
+                : task.qa_verified === false
+                  ? "QA failed this task back to needs_revision."
+                  : "QA hasn't reviewed this task yet."
+            }
+          >
             <Badge
               variant={
                 task.qa_verified === true
@@ -398,6 +428,7 @@ export function TabNotes({ task }: TabNotesProps) {
                   ? "Failed"
                   : "Pending"}
             </Badge>
+          </HelpTip>
         }
         bgClass={
           task.qa_verified === true

panel/src/components/tasks/task-detail/tab-overview.tsx

@@ -54,7 +54,9 @@ export function TabOverview({ task }: TabOverviewProps) {
       {task.quick_context && (
         <Card>
           <CardHeader>
-            <CardTitle className="text-lg">Quick Context</CardTitle>
+            <HelpTip label="Short notes for resuming work after an interruption — mirrored on the Notes tab">
+              <CardTitle className="text-lg w-fit">Quick Context</CardTitle>
+            </HelpTip>
           </CardHeader>
           <CardContent>
             <Markdown className="text-sm">{task.quick_context}</Markdown>
@@ -65,7 +67,9 @@ export function TabOverview({ task }: TabOverviewProps) {
       {/* Verification Status */}
       <Card>
         <CardHeader>
-          <CardTitle className="text-lg">Verification Status</CardTitle>
+          <HelpTip label="Two independent checks: the developer's self-verification, then QA's separate review">
+            <CardTitle className="text-lg w-fit">Verification Status</CardTitle>
+          </HelpTip>
         </CardHeader>
         <CardContent>
           <div className="flex items-center gap-4">
@@ -73,14 +77,17 @@ export function TabOverview({ task }: TabOverviewProps) {
               <span className="text-sm text-muted-foreground">
                 Self Verified:
               </span>
+              <HelpTip label="The developer confirmed they tested their own work before requesting QA review">
                 <Badge variant={task.self_verified ? "default" : "secondary"}>
                   {task.self_verified ? "Yes" : "No"}
                 </Badge>
+              </HelpTip>
             </div>
             <div className="flex items-center gap-2">
               <span className="text-sm text-muted-foreground">
                 QA Verified:
               </span>
+              <HelpTip label="Whether QA reviewed this task: Passed, Failed (back to needs_revision), or Pending (not reviewed yet)">
                 <Badge
                   variant={
                     task.qa_verified === true
@@ -96,6 +103,7 @@ export function TabOverview({ task }: TabOverviewProps) {
                       ? "Failed"
                       : "Pending"}
                 </Badge>
+              </HelpTip>
             </div>
           </div>
         </CardContent>

panel/src/components/tasks/task-detail/tab-plan.tsx

@@ -126,6 +126,11 @@ function ApproachSection({ task, plan }: { task: Task; plan: TaskPlan }) {
       actions={
         isEditing ? (
           <>
+            {/* Write/Preview is a stateful TabsTrigger — wrapping it in
+                HelpTip would clobber Radix's data-state (see task-tabs.tsx),
+                and the two-word label + icon already say what it does, so
+                it's left untipped rather than reassert-patched for a
+                same-line write/preview toggle. */}
             <Tabs
               value={editMode}
               onValueChange={(v) => setEditMode(v as "write" | "preview")}
@@ -151,6 +156,7 @@ function ApproachSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                 <X className="h-4 w-4" />
               </Button>
             </HelpTip>
+            <HelpTip label="Save this approach text to the task's plan">
               <Button
                 size="sm"
                 onClick={handleSave}
@@ -160,12 +166,15 @@ function ApproachSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                 <Check className="h-4 w-4 mr-1" />
                 Save
               </Button>
+            </HelpTip>
           </>
         ) : (
+          <HelpTip label="Open the approach text for editing">
             <Button size="sm" variant="ghost" onClick={startEditing}>
               <Edit3 className="h-4 w-4 mr-1" />
               Edit
             </Button>
+          </HelpTip>
         )
       }
     >
@@ -302,10 +311,12 @@ function SubTasksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
             {completedCount}/{subTasks.length} completed
           </span>
           {!isAdding && (
+            <HelpTip label="Add a new sub-task to this plan">
               <Button size="sm" variant="ghost" onClick={() => setIsAdding(true)}>
                 <Plus className="h-4 w-4 mr-1" />
                 Add
               </Button>
+            </HelpTip>
           )}
         </>
       }
@@ -318,11 +329,24 @@ function SubTasksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
               key={subtask.id}
               className="flex items-center gap-3 py-2 group"
             >
+              <HelpTip
+                label={
+                  subtask.completed
+                    ? "Mark this sub-task incomplete"
+                    : "Mark this sub-task complete"
+                }
+              >
+                {/* Checkbox exposes Radix's own data-state=checked/unchecked
+                    for its check-mark styling; re-assert it explicitly after
+                    the Tooltip wrap so the Slot merge can't clobber it (same
+                    trap as task-tabs.tsx's TabsTrigger). */}
                 <Checkbox
                   checked={subtask.completed}
+                  data-state={subtask.completed ? "checked" : "unchecked"}
                   onCheckedChange={() => handleToggle(subtask.id)}
                   disabled={updateTask.isPending}
                 />
+              </HelpTip>
               {editingId === subtask.id ? (
                 <div className="flex-1 flex items-center gap-2">
                   <Input
@@ -339,6 +363,7 @@ function SubTasksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                 </div>
               ) : (
                 <>
+                  <HelpTip label="Click to rename this sub-task">
                     <span
                       className={`flex-1 cursor-pointer hover:bg-muted/30 px-2 py-1 -mx-2 rounded ${
                         subtask.completed
@@ -352,11 +377,14 @@ function SubTasksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                     >
                       {subtask.title}
                       {subtask.estimated_hours && (
+                        <HelpTip label="Estimated effort for this sub-task, in hours">
                           <Badge variant="outline" className="ml-2 text-xs">
                             ~{subtask.estimated_hours}h
                           </Badge>
+                        </HelpTip>
                       )}
                     </span>
+                  </HelpTip>
                   <HelpTip label="Delete this sub-task">
                     <Button
                       size="sm"
@@ -509,10 +537,12 @@ function TechConsiderationsSection({
       }
       actions={
         !isAdding && (
+          <HelpTip label="Add a new technical consideration">
             <Button size="sm" variant="ghost" onClick={() => setIsAdding(true)}>
               <Plus className="h-4 w-4 mr-1" />
               Add
             </Button>
+          </HelpTip>
         )
       }
     >
@@ -536,6 +566,7 @@ function TechConsiderationsSection({
               </div>
             ) : (
               <>
+                <HelpTip label="Click to edit this consideration">
                   <span
                     className="flex-1 text-sm cursor-pointer hover:bg-muted/30 px-2 py-1 -mx-2 rounded"
                     onClick={() => {
@@ -545,6 +576,7 @@ function TechConsiderationsSection({
                   >
                     {item}
                   </span>
+                </HelpTip>
                 <HelpTip label="Delete this consideration">
                   <Button
                     size="sm"
@@ -708,10 +740,12 @@ function RisksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
       }
       actions={
         !isAdding && (
+          <HelpTip label="Add a new risk with a mitigation and severity">
             <Button size="sm" variant="ghost" onClick={() => setIsAdding(true)}>
               <Plus className="h-4 w-4 mr-1" />
               Add
             </Button>
+          </HelpTip>
         )
       }
     >
@@ -733,6 +767,7 @@ function RisksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                 className="text-sm"
               />
               <div className="flex items-center gap-2">
+                <HelpTip label="How likely/costly this risk is — see the severity badge for what each level means">
                   <Select value={editSeverity} onValueChange={setEditSeverity}>
                     <SelectTrigger className="w-32 h-8">
                       <SelectValue />
@@ -743,6 +778,7 @@ function RisksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                       <SelectItem value="high">High</SelectItem>
                     </SelectContent>
                   </Select>
+                </HelpTip>
                 <div className="flex-1" />
                 <HelpTip label="Discard and cancel">
                   <Button
@@ -826,6 +862,7 @@ function RisksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
               className="text-sm"
             />
             <div className="flex items-center gap-2">
+              <HelpTip label="How likely/costly this risk is — see the severity badge for what each level means">
                 <Select value={newSeverity} onValueChange={setNewSeverity}>
                   <SelectTrigger className="w-32 h-8">
                     <SelectValue />
@@ -836,6 +873,7 @@ function RisksSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                     <SelectItem value="high">High</SelectItem>
                   </SelectContent>
                 </Select>
+              </HelpTip>
               <div className="flex-1" />
               <HelpTip label="Discard and cancel">
                 <Button
@@ -964,10 +1002,12 @@ function OpenQuestionsSection({ task, plan }: { task: Task; plan: TaskPlan }) {
       }
       actions={
         !isAdding && (
+          <HelpTip label="Add a new open question">
             <Button size="sm" variant="ghost" onClick={() => setIsAdding(true)}>
               <Plus className="h-4 w-4 mr-1" />
               Add
             </Button>
+          </HelpTip>
         )
       }
     >
@@ -1051,12 +1091,14 @@ function OpenQuestionsSection({ task, plan }: { task: Task; plan: TaskPlan }) {
                 </div>
               ) : (
                 <div className="ml-7">
+                  <HelpTip label="No answer recorded yet — click this card to add one">
                     <Badge
                       variant="outline"
                       className="text-yellow-600 border-yellow-300"
                     >
                       Awaiting Answer
                     </Badge>
+                  </HelpTip>
                 </div>
               )}
             </div>
@@ -1157,10 +1199,12 @@ export function TabPlan({ task }: TabPlanProps) {
               A plan will be created once an agent claims and starts working on
               this task.
             </p>
+            <HelpTip label="Creates an empty plan object on this task so approach/sub-tasks/risks can be filled in manually">
               <Button onClick={createPlan} disabled={updateTask.isPending}>
                 <Plus className="h-4 w-4 mr-2" />
                 Create Plan
               </Button>
+            </HelpTip>
           </div>
         </CardContent>
       </Card>

panel/src/components/tasks/task-detail/tab-progress.tsx

@@ -30,6 +30,7 @@ import { toast } from "sonner";
 import { getAgentDisplayName } from "@/lib/agent-utils";
 import { formatAbsoluteTimestamp } from "@/lib/utils";
 import { exceedsReadabilityThreshold } from "@/lib/content-readability";
+import { HelpTip } from "@/components/ui/help-tip";
 
 /**
  * Only the 2 most recent entries default to expanded; older entries (and
@@ -159,12 +160,15 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
     <Card>
       <CardHeader className="pb-3">
         <div className="flex items-center justify-between">
+          <HelpTip label="A timestamped log of status updates entered by devs, QA, or the CEO">
             <CardTitle className="text-lg">Progress Updates</CardTitle>
+          </HelpTip>
           <div className="flex items-center gap-2">
             <span className="text-sm text-muted-foreground">
               {updates.length} update{updates.length !== 1 ? "s" : ""}
             </span>
             {!isAdding && (
+              <HelpTip label="Log a new progress update, optionally with a completion percentage">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -173,15 +177,18 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                   <Plus className="h-4 w-4 mr-1" />
                   Add
                 </Button>
+              </HelpTip>
             )}
           </div>
         </div>
         {latestWithPercentage && (
           <div className="mt-2">
+            <HelpTip label="The percentage from the most recent update that included one — manually entered, not computed from acceptance criteria">
               <div className="flex items-center justify-between text-sm mb-1">
                 <span className="text-muted-foreground">Overall Progress</span>
                 <span className="font-medium">{currentProgress}%</span>
               </div>
+            </HelpTip>
             <Progress value={currentProgress} className="h-2" />
           </div>
         )}
@@ -197,6 +204,7 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
               className="text-sm min-h-[80px]"
             />
             <div className="flex items-center gap-2">
+              <HelpTip label="Optional — leave blank to log a note with no percentage">
                 <Input
                   type="number"
                   value={newPercentage}
@@ -206,7 +214,9 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                   min="0"
                   max="100"
                 />
+              </HelpTip>
               <div className="flex-1" />
+              <HelpTip label="Discard and cancel">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -218,6 +228,8 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                 >
                   <X className="h-4 w-4" />
                 </Button>
+              </HelpTip>
+              <HelpTip label="Save this progress update to the task">
                 <Button
                   size="sm"
                   onClick={handleAdd}
@@ -226,6 +238,7 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                   <Check className="h-4 w-4 mr-1" />
                   Add Update
                 </Button>
+              </HelpTip>
             </div>
           </div>
         )}
@@ -253,9 +266,16 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                     className="bg-muted/50 rounded-lg p-3"
                   >
                     <div className="flex items-center justify-between mb-1">
+                      {/* CollapsibleTrigger is a stateful Radix trigger — HelpTip's
+                          asChild Slot would clobber its open/closed data-state
+                          (same trap as task-tabs.tsx), and this Collapsible is
+                          uncontrolled so there's no local state to re-assert.
+                          Left untipped; the chevron + agent name are visually
+                          self-explanatory as an expand/collapse row. */}
                       <CollapsibleTrigger asChild>
                         <button
                           type="button"
+                          data-testid="progress-update-trigger"
                           className="group/trigger flex min-w-0 items-center gap-1 text-left"
                         >
                           <ChevronDown className="h-3 w-3 shrink-0 text-muted-foreground transition-transform duration-200 group-data-[state=closed]/trigger:-rotate-90" />
@@ -273,6 +293,7 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                           {formatTime(update.timestamp)} ·{" "}
                           {formatAbsoluteTimestamp(update.timestamp)}
                         </span>
+                        <HelpTip label="Delete this progress update">
                           <Button
                             size="sm"
                             variant="ghost"
@@ -281,6 +302,7 @@ function ProgressUpdatesSection({ task }: { task: Task }) {
                           >
                             <Trash2 className="h-3 w-3" />
                           </Button>
+                        </HelpTip>
                       </div>
                     </div>
                     <CollapsibleContent>
@@ -382,15 +404,18 @@ function CheckpointsSection({ task }: { task: Task }) {
     <Card>
       <CardHeader className="pb-3">
         <div className="flex items-center justify-between">
+          <HelpTip label="A saved snapshot of task state + remaining work, useful for handoff between agents">
             <CardTitle className="text-lg flex items-center gap-2">
               <Bookmark className="h-5 w-5" />
               Checkpoints
             </CardTitle>
+          </HelpTip>
           <div className="flex items-center gap-2">
             <span className="text-sm text-muted-foreground">
               {checkpoints.length} saved
             </span>
             {!isAdding && (
+              <HelpTip label="Save a new checkpoint of the current state and remaining work">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -399,6 +424,7 @@ function CheckpointsSection({ task }: { task: Task }) {
                   <Plus className="h-4 w-4 mr-1" />
                   Add
                 </Button>
+              </HelpTip>
             )}
           </div>
         </div>
@@ -442,6 +468,7 @@ function CheckpointsSection({ task }: { task: Task }) {
             </div>
             <div className="flex items-center gap-2">
               <div className="flex-1" />
+              <HelpTip label="Discard and cancel">
                 <Button
                   size="sm"
                   variant="ghost"
@@ -454,6 +481,8 @@ function CheckpointsSection({ task }: { task: Task }) {
                 >
                   <X className="h-4 w-4" />
                 </Button>
+              </HelpTip>
+              <HelpTip label="Save this checkpoint to the task">
                 <Button
                   size="sm"
                   onClick={handleAdd}
@@ -462,6 +491,7 @@ function CheckpointsSection({ task }: { task: Task }) {
                   <Check className="h-4 w-4 mr-1" />
                   Save Checkpoint
                 </Button>
+              </HelpTip>
             </div>
           </div>
         )}
@@ -491,6 +521,8 @@ function CheckpointsSection({ task }: { task: Task }) {
                     defaultOpen={defaultEntryOpen(idx, checkpointContent)}
                   >
                     <div className="bg-primary/10 px-4 py-2 flex items-center justify-between">
+                      {/* Uncontrolled CollapsibleTrigger — left untipped, see
+                          the identical note in ProgressUpdatesSection above. */}
                       <CollapsibleTrigger asChild>
                         <button
                           type="button"
@@ -512,6 +544,7 @@ function CheckpointsSection({ task }: { task: Task }) {
                           {formatTime(checkpoint.timestamp)} ·{" "}
                           {formatAbsoluteTimestamp(checkpoint.timestamp)}
                         </span>
+                        <HelpTip label="Delete this checkpoint">
                           <Button
                             size="sm"
                             variant="ghost"
@@ -520,6 +553,7 @@ function CheckpointsSection({ task }: { task: Task }) {
                           >
                             <Trash2 className="h-3 w-3" />
                           </Button>
+                        </HelpTip>
                       </div>
                     </div>
                     <CollapsibleContent>

panel/src/components/tasks/task-detail/task-action-dialogs.tsx

@@ -61,7 +61,11 @@ export function EscalateToCeoDialog({
         </DialogHeader>
         <div className="grid gap-4 py-4">
           <div className="grid gap-2">
-            <Label htmlFor="reason">Reason for escalation</Label>
+            <HelpTip label="Shown to the CEO in their approval queue alongside this task">
+              <Label htmlFor="reason" className="w-fit">
+                Reason for escalation
+              </Label>
+            </HelpTip>
             <Textarea
               id="reason"
               value={reason}
@@ -72,15 +76,24 @@ export function EscalateToCeoDialog({
           </div>
         </div>
         <DialogFooter>
+          <HelpTip label="Closes without escalating; the task stays in its current status">
             <Button variant="outline" onClick={() => handleOpenChange(false)}>
               Cancel
             </Button>
+          </HelpTip>
+          <HelpTip label={!reason.trim() ? "Enter a reason to enable" : null}>
+            <span
+              className="inline-block"
+              tabIndex={!reason.trim() ? 0 : undefined}
+            >
               <Button
                 onClick={handleConfirm}
                 disabled={!reason.trim() || isPending}
               >
                 {isPending ? "Escalating..." : "Escalate"}
               </Button>
+            </span>
+          </HelpTip>
         </DialogFooter>
       </DialogContent>
     </Dialog>
@@ -126,7 +139,11 @@ export function CeoRejectDialog({
         </DialogHeader>
         <div className="grid gap-4 py-4">
           <div className="grid gap-2">
-            <Label htmlFor="notes">Required changes</Label>
+            <HelpTip label="Recorded as the CEO's rejection reason; the task returns to needs_revision">
+              <Label htmlFor="notes" className="w-fit">
+                Required changes
+              </Label>
+            </HelpTip>
             <Textarea
               id="notes"
               value={notes}
@@ -137,9 +154,16 @@ export function CeoRejectDialog({
           </div>
         </div>
         <DialogFooter>
+          <HelpTip label="Closes without rejecting; the task stays in awaiting CEO approval">
             <Button variant="outline" onClick={() => handleOpenChange(false)}>
               Cancel
             </Button>
+          </HelpTip>
+          <HelpTip label={!notes.trim() ? "Explain what changes are needed to enable" : null}>
+            <span
+              className="inline-block"
+              tabIndex={!notes.trim() ? 0 : undefined}
+            >
               <Button
                 variant="destructive"
                 onClick={handleConfirm}
@@ -147,6 +171,8 @@ export function CeoRejectDialog({
               >
                 {isPending ? "Submitting..." : "Request Changes"}
               </Button>
+            </span>
+          </HelpTip>
         </DialogFooter>
       </DialogContent>
     </Dialog>
@@ -179,6 +205,7 @@ export function ApproveAndMergeDialog({
           </DialogDescription>
         </DialogHeader>
         <DialogFooter>
+          <HelpTip label="Closes without approving or merging">
             <Button
               variant="outline"
               onClick={() => onOpenChange(false)}
@@ -186,6 +213,7 @@ export function ApproveAndMergeDialog({
             >
               Cancel
             </Button>
+          </HelpTip>
           <Button onClick={onConfirm} disabled={isPending}>
             {isPending ? "Merging..." : "Approve & Merge"}
           </Button>
@@ -263,13 +291,19 @@ export function CeoApproveDialog({
           </div>
         </div>
         <DialogFooter>
+          <HelpTip label="Closes without approving; the task stays in awaiting CEO approval">
             <Button variant="outline" onClick={() => handleOpenChange(false)}>
               Cancel
             </Button>
+          </HelpTip>
+          {/* Button's own disabled:pointer-events-none would swallow hover, so
+              the tip sits on a wrapping span rather than the Button itself. */}
           <HelpTip label={remainingCharsTip(notes.trim().length, _CEO_NOTES_MIN)}>
+            <span className="inline-block" tabIndex={tooShort ? 0 : undefined}>
               <Button onClick={handleConfirm} disabled={tooShort || isPending}>
                 {isPending ? "Approving..." : "Approve & Merge"}
               </Button>
+            </span>
           </HelpTip>
         </DialogFooter>
       </DialogContent>
@@ -344,10 +378,15 @@ export function RequiredNotesDialog({
           </div>
         </div>
         <DialogFooter>
+          <HelpTip label="Closes without confirming; nothing is changed">
             <Button variant="outline" onClick={() => handleOpenChange(false)}>
               Cancel
             </Button>
+          </HelpTip>
+          {/* Button's own disabled:pointer-events-none would swallow hover, so
+              the tip sits on a wrapping span rather than the Button itself. */}
           <HelpTip label={remainingCharsTip(text.trim().length, minChars)}>
+            <span className="inline-block" tabIndex={tooShort ? 0 : undefined}>
               <Button
                 variant={destructive ? "destructive" : "default"}
                 onClick={handleConfirm}
@@ -355,6 +394,7 @@ export function RequiredNotesDialog({
               >
                 {isPending ? "Working..." : confirmLabel}
               </Button>
+            </span>
           </HelpTip>
         </DialogFooter>
       </DialogContent>
@@ -401,7 +441,11 @@ export function CreateBranchDialog({
         </DialogHeader>
         <div className="grid gap-4 py-4">
           <div className="grid gap-2">
-            <Label htmlFor="branch-type">Branch Type</Label>
+            <HelpTip label="Chooses the branch-name prefix — see the naming preview below">
+              <Label htmlFor="branch-type" className="w-fit">
+                Branch Type
+              </Label>
+            </HelpTip>
             <Select value={branchType} onValueChange={setBranchType}>
               <SelectTrigger>
                 <SelectValue />
@@ -420,12 +464,16 @@ export function CreateBranchDialog({
           </div>
         </div>
         <DialogFooter>
+          <HelpTip label="Closes without creating a branch">
             <Button variant="outline" onClick={() => handleOpenChange(false)}>
               Cancel
             </Button>
+          </HelpTip>
+          <HelpTip label="Creates and checks out the branch immediately — no confirmation after this">
             <Button onClick={handleConfirm} disabled={isPending}>
               {isPending ? "Creating..." : "Create Branch"}
             </Button>
+          </HelpTip>
         </DialogFooter>
       </DialogContent>
     </Dialog>
@@ -482,7 +530,11 @@ export function CreatePRDialog({
         </DialogHeader>
         <div className="grid gap-4 py-4">
           <div className="grid gap-2">
-            <Label htmlFor="pr-title">Title</Label>
+            <HelpTip label="Seeded from the task title by default — edit before creating">
+              <Label htmlFor="pr-title" className="w-fit">
+                Title
+              </Label>
+            </HelpTip>
             <Input
               id="pr-title"
               value={title}
@@ -491,7 +543,11 @@ export function CreatePRDialog({
             />
           </div>
           <div className="grid gap-2">
-            <Label htmlFor="pr-body">Description</Label>
+            <HelpTip label="Becomes the pull request's description on GitHub">
+              <Label htmlFor="pr-body" className="w-fit">
+                Description
+              </Label>
+            </HelpTip>
             <Textarea
               id="pr-body"
               value={body}
@@ -502,12 +558,24 @@ export function CreatePRDialog({
           </div>
         </div>
         <DialogFooter>
+          <HelpTip label="Closes without creating a PR">
             <Button variant="outline" onClick={() => handleOpenChange(false)}>
               Cancel
             </Button>
-          <Button onClick={handleConfirm} disabled={!title.trim() || isPending}>
+          </HelpTip>
+          <HelpTip label={!title.trim() ? "Enter a title to enable" : null}>
+            <span
+              className="inline-block"
+              tabIndex={!title.trim() ? 0 : undefined}
+            >
+              <Button
+                onClick={handleConfirm}
+                disabled={!title.trim() || isPending}
+              >
                 {isPending ? "Creating..." : "Create PR"}
               </Button>
+            </span>
+          </HelpTip>
         </DialogFooter>
       </DialogContent>
     </Dialog>

panel/src/components/tasks/task-detail/task-breadcrumb.tsx

@@ -3,6 +3,7 @@
 import { Task } from "@/types";
 import { useTask } from "@/hooks/use-tasks";
 import { Skeleton } from "@/components/ui/skeleton";
+import { HelpTip } from "@/components/ui/help-tip";
 import { ChevronRight } from "lucide-react";
 import Link from "next/link";
 
@@ -28,6 +29,7 @@ export function TaskBreadcrumb({ task }: TaskBreadcrumbProps) {
       {isLoading || !parent ? (
         <Skeleton className="h-4 w-32" />
       ) : (
+        <HelpTip label="Go to the parent task — only the immediate parent is shown here, not the full ancestry chain">
           <Link
             href={`/tasks/${parent.id}`}
             prefetch={false}
@@ -36,6 +38,7 @@ export function TaskBreadcrumb({ task }: TaskBreadcrumbProps) {
           >
             {parent.title}
           </Link>
+        </HelpTip>
       )}
       <ChevronRight className="h-3.5 w-3.5 shrink-0" />
       <span className="truncate text-foreground/70" title={task.title}>

panel/src/components/tasks/task-detail/task-description.tsx

@@ -189,7 +189,9 @@ export function TaskDescription({ task }: TaskDescriptionProps) {
           defaultOpen={false}
           title={
             <>
+              <HelpTip label="Read-only architectural rules derived from the project's conventions — auto-attached, not editable here">
                 <ShieldAlert className="h-4 w-4 text-amber-600 dark:text-amber-400" />
+              </HelpTip>
               <span className="text-amber-800 dark:text-amber-300">
                 Constraints
               </span>

panel/src/components/tasks/task-detail/task-header.tsx

@@ -56,6 +56,7 @@ import {
 import { toast } from "sonner";
 import { TaskTypeBadge } from "../task-type-badge";
 import { CopyButton } from "@/components/ui/copy-button";
+import { HelpTip } from "@/components/ui/help-tip";
 import {
   Tooltip,
   TooltipContent,
@@ -117,6 +118,55 @@ const statusLabels: Record<TaskStatus, string> = {
   [TaskStatus.CANCELLED]: "Cancelled",
 };
 
+// Per-action explanation of the real backend consequence — grounded in
+// roboco/foundation/policy/lifecycle.py (ActionSpec/IntentSpec source +
+// target statuses, allowed_roles) and the handlers in
+// app/(dashboard)/tasks/[taskId]/page.tsx (handleAction). Some of these
+// route through an admin-override PATCH rather than a dedicated lifecycle
+// verb — the tip says so where that's the case.
+const ACTION_TIPS: Record<string, string> = {
+  claim: "Locks this task to you so no one else can claim it (pending → claimed).",
+  start: "Begins active work on the task (claimed → in_progress).",
+  "create-branch":
+    "Creates the git branch for this task; status does not change.",
+  pause:
+    "Pauses active work (in_progress → paused); use Resume to continue later.",
+  block:
+    "Flags an external blocker (in_progress → blocked); only a PM can unblock it.",
+  "create-pr":
+    "Opens the pull request for this task's branch; status does not change.",
+  verify: "Marks work self-verified, the step before QA (in_progress → verifying).",
+  unblock: "PM-only: clears the blocker and resumes work (blocked → in_progress).",
+  resume: "Resumes paused work (paused → in_progress).",
+  "submit-qa": "Hands the task to QA for review (verifying → awaiting_qa).",
+  "pass-qa":
+    "QA-only: passes review and starts docs (awaiting_qa → awaiting_documentation).",
+  "fail-qa":
+    "QA-only: sends the task back to the developer (awaiting_qa → needs_revision).",
+  "docs-complete":
+    "Documenter-only: marks docs done, moves to PM review (→ awaiting_pm_review).",
+  "submit-pm-review":
+    "Sends the finished work to the PM for merge review (→ awaiting_pm_review).",
+  complete:
+    "PM-only: approves and marks the task completed (awaiting_pm_review → completed).",
+  "escalate-to-ceo":
+    "Sends this task to the CEO for final sign-off (→ awaiting_ceo_approval).",
+  "request-changes":
+    "Sends the task back to the developer for changes (→ needs_revision).",
+  "ceo-approve":
+    "CEO-only: approves and completes the task (→ completed); requires a note.",
+  "approve-and-merge":
+    "CEO-only: merges the PR and marks the task completed in one step.",
+  "ceo-reject": "CEO-only: sends the task back for revision (→ needs_revision).",
+  reopen: "Admin override: force-sets a cancelled task back to pending.",
+  activate: "PM-only: releases the task from backlog into the claim pool (→ pending).",
+  "start-revision":
+    "Admin override: forces the task straight to in_progress, skipping re-claim.",
+  cancel: "PM/CEO-only: cancels the task permanently; requires a documented reason.",
+  "merge-pr":
+    "Merges this task's PR on GitHub; the backend updates task state as a side effect.",
+};
+
 interface TaskHeaderProps {
   task: Task;
   onAction?: (action: string) => void;
@@ -515,13 +565,14 @@ export function TaskHeader({ task, onAction, nav }: TaskHeaderProps) {
                 disabled={updateTask.isPending}
               />
             ) : (
+              <HelpTip label={`Click to rename — full title: "${task.title}"`}>
                 <h1
                   className="text-2xl font-bold cursor-pointer hover:bg-muted/50 px-2 py-1 -mx-2 rounded transition-colors truncate"
                   onClick={startEditingTitle}
-                title={task.title}
                 >
                   {task.title}
                 </h1>
+              </HelpTip>
             )}
 
             {/* Row 2: copyable task id + status + team + type. The dropdowns are
@@ -530,13 +581,12 @@ export function TaskHeader({ task, onAction, nav }: TaskHeaderProps) {
                 flex-wrap: on narrow viewports the id/status/team/type group
                 wraps to further rows instead of overflowing horizontally. */}
             <div className="flex flex-wrap items-center gap-2 mt-1.5">
-              <span
+              <HelpTip label={`Full task ID: ${task.id}`}>
-                className="inline-flex h-7 shrink-0 items-center gap-1 rounded-md border bg-muted/40 px-2.5 font-mono text-sm text-muted-foreground"
+                <span className="inline-flex h-7 shrink-0 items-center gap-1 rounded-md border bg-muted/40 px-2.5 font-mono text-sm text-muted-foreground">
-                title={task.id}
-              >
                   #{task.id.slice(0, 8)}
                   <CopyButton value={task.id} className="-mr-1 px-1 py-0" />
                 </span>
+              </HelpTip>
 
               <span className="text-muted-foreground shrink-0">|</span>
 
@@ -669,23 +719,27 @@ export function TaskHeader({ task, onAction, nav }: TaskHeaderProps) {
                 </TooltipContent>
               </Tooltip>
               <DropdownMenuContent align="end">
-                {/* Lifecycle actions (non-cancel) */}
+                {/* Lifecycle actions (non-cancel) — each tip states the real
+                    source→target status transition and which role can fire
+                    it, grounded in lifecycle.py's ActionSpec/IntentSpec table. */}
                 {actions
                   .filter((a) => a.action !== "cancel")
                   .map((action) => (
+                    <HelpTip key={action.action} label={ACTION_TIPS[action.action]}>
                       <DropdownMenuItem
-                      key={action.action}
                         onClick={() => handleAction(action.action)}
                       >
                         {action.icon}
                         {action.label}
                       </DropdownMenuItem>
+                    </HelpTip>
                   ))}
 
                 {/* Cancel action */}
                 {actions.some((a) => a.action === "cancel") && (
                   <>
                     <DropdownMenuSeparator />
+                    <HelpTip label={ACTION_TIPS.cancel}>
                       <DropdownMenuItem
                         onClick={() => handleAction("cancel")}
                         className="text-orange-600"
@@ -693,11 +747,13 @@ export function TaskHeader({ task, onAction, nav }: TaskHeaderProps) {
                         <XCircle className="h-4 w-4 mr-2" />
                         Cancel Task
                       </DropdownMenuItem>
+                    </HelpTip>
                   </>
                 )}
 
                 {/* Delete option */}
                 <DropdownMenuSeparator />
+                <HelpTip label="Permanently deletes this task record from the database; cannot be undone.">
                   <DropdownMenuItem
                     onClick={() => setDeleteOpen(true)}
                     className="text-red-600"
@@ -705,6 +761,7 @@ export function TaskHeader({ task, onAction, nav }: TaskHeaderProps) {
                     <Trash2 className="h-4 w-4 mr-2" />
                     Delete Task
                   </DropdownMenuItem>
+                </HelpTip>
               </DropdownMenuContent>
             </DropdownMenu>
           )}

panel/src/components/tasks/task-detail/task-metadata.tsx

@@ -31,6 +31,7 @@ import {
 import { toast } from "sonner";
 import { getAgentDisplayName, resolveToSlug } from "@/lib/agent-utils";
 import { branchUrl } from "@/lib/repo-url";
+import { formatAbsoluteTimestamp } from "@/lib/utils";
 import { CopyButton } from "@/components/ui/copy-button";
 import { HelpTip } from "@/components/ui/help-tip";
 import { TaskTypeBadge } from "../task-type-badge";
@@ -232,6 +233,7 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             <AlertTriangle className="h-4 w-4" />
             Priority
           </div>
+          <HelpTip label="How urgently this should be worked — P0 is highest, P3 is lowest">
             <Select
               value={task.priority.toString()}
               onValueChange={handlePriorityChange}
@@ -254,6 +256,7 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
                 ))}
               </SelectContent>
             </Select>
+          </HelpTip>
         </CardContent>
       </Card>
 
@@ -264,6 +267,7 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             <Target className="h-4 w-4" />
             Complexity
           </div>
+          <HelpTip label="A manual estimate of implementation effort; not derived from the plan or ACs">
             <Select
               value={task.estimated_complexity}
               onValueChange={handleComplexityChange}
@@ -280,6 +284,7 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
                 ))}
               </SelectContent>
             </Select>
+          </HelpTip>
         </CardContent>
       </Card>
 
@@ -302,13 +307,14 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
               disabled={updateTask.isPending}
             />
           ) : (
+            <HelpTip label="Click to reassign — enter an agent slug (e.g. be-dev-1), or clear to unassign">
               <span
                 className="font-medium cursor-pointer hover:bg-muted/50 px-2 py-1 -mx-2 rounded transition-colors inline-block"
                 onClick={startEditingAssigned}
-              title="Click to edit"
               >
                 {getAgentDisplayName(task.assigned_to)}
               </span>
+            </HelpTip>
           )}
         </CardContent>
       </Card>
@@ -320,9 +326,11 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             <User className="h-4 w-4" />
             Created By
           </div>
+          <HelpTip label="The agent or human who originally created this task record">
             <span className="font-medium">
               {getAgentDisplayName(task.created_by)}
             </span>
+          </HelpTip>
         </CardContent>
       </Card>
 
@@ -348,9 +356,17 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             <Calendar className="h-4 w-4" />
             Created
           </div>
+          <HelpTip
+            label={
+              task.created_at
+                ? `Exact timestamp: ${formatAbsoluteTimestamp(task.created_at)}`
+                : ""
+            }
+          >
             <span className="font-medium">
               {formatRelativeTime(task.created_at)}
             </span>
+          </HelpTip>
         </CardContent>
       </Card>
 
@@ -361,9 +377,17 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             <Clock className="h-4 w-4" />
             Started
           </div>
+          <HelpTip
+            label={
+              task.started_at
+                ? `Exact timestamp: ${formatAbsoluteTimestamp(task.started_at)}`
+                : ""
+            }
+          >
             <span className="font-medium">
               {formatRelativeTime(task.started_at)}
             </span>
+          </HelpTip>
         </CardContent>
       </Card>
 
@@ -386,13 +410,14 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
               disabled={updateTask.isPending}
             />
           ) : (
+            <HelpTip label="Click to set/change the target completion date">
               <span
                 className="font-medium cursor-pointer hover:bg-muted/50 px-2 py-1 -mx-2 rounded transition-colors inline-block"
                 onClick={startEditingTargetDate}
-              title="Click to edit"
               >
                 {task.target_date ? formatDate(task.target_date) : "Not set"}
               </span>
+            </HelpTip>
           )}
         </CardContent>
       </Card>
@@ -404,9 +429,17 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             <Clock className="h-4 w-4" />
             Completed
           </div>
+          <HelpTip
+            label={
+              task.completed_at
+                ? `Exact timestamp: ${formatAbsoluteTimestamp(task.completed_at)}`
+                : ""
+            }
+          >
             <span className="font-medium">
               {formatRelativeTime(task.completed_at)}
             </span>
+          </HelpTip>
         </CardContent>
       </Card>
 
@@ -462,21 +495,24 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             </div>
             <div className="flex items-center gap-1">
               {branchHref ? (
+                <HelpTip label="Open this branch on GitHub in a new tab">
                   <a
                     href={branchHref}
                     target="_blank"
                     rel="noopener noreferrer"
-                  title="Open branch in GitHub"
                     className="inline-flex transition-opacity hover:opacity-80"
                   >
                     <Badge variant="outline" className="font-mono text-sm">
                       {task.branch_name}
                     </Badge>
                   </a>
+                </HelpTip>
               ) : (
+                <HelpTip label="The git branch for this task; no project git_url configured to link out to it">
                   <Badge variant="outline" className="font-mono text-sm">
                     {task.branch_name}
                   </Badge>
+                </HelpTip>
               )}
               <CopyButton value={task.branch_name} />
             </div>
@@ -493,6 +529,7 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
               Pull Request
             </div>
             {task.pr_url ? (
+              <HelpTip label="Opens this task's pull request on GitHub in a new tab">
                 <a
                   href={task.pr_url}
                   target="_blank"
@@ -502,8 +539,11 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
                   PR #{task.pr_number}
                   <ExternalLink className="h-3 w-3" />
                 </a>
+              </HelpTip>
             ) : (
+              <HelpTip label="PR number on record; no pr_url stored to link out to it">
                 <span className="font-medium">#{task.pr_number}</span>
+              </HelpTip>
             )}
           </CardContent>
         </Card>
@@ -517,6 +557,7 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
             Project
           </div>
           {task.project_id && project ? (
+            <HelpTip label="Opens the Projects list (not a deep link to this specific project)">
               <Link
                 prefetch={false}
                 href={`/projects`}
@@ -524,8 +565,11 @@ export function TaskMetadata({ task }: TaskMetadataProps) {
               >
                 {project.name}
               </Link>
+            </HelpTip>
           ) : (
+            <HelpTip label="This task has no associated project">
               <span className="font-medium text-muted-foreground">-</span>
+            </HelpTip>
           )}
         </CardContent>
       </Card>

panel/src/components/tasks/task-detail/work-session-card.tsx

@@ -191,7 +191,8 @@ export function WorkSessionCard({ taskId }: WorkSessionCardProps) {
               {session.branch_name}
             </code>
           </div>
-          <div className="flex items-center gap-2 text-sm text-muted-foreground">
+          <HelpTip label="Base is the branch this session forked from; target is where its PR merges into">
+            <div className="flex items-center gap-2 text-sm text-muted-foreground w-fit">
               <span>Base:</span>
               <code className="bg-muted px-1.5 py-0.5 rounded text-xs font-mono">
                 {session.base_branch}
@@ -201,6 +202,7 @@ export function WorkSessionCard({ taskId }: WorkSessionCardProps) {
                 {session.target_branch}
               </code>
             </div>
+          </HelpTip>
         </div>
 
         {/* PR Info */}
@@ -226,6 +228,7 @@ export function WorkSessionCard({ taskId }: WorkSessionCardProps) {
               </div>
             </div>
             {session.pr_url && (
+              <HelpTip label="Opens the pull request on GitHub in a new tab">
                 <Button variant="outline" size="sm" asChild>
                   <a
                     href={session.pr_url}
@@ -236,26 +239,31 @@ export function WorkSessionCard({ taskId }: WorkSessionCardProps) {
                     View PR
                   </a>
                 </Button>
+              </HelpTip>
             )}
           </div>
         )}
 
         {/* Stats Row */}
         <div className="flex items-center gap-4 pt-2">
-          <div className="flex items-center gap-2">
+          <HelpTip label="Commits recorded against this branch's work session">
+            <div className="flex items-center gap-2 w-fit">
               <GitCommit className="h-4 w-4 text-muted-foreground" />
               <span className="text-sm">
                 {session.commits.length} commit
                 {session.commits.length !== 1 ? "s" : ""}
               </span>
             </div>
-          <div className="flex items-center gap-2">
+          </HelpTip>
+          <HelpTip label="Distinct files touched across this session's commits">
+            <div className="flex items-center gap-2 w-fit">
               <FileCode className="h-4 w-4 text-muted-foreground" />
               <span className="text-sm">
                 {session.files_modified.length} file
                 {session.files_modified.length !== 1 ? "s" : ""}
               </span>
             </div>
+          </HelpTip>
           <HelpTip label={formatAbsoluteTimestamp(session.started_at)}>
             <div className="text-sm text-muted-foreground ml-auto w-fit">
               Started{" "}
@@ -268,12 +276,14 @@ export function WorkSessionCard({ taskId }: WorkSessionCardProps) {
 
         {/* View Full Session Link */}
         <div className="flex justify-end pt-2">
+          <HelpTip label="Opens the full work-session record — branch, every commit, and status history">
             <Link href={`/work-sessions/${session.id}`} prefetch={false}>
               <Button variant="outline" size="sm" className="gap-2">
                 <ExternalLink className="h-3 w-3" />
                 View Details
               </Button>
             </Link>
+          </HelpTip>
         </div>
       </CardContent>
     </Card>

panel/src/components/tasks/task-filters.tsx

@@ -143,15 +143,18 @@ export function TaskFilters({
       <CardContent className="pt-6">
         <div className="flex flex-col sm:flex-row gap-4">
           <div className="flex-1">
+            <HelpTip label="Debounced server-side search across title, description, and task ID prefix.">
               <Input
                 placeholder="Search tasks..."
                 value={searchQuery}
                 onChange={(e) => onSearchChange(e.target.value)}
               />
+            </HelpTip>
           </div>
           <div className="flex flex-wrap gap-2">
             {/* Status Multi-Select */}
             <Popover>
+              <HelpTip label="Multi-select — pick any number of statuses; the list shows tasks matching any of them.">
                 <PopoverTrigger asChild>
                   <Button variant="outline" className="min-w-32 justify-between">
                     <span className="truncate">
@@ -164,6 +167,7 @@ export function TaskFilters({
                     <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
                   </Button>
                 </PopoverTrigger>
+              </HelpTip>
               <PopoverContent className="w-56 p-2" align="start">
                 <div className="flex items-center justify-between mb-2 pb-2 border-b">
                   <span className="text-sm font-medium">Status</span>
@@ -197,6 +201,7 @@ export function TaskFilters({
 
             {/* Team Multi-Select */}
             <Popover>
+              <HelpTip label="Multi-select — pick any number of teams; the list shows tasks matching any of them.">
                 <PopoverTrigger asChild>
                   <Button variant="outline" className="min-w-32 justify-between">
                     <span className="truncate">
@@ -209,6 +214,7 @@ export function TaskFilters({
                     <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
                   </Button>
                 </PopoverTrigger>
+              </HelpTip>
               <PopoverContent className="w-48 p-2" align="start">
                 <div className="flex items-center justify-between mb-2 pb-2 border-b">
                   <span className="text-sm font-medium">Team</span>
@@ -243,6 +249,7 @@ export function TaskFilters({
             {/* Task Type Multi-Select (optional) */}
             {onTaskTypeChange && (
               <Popover>
+                <HelpTip label="Multi-select — pick any number of task types; the list shows tasks matching any of them.">
                   <PopoverTrigger asChild>
                     <Button
                       variant="outline"
@@ -258,6 +265,7 @@ export function TaskFilters({
                       <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
                     </Button>
                   </PopoverTrigger>
+                </HelpTip>
                 <PopoverContent className="w-48 p-2" align="start">
                   <div className="flex items-center justify-between mb-2 pb-2 border-b">
                     <span className="text-sm font-medium">Task Type</span>
@@ -295,6 +303,7 @@ export function TaskFilters({
             {/* Project Multi-Select (optional) */}
             {onProjectChange && projectOptions.length > 0 && (
               <Popover>
+                <HelpTip label="Multi-select — pick any number of projects; the list shows tasks matching any of them.">
                   <PopoverTrigger asChild>
                     <Button
                       variant="outline"
@@ -310,6 +319,7 @@ export function TaskFilters({
                       <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
                     </Button>
                   </PopoverTrigger>
+                </HelpTip>
                 <PopoverContent className="w-56 p-2" align="start">
                   <div className="flex items-center justify-between mb-2 pb-2 border-b">
                     <span className="text-sm font-medium">Project</span>
@@ -345,6 +355,7 @@ export function TaskFilters({
             {/* Product Multi-Select (optional) */}
             {onProductChange && productOptions.length > 0 && (
               <Popover>
+                <HelpTip label="Multi-select — pick any number of products; the list shows tasks matching any of them.">
                   <PopoverTrigger asChild>
                     <Button
                       variant="outline"
@@ -360,6 +371,7 @@ export function TaskFilters({
                       <ChevronDown className="ml-2 h-4 w-4 shrink-0 opacity-50" />
                     </Button>
                   </PopoverTrigger>
+                </HelpTip>
                 <PopoverContent className="w-56 p-2" align="start">
                   <div className="flex items-center justify-between mb-2 pb-2 border-b">
                     <span className="text-sm font-medium">Product</span>
@@ -466,6 +478,7 @@ export function TaskFilters({
               taskTypeFilter.length > 0 ||
               projectFilter.length > 0 ||
               productFilter.length > 0) && (
+              <HelpTip label="Removes every active filter above, restoring the unfiltered task list.">
                 <Button
                   variant="ghost"
                   size="sm"
@@ -480,6 +493,7 @@ export function TaskFilters({
                 >
                   Clear all
                 </Button>
+              </HelpTip>
             )}
           </div>
         )}

panel/src/components/tasks/task-selector.tsx

@@ -151,10 +151,12 @@ export function TaskSelector({
       <SelectContent className="max-h-[300px]">
         {allowClear && value && (
           <SelectItem value="__clear__" className="text-muted-foreground">
+            <HelpTip label="Clears the parent link — this becomes a standalone root task.">
               <span className="flex items-center gap-2">
                 <X className="h-4 w-4" />
                 No parent (standalone task)
               </span>
+            </HelpTip>
           </SelectItem>
         )}
 

panel/src/components/tasks/task-table.tsx

@@ -244,16 +244,20 @@ function SortableHeader({
 
   return (
     <TableHead className={className}>
+      <HelpTip label="Sorts ascending, then descending, then clears — click again to cycle.">
         <Button
           onClick={() => onSort(field)}
           variant="ghost"
           className="h-auto -ml-2 px-2 py-1 gap-1 font-normal"
         >
           {label}
-        {!isActive && <ArrowUpDown className="h-4 w-4 text-muted-foreground" />}
+          {!isActive && (
+            <ArrowUpDown className="h-4 w-4 text-muted-foreground" />
+          )}
           {direction === "asc" && <ArrowUp className="h-4 w-4" />}
           {direction === "desc" && <ArrowDown className="h-4 w-4" />}
         </Button>
+      </HelpTip>
     </TableHead>
   );
 }
@@ -473,6 +477,7 @@ export function TaskTable({
         {hasAnyChildren && !isLoading && (
           <div className="flex items-center gap-2 px-4 py-2 border-b bg-muted/30">
             <span className="text-sm text-muted-foreground">Tree view:</span>
+            <HelpTip label="Opens every parent row so all subtasks show inline, ignoring current sort.">
               <Button
                 variant="ghost"
                 size="sm"
@@ -481,6 +486,8 @@ export function TaskTable({
               >
                 Expand all
               </Button>
+            </HelpTip>
+            <HelpTip label="Hides every subtask row, showing only root-level tasks.">
               <Button
                 variant="ghost"
                 size="sm"
@@ -489,6 +496,7 @@ export function TaskTable({
               >
                 Collapse all
               </Button>
+            </HelpTip>
           </div>
         )}
 
@@ -510,7 +518,9 @@ export function TaskTable({
                     onSort={handleSort}
                     className="whitespace-nowrap"
                   />
+                  <HelpTip label="Branch, PR, or docs/PR progress — whichever this task's git workflow has reached.">
                     <TableHead className="whitespace-nowrap">Git</TableHead>
+                  </HelpTip>
                   <SortableHeader
                     label="Team"
                     field="team"
@@ -518,9 +528,11 @@ export function TaskTable({
                     onSort={handleSort}
                     className="whitespace-nowrap"
                   />
+                  <HelpTip label="A direct Project shows its name; a fan-out task shows its Product instead.">
                     <TableHead className="whitespace-nowrap">
                       Project / Product
                     </TableHead>
+                  </HelpTip>
                   <SortableHeader
                     label="Priority"
                     field="priority"
@@ -589,6 +601,13 @@ export function TaskTable({
                             style={{ paddingLeft: `${node.depth * 1.5}rem` }}
                           >
                             {hasChildren ? (
+                              <HelpTip
+                                label={
+                                  isExpanded
+                                    ? "Hides this task's subtasks"
+                                    : "Shows this task's subtasks inline"
+                                }
+                              >
                                 <Button
                                   onClick={() => toggleExpand(task.id)}
                                   variant="ghost"
@@ -602,6 +621,7 @@ export function TaskTable({
                                     <ChevronRightIcon className="h-4 w-4" />
                                   )}
                                 </Button>
+                              </HelpTip>
                             ) : (
                               <span className="w-5 shrink-0" />
                             )}
@@ -625,6 +645,7 @@ export function TaskTable({
                                   </HelpTip>
                                 )}
                                 {childCount > 0 && (
+                                  <HelpTip label="Direct subtasks under this task, regardless of their current status.">
                                     <Badge
                                       variant="secondary"
                                       className="text-xs shrink-0"
@@ -632,6 +653,7 @@ export function TaskTable({
                                       {childCount} subtask
                                       {childCount !== 1 ? "s" : ""}
                                     </Badge>
+                                  </HelpTip>
                                 )}
                               </div>
                             </Link>
@@ -677,14 +699,28 @@ export function TaskTable({
                           </Badge>
                         </TableCell>
                         <TableCell className="whitespace-nowrap">
+                          <HelpTip
+                            label={
+                              task.assigned_to
+                                ? "The agent currently pinned to this task."
+                                : "No agent pinned — the orchestrator routes it by role and availability."
+                            }
+                          >
                             <Badge variant="outline">
                               {getAgentDisplayName(task.assigned_to)}
                             </Badge>
+                          </HelpTip>
                         </TableCell>
                         <TableCell className="text-muted-foreground text-sm whitespace-nowrap">
+                          <HelpTip
+                            label={new Date(task.created_at).toLocaleString()}
+                          >
+                            <span>
                               {formatDistanceToNow(new Date(task.created_at), {
                                 addSuffix: true,
                               })}
+                            </span>
+                          </HelpTip>
                         </TableCell>
                         <TableCell>
                           <TaskActions task={task} />
@@ -720,6 +756,13 @@ export function TaskTable({
                         <div className="min-w-0 flex-1">
                           <div className="flex items-center gap-1.5">
                             {hasChildren && (
+                              <HelpTip
+                                label={
+                                  isExpanded
+                                    ? "Hides this task's subtasks"
+                                    : "Shows this task's subtasks inline"
+                                }
+                              >
                                 <Button
                                   onClick={() => toggleExpand(task.id)}
                                   variant="ghost"
@@ -733,6 +776,7 @@ export function TaskTable({
                                     <ChevronRightIcon className="h-4 w-4" />
                                   )}
                                 </Button>
+                              </HelpTip>
                             )}
                             <Link
                               prefetch={false}
@@ -757,10 +801,12 @@ export function TaskTable({
                                 </HelpTip>
                               )}
                               {childCount > 0 && (
+                                <HelpTip label="Direct subtasks under this task, regardless of their current status.">
                                   <Badge variant="secondary" className="text-xs">
                                     {childCount} subtask
                                     {childCount !== 1 ? "s" : ""}
                                   </Badge>
+                                </HelpTip>
                               )}
                             </div>
                           ) : null}
@@ -805,14 +851,28 @@ export function TaskTable({
                           </Badge>
                         </ResponsiveTableCardRow>
                         <ResponsiveTableCardRow label="Assigned">
+                          <HelpTip
+                            label={
+                              task.assigned_to
+                                ? "The agent currently pinned to this task."
+                                : "No agent pinned — the orchestrator routes it by role and availability."
+                            }
+                          >
                             <Badge variant="outline">
                               {getAgentDisplayName(task.assigned_to)}
                             </Badge>
+                          </HelpTip>
                         </ResponsiveTableCardRow>
                         <ResponsiveTableCardRow label="Created">
+                          <HelpTip
+                            label={new Date(task.created_at).toLocaleString()}
+                          >
+                            <span>
                               {formatDistanceToNow(new Date(task.created_at), {
                                 addSuffix: true,
                               })}
+                            </span>
+                          </HelpTip>
                         </ResponsiveTableCardRow>
                       </div>
                     </ResponsiveTableCard>
@@ -827,7 +887,9 @@ export function TaskTable({
         {!isLoading && tasks && tasks.length > 0 && (
           <div className="flex flex-wrap items-center justify-end gap-4 px-4 py-3 border-t">
             <div className="flex items-center gap-2 text-sm text-muted-foreground">
+              <HelpTip label="How many rows show per page; resets to page 1 when changed.">
                 <span>Rows:</span>
+              </HelpTip>
               <Select
                 value={String(pageSize)}
                 onValueChange={handlePageSizeChange}
@@ -844,10 +906,17 @@ export function TaskTable({
                 </SelectContent>
               </Select>
             </div>
+            <HelpTip label="Range within the current filtered/sorted, flattened tree view — not the total unfiltered task count.">
               <span className="text-sm text-muted-foreground">
                 {startIndex + 1}-{endIndex} of {totalItems}
               </span>
+            </HelpTip>
             <div className="flex items-center gap-1">
+              <HelpTip label="Previous page.">
+                <span
+                  className="inline-block"
+                  tabIndex={currentPage === 1 ? 0 : undefined}
+                >
                   <Button
                     variant="outline"
                     size="icon"
@@ -858,6 +927,13 @@ export function TaskTable({
                   >
                     <ChevronLeft className="h-4 w-4" />
                   </Button>
+                </span>
+              </HelpTip>
+              <HelpTip label="Next page.">
+                <span
+                  className="inline-block"
+                  tabIndex={currentPage === totalPages ? 0 : undefined}
+                >
                   <Button
                     variant="outline"
                     size="icon"
@@ -868,6 +944,8 @@ export function TaskTable({
                   >
                     <ChevronRight className="h-4 w-4" />
                   </Button>
+                </span>
+              </HelpTip>
             </div>
           </div>
         )}

panel/src/components/tasks/task-type-badge.tsx

@@ -2,11 +2,7 @@
 
 import { TaskType } from "@/types";
 import { Badge } from "@/components/ui/badge";
-import {
+import { HelpTip } from "@/components/ui/help-tip";
-  Tooltip,
-  TooltipContent,
-  TooltipTrigger,
-} from "@/components/ui/tooltip";
 import {
   Code,
   FileText,
@@ -22,6 +18,18 @@ interface TaskTypeBadgeProps {
   className?: string;
 }
 
+// What each task type classifies as its artifact kind. Every type still
+// follows the identical full git workflow (branch, commits, PR) — this is
+// classification only, not a different pipeline.
+const TYPE_DESCRIPTIONS: Record<TaskType, string> = {
+  [TaskType.CODE]: "Source code changes.",
+  [TaskType.DOCUMENTATION]: "Documentation updates.",
+  [TaskType.RESEARCH]: "Research findings, committed as notes.",
+  [TaskType.PLANNING]: "Plans or architecture, committed as docs.",
+  [TaskType.DESIGN]: "Designs or specs, committed as assets.",
+  [TaskType.ADMINISTRATIVE]: "Process docs, committed as notes.",
+};
+
 const TYPE_CONFIG: Record<
   TaskType,
   { label: string; icon: React.ReactNode; color: string }
@@ -71,16 +79,13 @@ export function TaskTypeBadge({
   if (!config) return null;
 
   return (
-    <Tooltip>
+    <HelpTip label={TYPE_DESCRIPTIONS[type]}>
-      <TooltipTrigger asChild>
       <Badge variant="outline" className={`${config.color} ${className}`}>
         <span className="flex items-center gap-1">
           {config.icon}
           {showLabel && <span>{config.label}</span>}
         </span>
       </Badge>
-      </TooltipTrigger>
+    </HelpTip>
-      <TooltipContent>Task type: {config.label}</TooltipContent>
-    </Tooltip>
   );
 }

panel/src/components/work-sessions/work-session-filters.tsx

@@ -13,6 +13,7 @@ import {
 import { Badge } from "@/components/ui/badge";
 import { Search, Filter, X } from "lucide-react";
 import { WorkSessionStatus } from "@/types";
+import { HelpTip } from "@/components/ui/help-tip";
 
 interface WorkSessionFiltersProps {
   searchQuery: string;
@@ -21,10 +22,22 @@ interface WorkSessionFiltersProps {
   onStatusChange: (value: WorkSessionStatus[]) => void;
 }
 
-const statuses: { value: WorkSessionStatus; label: string }[] = [
+const statuses: { value: WorkSessionStatus; label: string; hint: string }[] = [
-  { value: WorkSessionStatus.ACTIVE, label: "Active" },
+  {
-  { value: WorkSessionStatus.COMPLETED, label: "Completed" },
+    value: WorkSessionStatus.ACTIVE,
-  { value: WorkSessionStatus.ABANDONED, label: "Abandoned" },
+    label: "Active",
+    hint: "An agent is currently working this branch.",
+  },
+  {
+    value: WorkSessionStatus.COMPLETED,
+    label: "Completed",
+    hint: "The session's PR was merged — the branch's work is done.",
+  },
+  {
+    value: WorkSessionStatus.ABANDONED,
+    label: "Abandoned",
+    hint: "Superseded by a re-claim, cancellation, or project deletion — never an auto-timeout.",
+  },
 ];
 
 export function WorkSessionFilters({
@@ -51,6 +64,7 @@ export function WorkSessionFilters({
   return (
     <div className="flex flex-col gap-4 sm:flex-row sm:items-center">
       {/* Search */}
+      <HelpTip label="Filters the table client-side by branch name substring — doesn't re-query the server.">
         <div className="relative flex-1 max-w-sm">
           <Search className="absolute left-3 top-1/2 h-4 w-4 -translate-y-1/2 text-muted-foreground" />
           <Input
@@ -60,9 +74,14 @@ export function WorkSessionFilters({
             className="pl-9"
           />
         </div>
+      </HelpTip>
 
       {/* Status Filter */}
       <DropdownMenu>
+        {/* DropdownMenuTrigger's asChild is safe to wrap directly (unlike
+            TabsTrigger/CollapsibleTrigger) — it carries no persistent visual
+            data-state of its own. */}
+        <HelpTip label="Show only sessions in the checked status(es). No selection shows every session.">
           <DropdownMenuTrigger asChild>
             <Button variant="outline" className="gap-2">
               <Filter className="h-4 w-4" />
@@ -74,6 +93,7 @@ export function WorkSessionFilters({
               )}
             </Button>
           </DropdownMenuTrigger>
+        </HelpTip>
         <DropdownMenuContent align="start" className="w-48">
           <DropdownMenuLabel>Filter by Status</DropdownMenuLabel>
           <DropdownMenuSeparator />
@@ -83,7 +103,9 @@ export function WorkSessionFilters({
               checked={statusFilter.includes(status.value)}
               onCheckedChange={() => handleStatusToggle(status.value)}
             >
-              {status.label}
+              <HelpTip label={status.hint}>
+                <span className="w-fit">{status.label}</span>
+              </HelpTip>
             </DropdownMenuCheckboxItem>
           ))}
         </DropdownMenuContent>
@@ -91,10 +113,12 @@ export function WorkSessionFilters({
 
       {/* Clear Filters */}
       {hasActiveFilters && (
+        <HelpTip label="Resets the search text and status filter — shows every work session again.">
           <Button variant="ghost" onClick={clearFilters} className="gap-2">
             <X className="h-4 w-4" />
             Clear
           </Button>
+        </HelpTip>
       )}
     </div>
   );

panel/src/components/work-sessions/work-session-table.tsx

@@ -24,6 +24,7 @@ import {
   ResponsiveTableCardRow,
 } from "@/components/ui/responsive-table";
 import { Skeleton } from "@/components/ui/skeleton";
+import { HelpTip } from "@/components/ui/help-tip";
 import {
   GitBranch,
   GitPullRequest,
@@ -40,6 +41,15 @@ interface WorkSessionTableProps {
   isLoading: boolean;
 }
 
+// Mirrors the status hints in work-session-filters.tsx's dropdown — grounded
+// in roboco/services/work_session.py's transition triggers.
+const STATUS_HINTS: Record<WorkSessionStatus, string> = {
+  active: "An agent is currently working this branch.",
+  completed: "The session's PR was merged — the branch's work is done.",
+  abandoned:
+    "Superseded by a re-claim, cancellation, or project deletion — never an auto-timeout.",
+};
+
 function getStatusBadge(status: WorkSessionStatus) {
   switch (status) {
     case "active":
@@ -68,6 +78,29 @@ function getStatusBadge(status: WorkSessionStatus) {
   }
 }
 
+function StatusBadge({ status }: { status: WorkSessionStatus }) {
+  return (
+    <HelpTip label={STATUS_HINTS[status]}>
+      <span className="w-fit">{getStatusBadge(status)}</span>
+    </HelpTip>
+  );
+}
+
+function PrBadge({ hasPr }: { hasPr: boolean }) {
+  return hasPr ? (
+    <HelpTip label="This session's branch has an open pull request on GitHub.">
+      <Badge className="bg-purple-500/10 text-purple-500 w-fit">
+        <GitPullRequest className="h-3 w-3 mr-1" />
+        PR Open
+      </Badge>
+    </HelpTip>
+  ) : (
+    <HelpTip label="No pull request opened yet for this session's branch.">
+      <span className="text-sm text-muted-foreground w-fit">No PR</span>
+    </HelpTip>
+  );
+}
+
 export function WorkSessionTable({
   sessions,
   isLoading,
@@ -115,6 +148,7 @@ export function WorkSessionTable({
                   <TableCell>
                     <div className="flex items-center gap-2">
                       <GitBranch className="h-4 w-4 text-muted-foreground" />
+                      <HelpTip label="Open this session's detail page.">
                         <Link
                           prefetch={false}
                           href={`/work-sessions/${session.id}`}
@@ -122,35 +156,36 @@ export function WorkSessionTable({
                         >
                           {session.branch_name}
                         </Link>
+                      </HelpTip>
                     </div>
                   </TableCell>
                   <TableCell>
+                    <HelpTip label={`Open task ${session.task_id}`}>
                       <Link
                         prefetch={false}
                         href={`/tasks/${session.task_id}`}
                         className="text-sm text-muted-foreground hover:text-foreground hover:underline"
-                      title={session.task_id}
                       >
                         {session.task_id.slice(0, 8)}...
                       </Link>
+                    </HelpTip>
                   </TableCell>
-                  <TableCell>{getStatusBadge(session.status)}</TableCell>
                   <TableCell>
-                    {session.has_pr ? (
+                    <StatusBadge status={session.status} />
-                      <Badge className="bg-purple-500/10 text-purple-500">
+                  </TableCell>
-                        <GitPullRequest className="h-3 w-3 mr-1" />
+                  <TableCell>
-                        PR Open
+                    <PrBadge hasPr={session.has_pr} />
-                      </Badge>
-                    ) : (
-                      <span className="text-sm text-muted-foreground">
-                        No PR
-                      </span>
-                    )}
                   </TableCell>
                   <TableCell className="text-sm text-muted-foreground">
+                    <HelpTip
+                      label={new Date(session.started_at).toLocaleString()}
+                    >
+                      <span className="w-fit">
                         {formatDistanceToNow(new Date(session.started_at), {
                           addSuffix: true,
                         })}
+                      </span>
+                    </HelpTip>
                   </TableCell>
                   <TableCell>
                     <Tooltip>
@@ -180,14 +215,17 @@ export function WorkSessionTable({
               <div className="flex items-start justify-between gap-2">
                 <div className="flex min-w-0 items-center gap-2">
                   <GitBranch className="h-4 w-4 shrink-0 text-muted-foreground" />
+                  <HelpTip
+                    label={`Open this session's detail page — ${session.branch_name}`}
+                  >
                     <Link
                       prefetch={false}
                       href={`/work-sessions/${session.id}`}
                       className="truncate font-mono text-sm font-medium hover:underline"
-                    title={session.branch_name}
                     >
                       {session.branch_name}
                     </Link>
+                  </HelpTip>
                 </div>
                 <Tooltip>
                   <TooltipTrigger asChild>
@@ -205,32 +243,32 @@ export function WorkSessionTable({
               </div>
               <div className="mt-3 divide-y">
                 <ResponsiveTableCardRow label="Task">
+                  <HelpTip label={`Open task ${session.task_id}`}>
                     <Link
                       prefetch={false}
                       href={`/tasks/${session.task_id}`}
                       className="text-muted-foreground hover:text-foreground hover:underline"
-                    title={session.task_id}
                     >
                       {session.task_id.slice(0, 8)}...
                     </Link>
+                  </HelpTip>
                 </ResponsiveTableCardRow>
                 <ResponsiveTableCardRow label="Status">
-                  {getStatusBadge(session.status)}
+                  <StatusBadge status={session.status} />
                 </ResponsiveTableCardRow>
                 <ResponsiveTableCardRow label="PR">
-                  {session.has_pr ? (
+                  <PrBadge hasPr={session.has_pr} />
-                    <Badge className="bg-purple-500/10 text-purple-500">
-                      <GitPullRequest className="h-3 w-3 mr-1" />
-                      PR Open
-                    </Badge>
-                  ) : (
-                    <span className="text-muted-foreground">No PR</span>
-                  )}
                 </ResponsiveTableCardRow>
                 <ResponsiveTableCardRow label="Started">
+                  <HelpTip
+                    label={new Date(session.started_at).toLocaleString()}
+                  >
+                    <span className="w-fit">
                       {formatDistanceToNow(new Date(session.started_at), {
                         addSuffix: true,
                       })}
+                    </span>
+                  </HelpTip>
                 </ResponsiveTableCardRow>
               </div>
             </ResponsiveTableCard>