diff --git a/AGENTS.md b/AGENTS.md index 69d33e7eba..06507f18d1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -52,7 +52,15 @@ Skipping this step is the #1 cause of incorrect or incomplete work. ## Writing Rules -Use the `ste` skill when the user explicitly requests STE, `/ste`, or ASD-STE100. +Writing rules, from Orwell, 1946. These govern prose: docs, PR text, messages. Never touch code or technical terms; swap in everyday words only where precision survives. + +1. Never use a metaphor, simile or other figure of speech which you are used to seeing in print. +2. Never use a long word where a short one will do. +3. If it is possible to cut a word out, always cut it out. +4. Never use the passive where you can use the active. +5. Never use a foreign phrase, a scientific word or a jargon word if you can think of an everyday English equivalent. +6. Break any of these rules sooner than say anything outright barbarous. +Review every prose output against these rules before delivering. --- diff --git a/docker/devenv/Dockerfile b/docker/devenv/Dockerfile index 450cff5b5a..5a493a862f 100644 --- a/docker/devenv/Dockerfile +++ b/docker/devenv/Dockerfile @@ -100,7 +100,7 @@ RUN set -eux; \ FROM base AS setup-opencode -ENV OPENCODE_VERSION=1.18.19 +ENV OPENCODE_VERSION=1.18.25 RUN set -ex; \ ARCH="$(dpkg --print-architecture)"; \