write-docs git:20260913.7de9794A

Immutable. This exact content never changes and is served at /api/v1/blob/488e37802429040f.

---
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"?