From 8ddd3d3d57a9c83a4905414e919d2f05a23bf9cd Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Sat, 11 Jul 2026 02:02:45 -0500 Subject: docs: add off-workspace window/capture rule When an agent opens a window or takes a screenshot to verify its own work, it shouldn't hijack the workspace the user is actively using. New claude-rules/desktop-capture.md: render self-captures on an off-screen output (a Hyprland headless output) and tear them down. When showing the user something, open it on a separate real workspace and name it. verification.md points at it. The principle is environment-general. The recipe is Hyprland-specific. Verified non-disruptive on ratio 2026-07-06. --- claude-rules/verification.md | 2 ++ 1 file changed, 2 insertions(+) (limited to 'claude-rules/verification.md') diff --git a/claude-rules/verification.md b/claude-rules/verification.md index 26d05b5..2c2088e 100644 --- a/claude-rules/verification.md +++ b/claude-rules/verification.md @@ -68,6 +68,8 @@ Do not let an unverifiable check vanish into a confident summary. State it plain Some checks can only be run by the user: interactive UI a script can't drive, a live external service, visual rendering (colors, layout, faces), a real device, or anything where the verification *is* a human looking at the result. When the gap needs the user's hands or eyes — not just a command they could paste — don't bury the steps in prose. Write them as a structured, runnable checklist in the project's task file. +When *you* need a window on the user's live desktop to verify something visually — render a panel, grab a screenshot — keep it off the workspace they're actively using. Capture on an off-screen output and tear it down; when showing the user something, open it on a separate workspace and name it. See `desktop-capture.md` for the rule and the Hyprland recipe. + Create (or append to) a single parent task named **"Manual testing and validation"** in the project's todo file (`todo.org`, or the project's equivalent). Under it, write **one org sub-header per test**: - **Title** — descriptive, naming the behavior under test (not "test 1"). -- cgit v1.2.3