From 9ebd26de52421b0d2515b2288d108278893d51e9 Mon Sep 17 00:00:00 2001 From: Craig Jennings Date: Mon, 25 May 2026 00:41:02 -0500 Subject: docs: keep chat output plain text to avoid reverse-video Craig's terminal renders Markdown bold and inline-code spans as reverse video, which is hard to read. I added a rule to interaction.md: in conversational output, write command names, paths, and key chords as plain text, and lean on headers, dashes, parentheses, and quotes for structure. It governs chat output only, not the Markdown source of the rule and spec files he reads in an editor. I also made the keybinding-display example plain text so the convention shows the format the way it should appear in chat, with a pointer to the new rule. --- claude-rules/keybinding-display.md | 26 +++++++++++++++----------- 1 file changed, 15 insertions(+), 11 deletions(-) (limited to 'claude-rules/keybinding-display.md') diff --git a/claude-rules/keybinding-display.md b/claude-rules/keybinding-display.md index 6c5d4b3..ad45720 100644 --- a/claude-rules/keybinding-display.md +++ b/claude-rules/keybinding-display.md @@ -16,22 +16,26 @@ A bulleted list grouped by **category**, where each category is one level of the - *Which-key label* — the short string that shows in the which-key popup, in quotes (`"save ticket"`). For a sub-prefix, use the which-key prefix label (`"+save"`). - **General comes first**, then one section per sub-category in a sensible order. +## Plain text in chat + +Render this in chat as plain text — no Markdown bold and no inline-code spans. Headers, dashes, parentheses, and double-quoted labels carry the structure without them. See the "No Reverse-Video Highlighting in Chat Output" rule in [`interaction.md`](interaction.md): bold and backtick spans invert to reverse video on the user's terminal. The example below is shown the way it should appear in chat. + ## Example -For an imaginary command set `Pearl` on base prefix `C-; L`: +For an imaginary command set Pearl on base prefix C-; L: -**Pearl General — `C-; L`:** -- `C-; L s` — *(Save prefix)* — "+save" -- `C-; L e` — *(Edit prefix)* — "+edit" -- `C-; L m` — `pearl-menu` — "menu" +Pearl General — C-; L: +- C-; L s — (save prefix) — "+save" +- C-; L e — (edit prefix) — "+edit" +- C-; L m — pearl-menu — "menu" -**Pearl Save — `C-; L s`:** -- `C-; L s s` — `pearl-save-issue` — "save ticket" -- `C-; L s a` — `pearl-save-all` — "save all" +Pearl Save — C-; L s: +- C-; L s s — pearl-save-issue — "save ticket" +- C-; L s a — pearl-save-all — "save all" -**Pearl Edit — `C-; L e`:** -- `C-; L e p` — `pearl-set-priority` — "priority" -- `C-; L e s` — `pearl-set-state` — "state" +Pearl Edit — C-; L e: +- C-; L e p — pearl-set-priority — "priority" +- C-; L e s — pearl-set-state — "state" ## Why -- cgit v1.2.3