From d99a30a11ec50dcb6a6b8026113c634e38c4623e Mon Sep 17 00:00:00 2001
From: Eduardo Henrique Ananias <68952491+duhenri9@users.noreply.github.com>
Date: Sat, 19 Sep 2026 12:37:04 +0100
Subject: [PATCH] docs: add recruiter-first portfolio review path

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

diff --git a/README.md b/README.md
index cee333e..5e7f5c8 100644
--- a/README.md
+++ b/README.md
@@ -6,6 +6,21 @@ ChainEvidence is an open-source distributed-systems project for reconstructing c
 
 > Indexed data is useful. Indexed data with canonical-chain provenance is defensible.
 
+
+## 60–90 second review
+
+**What this demonstrates:** a Rust distributed-systems/indexing core that survives synthetic chain reorganisations, invalidates orphaned effects, persists canonical state transactionally and emits lineage evidence that explains why an indexed result is considered canonical.
+
+**Fastest local proof:** the deterministic reorg fixture requires only the pinned Rust toolchain.
+
+~~~bash
+cargo run --bin chain-evidence -- fixtures/reorg.json artifacts/reorg-report.json
+~~~
+
+**Engineering path:** run the canonical fixture, then inspect [ARCHITECTURE](docs/ARCHITECTURE.md), [PostgreSQL recovery](docs/POSTGRES_RECOVERY.md), the [local EVM adapter](docs/LOCAL_EVM_ADAPTER.md) and CI negative controls.
+
+**Evidence boundary:** the local engine, transactional recovery and bounded Anvil adapter are separate evidence layers. They do not claim Ethereum consensus correctness, public-RPC completeness, continuous live-tail reorg handling or production readiness.
+
 ## Current engineering baseline
 
 ChainEvidence now has three executable evidence layers: