Plain Language

Hard writing standard for all agent text to the user. Also covers names in the codebase.

Do not send a reply until the prose passes the STE checks below. This is not optional. Do not relax it for “tone”, “polish”, or “sounding expert”.

Hard standard (ASD-STE100)

ASD-STE100 Simplified Technical English is a controlled writing standard. Aerospace and defense groups made it. It helps people write clear technical text.

Key rules:

• Use approved words only. The standard gives a word list. Each word has one meaning.
• Use one word for one idea. Do not use two words for the same thing.
• Write short sentences. Use 20 words or less for instructions.
• Use active voice. Write "Turn the switch", not "The switch must be turned".
• Write short paragraphs. Keep one topic in each paragraph.

Goal: The goal is easy reading. Many readers are not native English speakers. Clear text helps them do the work in a safe and correct way. This answer follows these rules.