aboutsummaryrefslogtreecommitdiff
path: root/claude-rules/interaction.md
Commit message (Collapse)AuthorAgeFilesLines
* feat(rules): render-merge guard for inline numbered optionsCraig Jennings3 days1-0/+2
| | | | GFM renderers merge adjacent ordered lists and renumber them — a 1-3 content list followed by a 1-3 options list rendered as options 4-6, and the user's pick ("4") didn't exist in the author's numbering. Numerals now belong to the options list only, other enumerations in the same message use dashes or prose, and a prose lead-in sits directly above the options. An out-of-range pick is treated as a suspected render-merge, not an error.
* docs(rules): add recommendation-at-item-1 convention to interaction.mdCraig Jennings2026-05-281-0/+10
| | | | Numbered choice lists put the recommended option at item 1 so the common case collapses to one keystroke. Skip when the question is free-form, when a directive's already been issued, or when no option is clearly better. Say so plainly in that case.
* feat(hooks): hard-deny the AskUserQuestion popup machine-wideCraig Jennings2026-05-261-0/+2
| | | | | | The no-popup-menus rule in interaction.md was too easy to forget, so the popup kept slipping back into choice prompts. I added a PreToolUse hook on AskUserQuestion that denies the call outright and returns the rule as the reason, which routes choices back to inline numbered lists. Since ~/.claude/settings.json symlinks to this repo's .claude/settings.json, the hook is machine-wide and version-controlled across machines. I documented it under the rule in interaction.md, including the consequence: the deny is unconditional, so the old "use the popup for this one" exception now needs the hook disabled via /hooks first.
* docs: keep chat output plain text to avoid reverse-videoCraig Jennings2026-05-251-0/+14
| | | | | | 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.
* feat(claude-rules): add interaction.md — no popup menus for choicesCraig Jennings2026-05-081-0/+31
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).