From ad0ab33541abd9a1297d88e5b9186d25868b1c70 Mon Sep 17 00:00:00 2001
From: Roger Chappel <miscanalysis@gmail.com>
Date: Thu, 18 Jun 2026 18:20:06 +1000
Subject: [PATCH] docs: document release readiness checks

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index a6f5417..ec743ce 100644
--- a/README.md
+++ b/README.md
@@ -153,3 +153,14 @@ The release gate covers:
 - `npm run validate` - bash scripts/validate.sh
 - `npm run package:smoke` - npm pack --dry-run
 - `npm run release:check` - npm run check && npm test && npm run smoke && npm run package:smoke
+
+## Release readiness
+
+Run the release gate before tagging or publishing:
+
+```sh
+npm run release:check
+npm pack --dry-run
+```
+
+The package smoke check prints the tarball contents so missing runtime files are caught before release.