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(/ { + // 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.