diff --git a/README.md b/README.md
index e49ca74..8e9c1ff 100644
--- a/README.md
+++ b/README.md
@@ -411,8 +411,9 @@ Mechanical wiki operations - never hand-edited by the LLM - are handled by
 `tools/wikitool`: scaffolding pages, renaming and deleting them, cross-references,
 index/log/provenance regeneration, structural linting, and publishing.
 
-Every command carries one data record - synopsis, properties, exit status,
-retry policy - kept next to its code. `tools/wikitool <command> -h` prints it,
+Every command carries one data record - synopsis, properties, copyable examples,
+each exit cause with what to do about it, prohibitions, and notes on its
+behaviour - kept next to its code. `tools/wikitool <command> -h` prints it,
 `tools/wikitool -h` prints a one-line index of all of them, and
 [`tools/CONTRACT.md`](tools/CONTRACT.md) holds a generated copy together with the
 maintenance schedule; `tools/wikitool docs verify` checks that copy and every