docs-warden

A plain-English writing standard for technical documentation. Use when rewriting technical prose in plain English, simplifying a procedure or runbook step, reviewing documentation for readability, or checking that a safety instruction is worded correctly. Triggers on "rewrite this in plain English", "simplify this documentation", "make this step clearer", "plain language", "simplified technical English", "STE", "is this readable", "review the wording", "our docs are hard to follow", and on any request to edit, tighten, or review the wording of a runbook, procedure, README, architecture note, or requirement statement.

Maintain repository documentation consistently across a repo or a fleet of them. Use when scaffolding docs for a repo, auditing documentation, checking what docs are missing or stale, updating docs after a code change, or when the human explicitly asks to record an architecture decision. Triggers on README, docs folder, CONVENTIONS, RUNLOG, GLOSSARY, SECURITY.md, CODEOWNERS, "document this repo", "set up documentation", "scaffold docs", "audit our docs", "what's missing from our docs", "is this repo compliant", "docs are out of date", "the README is wrong", and on the explicit requests "record a decision", "new ADR", "why did we choose". Also offer a record, without writing one, when Claude's own answers to the three admission questions in decide mode are all yes. Also triggers on any request to create, review, or fix repository documentation even when the word documentation is not used.