Setup

Announce at start: "I'm using the humane:setup skill to diagnose this machine before changing anything."

Two jobs, in this order: find out what is actually wrong, then fix only what the user agrees to fix. Never the other way round — a setup flow that installs first and reports afterwards is one that installs things nobody wanted.

See references/commands.md for the command catalog and expected install flow.

doctor writes nothing, installs nothing, and never asks for a key. It exits 1 only on a genuinely blocking gap; missing optional pieces exit 0, because most of the cycle works without them.

Quick reference