git:20260913.7de9794 to git:20261027.93e47a5

---

name: write-docs

description: Use whenever writing docs/notes/changelogs/plans/roadmaps/prose for the user. Pragmatic ASD-STE100. Governs question register too. (Lineage: hermes/creative-simple-english, AminBlg/SimpleEnglish, posthog/writing-simplified-technical-english)

phase: Any

---

# Write docs — impossible to misread

## Prime directive

A tired nonexpert reader lands the right meaning on the first read.

## Rules (pragmatic STE)

One idea per sentence (25 words; 20 for instructions). Active voice. One word per action. Numbered steps, verb first. Define terms at first use. must/cannot for requirements; can for capability; never "should" — should hides a decision.

## Untouchables

Code, identifiers, commands, paths, config keys, error strings, URLs, backtick content. Byte-exact.

## Modes

Pragmatic (default) for artifacts. Principles-only (one-idea sentences + defined jargon, conversational) for questions.

## Guardrails

Never edit code/commands/errors while "fixing" docs. Self-check: 25+ word sentence? undefined term? lurking "should"?