From ff83378b26d01e5ffbfd3fd91b420ce6f18b43dd Mon Sep 17 00:00:00 2001
From: Dotta <bippadotta@protonmail.com>
Date: Sat, 7 Nov 2026 14:30:30 -0600
Subject: [PATCH] fix(skills): keep the overlay promise to Cmd/Ctrl+K and say
 where operators apply

The sidebar Search item links to the full search page, so it does not keep
the person's place. The palette sends only free text, so operators filter
only after the Search all handoff. Correct both statements and test them
against the sidebar and palette source.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../src/__tests__/board-skill-ui-guidance.test.ts   | 13 +++++++++++++
 skills/paperclip-board/SKILL.md                     |  5 +++--
 2 files changed, 16 insertions(+), 2 deletions(-)

diff --git a/server/src/__tests__/board-skill-ui-guidance.test.ts b/server/src/__tests__/board-skill-ui-guidance.test.ts
index 2aa7247c80c..877c7271f87 100644
--- a/server/src/__tests__/board-skill-ui-guidance.test.ts
+++ b/server/src/__tests__/board-skill-ui-guidance.test.ts
@@ -29,6 +29,19 @@ describe("paperclip-board skill web UI guidance", () => {
     expect(section).toContain("/{prefix}/search");
   });
 
+  it("keeps the overlay promise to the shortcut and describes the sidebar Search item as full search", () => {
+    // The classic sidebar Search item is a link to the full search page, not the overlay.
+    expect(read("ui/src/components/Sidebar.tsx")).toMatch(/<SidebarNavItem to="\/search" label="Search"/);
+    expect(section).toMatch(/sidebar \*\*Search\*\* item[^\n]*opens the full search page/);
+    expect(section).not.toMatch(/search icon[^\n]*opens over the current page/i);
+  });
+
+  it("does not claim operators narrow the quick-search results", () => {
+    // The palette sends only the parsed free text; operators apply after the full-search handoff.
+    expect(palette).toMatch(/issuesApi\.list\(selectedCompanyId!, \{ q: quickSearchQuery, limit: 10/);
+    expect(section).toContain("they do not narrow the quick-search results");
+  });
+
   it("tells the agent it cannot operate the person's browser", () => {
     expect(section).toMatch(/cannot press keys, focus fields, or open the palette/);
   });
diff --git a/skills/paperclip-board/SKILL.md b/skills/paperclip-board/SKILL.md
index 75e8bd2fdb0..cade27ae9c7 100644
--- a/skills/paperclip-board/SKILL.md
+++ b/skills/paperclip-board/SKILL.md
@@ -562,8 +562,9 @@ curl -sS -X PUT "$PAPERCLIP_API_URL/api/issues/{boardIssueId}/documents/decision
 
 When someone asks how to find, search for, or jump to tasks, projects, or agents themselves (for example "how do I quickly find X without leaving what I'm doing?"), tell them about quick search before or alongside listing results here:
 
-- **Quick search:** press **Cmd+K** (macOS) or **Ctrl+K** (Windows/Linux) on any board page, or click the search icon at the top of the sidebar. It opens over the current page, so they do not lose their place; Esc closes it.
-- Type words to match tasks, projects, and agents. Search operators narrow the results, for example `status:backlog`, `status:todo`, `assignee:me`, `project:"Launch"`, `label:bug`, `priority:high`, or `updated:>7d`.
+- **Quick search:** press **Cmd+K** (macOS) or **Ctrl+K** (Windows/Linux) on any board page. It opens over the current page, so they do not lose their place; Esc closes it.
+- The sidebar **Search** item is different: it opens the full search page, so they leave their current page.
+- Type words to match tasks, projects, and agents. They can also type operators such as `status:backlog`, `status:todo`, `assignee:me`, `project:"Launch"`, `label:bug`, `priority:high`, or `updated:>7d`. These filters take effect on the full search page; they do not narrow the quick-search results.
 - Choose **Search all** (or press Cmd/Ctrl+Enter) to open the full search page (`/{prefix}/search`). It keeps the typed text and operators as filters and adds comments, documents, and artifacts.
 - Results only include what that person is allowed to see.