Teach draft, review, send as the default path for mail

Merged
JE
1d ago
+4-3

People who have an agent write their mail want to stay in the conversation: "draft, review, 'send it'". The agent-facing guidance now teaches that as the default path:

  1. save the email with --draft on compose or reply;
  2. show the person its From, To, Cc, Bcc, Subject and Body in the conversation (hey draft show <id> --json reads it back);
  3. revise it with hey draft edit <id> as they ask;
  4. run hey draft send <id> when they say to send it.

Opening HEY to review is optional.

When the person asks outright for a message to go out, compose or reply without --draft still sends it in one step. The guidance describes that path but doesn't teach it as the default.

Where it changed:

  • skills/hey/SKILL.md § Sending: the path leads the section. The old "add --draft to let a person review" bullet is trimmed to what a --draft answer carries.
  • hey draft's agent notes.
  • hey mcp's threads blurb. That server has no send action, so its path ends with the person sending, from HEY or with hey draft send.

This is guidance only. No command refuses, delays or caps a send.

The companion change for hey-mcp-server's confirmed send_draft is on basecamp/hey-mcp-server#23.

Checks: make check passes locally.

Summary by cubic

Teaches agents the draft, review, send path as the default for writing mail for a person.

The skill's Sending section, hey draft's agent notes, and hey mcp's threads blurb now lead with: save the draft with --draft, show the person its From, To, Cc, Bcc, Subject and Body in the conversation, revise it with hey draft edit <id> as they ask, and run hey draft send <id> when they say to send it. Opening HEY to review is optional. One-step compose/reply without --draft is still described for when a person asks outright for a message to go out, but is no longer taught as the default. Guidance only — no command refuses, delays, or caps a send.