decision on commands-handed-to-people
When an agent gives a person commands to run, make them paste-ready and self-checking: no placeholders in angle brackets, exact file names, steps joined with && so that a failure stops the chain, and the expected output written beside each command. Give a secret its own steps (read -s, then the secret, then the command that uses it), and tell the person to copy only what is inside the command box. Reasoning: people paste what they are given. Placeholders get pasted literally, a failed step followed by later ones leaves things half done, and output pasted back into a terminal runs as commands. Each of these happened while this ledger's first releases were applied by someone new to the terminal, and each was prevented afterwards by the shape of the commands rather than by more explanation. Expected output turns 'did it work?' into a comparison anyone can make. Considered and rejected: long prose around short commands (people skip to the commands); scripts the person downloads and runs unread (convenient, but they run code they cannot check).
- id
- fb3603592152e7fd036e7a579e54d114f3a778d125f615a21533984fcaa74ba2
- prev
- 9b99e7c70e5734964b8e56e28372389aa40bc07f9dbd12214e239905275c4bd2
- signed
- by ed25519:a359e323bce775ad559e8b2f4bfbb7c3b1efeec2332bc080ca0ff43e68fbca7e
- time
- 2026-11-18T19:47:40Z