From a460b44c93151125f495780c1ecc7a9080f45f14 Mon Sep 17 00:00:00 2001
From: Teknium <127238744+teknium1@users.noreply.github.com>
Date: Mon, 7 Sep 2026 01:52:16 -0700
Subject: [PATCH] docs(desktop): document directive action hover grace

---
 apps/desktop/DESIGN.md | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/apps/desktop/DESIGN.md b/apps/desktop/DESIGN.md
index 6c82771ee4..ed72f83c81 100644
--- a/apps/desktop/DESIGN.md
+++ b/apps/desktop/DESIGN.md
@@ -231,6 +231,9 @@ Sizes: `default`, `xs`, `overlay` (titlebar glyph counts).
 - Bordered surfaces in the transcript (tables, fences, callouts, attachments)
   use `--ui-stroke-tertiary`. Not `border-border` — that's the app-wide
   default and reads too hot against the thread.
+- Interactive directive chips in the composer expose their action on hover.
+  The action stays visible for a 500ms grace period while the pointer crosses
+  from the chip to the floating pill; leaving both dismisses it.
 - A tool result may expose an inline action that opens a preview. It must not
   open the rail automatically.
 - Install, onboarding, connecting, boot failure, and reauthentication are