From 08ba34f9202b707fda55e9d6bc274d2c911558f9 Mon Sep 17 00:00:00 2001 From: Josh Terry Date: Mon, 17 Aug 2026 13:01:33 -0700 Subject: [PATCH] Require ASD-STE100 Simplified Technical English for agent reports Reports, replies, and responses from agents must use Simplified Technical English. The new AGENTS.md section states the core rules and obeys them itself. Commit messages, PR bodies, code comments, and documentation keep their existing conventions. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_015GeUG1gboWiZSnFyzQghyp --- AGENTS.md | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 31dff20..40dd35c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -61,6 +61,28 @@ commit publishes the secret it removes. - The schema (`schema/`) is the payload; changes to it are versioned (`SchemaVersion`) and deliberate. +## Language for reports and replies + +Write all reports, replies, and responses in ASD-STE100 Simplified Technical +English. This section obeys its own rule. + +- Use the active voice. +- Write short sentences. Use a maximum of 20 words in an instruction. Use a + maximum of 25 words in a description. +- Give only one instruction in each sentence. +- Use a word only with one meaning. Do not use a different word for the same + thing. +- Use the simple present, simple past, or simple future tense. Do not use + complex tenses. +- Do not use idioms, metaphors, or slang. +- Use the project terms (receipt, claim, probe, remainder, tier, harvest) as + technical names. +- Put important warnings first. + +This rule applies to reports, replies, and responses only. Commit messages, +pull-request bodies, code comments, and documentation keep the conventions +above. + ## How changes land correctful is dogfooded on itself: every change lands through a pull request,