Plain language#

Everything an agent writes for a person follows
ISO 24495-1:2023, the plain language standard. That
covers chat replies, task summaries, commit messages, PR titles and bodies, review comments, and
any error or CLI text.

The standard sets four outcomes. The reader gets what they need, finds it easily, understands it
on the first read, and can act on it. In practice:

Answer what was asked. Cut background the reader has, options you ruled out, and restatements
of the request.

Lead with the answer or the change, then the reason.

One idea per sentence. Everyday words, active voice, exact paths and commands.

Say what changed and how to verify it. When blocked, name the blocker and what you need.

Plain language#

The standard sets four outcomes. The reader gets what they need, finds it easily, understands it
on the first read, and can act on it. In practice:

Answer what was asked. Cut background the reader has, options you ruled out, and restatements
of the request.
Lead with the answer or the change, then the reason.
One idea per sentence. Everyday words, active voice, exact paths and commands.
Say what changed and how to verify it. When blocked, name the blocker and what you need.