From 082b29b20558e4731b4122497840aec7a0751644 Mon Sep 17 00:00:00 2001
From: Joshua <vsg@Joshuas-Mac-Studio.local>
Date: Tue, 17 Feb 2026 14:39:49 -0800
Subject: [PATCH] Add contracts conformance vectors and artifact readmes

---
 abi/README.md               | 3 +++
 deploy/README.md            | 9 +++++++++
 docs/conformance-vectors.md | 7 +++++++
 3 files changed, 19 insertions(+)
 create mode 100644 abi/README.md
 create mode 100644 deploy/README.md
 create mode 100644 docs/conformance-vectors.md

diff --git a/abi/README.md b/abi/README.md
new file mode 100644
index 0000000..9dcbca6
--- /dev/null
+++ b/abi/README.md
@@ -0,0 +1,3 @@
+# ABI Directory
+
+Place versioned ABI artifacts here after contract compilation and deployment verification.
diff --git a/deploy/README.md b/deploy/README.md
new file mode 100644
index 0000000..8e64b4b
--- /dev/null
+++ b/deploy/README.md
@@ -0,0 +1,9 @@
+# Deployment Directory
+
+Place versioned deployment manifests here:
+
+1. chain id
+2. contract addresses
+3. deployment tx hashes
+4. verifier links
+5. policy hash snapshot
diff --git a/docs/conformance-vectors.md b/docs/conformance-vectors.md
new file mode 100644
index 0000000..a1ad9bf
--- /dev/null
+++ b/docs/conformance-vectors.md
@@ -0,0 +1,7 @@
+# Contracts Conformance Vectors
+
+1. `C-001` Membership mint creates non-transferable token.
+2. `C-002` Membership status transitions emit corresponding events.
+3. `C-003` Entitlement mint emits deterministic entitlement id/event payload.
+4. `C-004` Entitlement state transitions cannot bypass allowed state machine.
+5. `C-005` Contract deployment artifacts map to verified on-chain bytecode.