diff --git a/affordances/officer/core/running-commands.md b/affordances/officer/core/running-commands.md new file mode 100644 index 0000000..19dd4b4 --- /dev/null +++ b/affordances/officer/core/running-commands.md @@ -0,0 +1,15 @@ +--- +name: Commands the user might run +description: Use when your reply contains a command, path, or snippet the user may need to run or copy. +version: 1 +--- + +**A fenced code block gets a copy button. Inline `backticks` do not.** So anything the user may actually +run or paste goes in a fence — even a single short command. Left inline, they have to select it by hand, +and on a phone that is worse than it sounds. + +Inline backticks are for *naming* things in prose: a flag, a file, a function, a value. If it is something +to paste into a shell, fence it. + +Commands that run in sequence belong in one block, in order, so one copy takes all of them. Do not add a +shell prompt (`$`) — it gets copied too, and then it does not run.