From f22d6c91afcff75d6764146952f7aaac97a0c53a Mon Sep 17 00:00:00 2001
From: ares <285551516+New1Direction@users.noreply.github.com>
Date: Sat, 6 Jun 2026 08:09:28 -0700
Subject: [PATCH] docs: surface the verify-ledger CI gate in the README

The verify-ledger Action (#102) is the adoption vector for verifiable cognition, but
an unadvertised action won't get used. Add a 'Gate it in CI' snippet next to the
receipt section so the agent -> ledger -> CI-verify loop is discoverable.
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index 5b36259..6f63e15 100644
--- a/README.md
+++ b/README.md
@@ -224,6 +224,15 @@ korgex receipt --claim "shipped /healthz + passing test" --sign --html receipt.h
 korgex receipt verify receipt.korgreceipt.json   # ✓ VALID / ✗ INVALID (CI-gateable)
 ```
 
+**Gate it in CI.** Drop the [`verify-ledger`](.github/actions/verify-ledger) GitHub Action into any repo to fail the build if an agent's ledger or receipt doesn't verify — zero trust in the tool that produced it:
+
+```yaml
+- uses: New1Direction/korgex/.github/actions/verify-ledger@main
+  with:
+    path: ".korg/journal.json"            # or "**/*.korgreceipt.json"
+    pubkey: ${{ vars.KORG_SIGNER_PUBKEY }}  # optional: pin the signer
+```
+
 See [Self-Coding Bench](docs/self-coding-bench.md) for live reliability data across models.
 
 ---