[Issue intro. Open with the incident, the question or the uncomfortable truth that the rest of the issue answers.]

The incident

[Body copy. Short paragraphs, plain language and real examples carry the long read.]

Where the boundary actually is

# tools an agent may call
tools:
  search:   { scope: read-only }
  email:    { requires: human-approval }
  shell:    deny

A checklist you can ship this week

• [Action item one]
• [Action item two]
• [Action item three]

[Closing paragraph and sign-off.]