aboutsummaryrefslogtreecommitdiff
path: root/claude-rules/interaction.md
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2026-05-08 07:31:45 -0500
committerCraig Jennings <c@cjennings.net>2026-05-08 07:33:28 -0500
commit0f6ed33ab7f183f86763866f35dcf25c8ba27330 (patch)
tree136dff29a8b9d8852718c0b736d9279fffbb3171 /claude-rules/interaction.md
parent4b5b0a03a83642ef7219640cb039e1aaccf07b90 (diff)
downloadrulesets-0f6ed33ab7f183f86763866f35dcf25c8ba27330.tar.gz
rulesets-0f6ed33ab7f183f86763866f35dcf25c8ba27330.zip
feat(claude-rules): add interaction.md — no popup menus for choices
Codify the rule that AskUserQuestion's popup menu obscures the chat text the user needs to read to make the choice. Choice prompts go inline as numbered options instead, with a "pick a number" prompt at the end. Applies to all three approval gates in commits.md (commit message, PR description, PR review reply).
Diffstat (limited to 'claude-rules/interaction.md')
-rw-r--r--claude-rules/interaction.md31
1 files changed, 31 insertions, 0 deletions
diff --git a/claude-rules/interaction.md b/claude-rules/interaction.md
new file mode 100644
index 0000000..4d9279b
--- /dev/null
+++ b/claude-rules/interaction.md
@@ -0,0 +1,31 @@
+# Interaction Style
+
+Applies to: `**/*`
+
+How Claude communicates with the user during a session — choice prompts, status updates, decision points.
+
+## No Popup Menus for Choices
+
+When Claude needs the user to pick between options, **do not** use the AskUserQuestion popup. Present the options inline in chat as a numbered list and ask the user to reply with a number.
+
+**Why:** The popup menu UI sits at the bottom of the chat window and obscures the chat content directly above it — exactly the area the user needs to read to make the choice. Inline numbered options keep the question, the surrounding context, and the proposed text all visible in the same scrollback.
+
+**How to apply:**
+
+For approve / changes / cancel flows (commit-message review, PR-description review, plan approval), draft inline:
+
+```
+1. Approve — commit now
+2. Request changes — tell me what to adjust
+3. Open in editor — emacsclient -n /tmp/...
+
+Pick a number.
+```
+
+For pick-one decisions, same shape: numbered list, one-line prompt at the end.
+
+For multi-select decisions, say so explicitly: "Pick any combination — reply with the numbers."
+
+Reserve `AskUserQuestion` only when the user explicitly asks for the popup form ("use the popup for this one") or for genuinely free-form input where numbered options don't fit.
+
+This rule applies to all three approval gates in the `commits.md` publish flow (commit message, PR description, PR review reply): print the draft inline, then offer numbered approve / changes / edit options inline. Do not switch to the popup form for the gate even though the prior protocol referenced it.