From 724a36fd8ab0b6bd6c1b16801f92ccd896ca7ccb Mon Sep 17 00:00:00 2001
From: CleanDev-Fix <219162456+CleanDev-Fix@users.noreply.github.com>
Date: Thu, 30 Jul 2026 00:41:55 -0400
Subject: [PATCH] docs: add README discovery links

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

diff --git a/README.md b/README.md
index f980c63..5a617ef 100644
--- a/README.md
+++ b/README.md
@@ -77,3 +77,13 @@ Any attempt to call `validate_milestone`, `release_funds`, `redirect_funds`, or
   for integrators and tooling.
 - [`src/doc.md`](src/doc.md) maps these contract semantics to backend API
   payloads and HTTP error responses.
+
+## Further Reading
+
+- [`vesting.md`](vesting.md) documents the vault data model, contract methods,
+  and security and trust model.
+- [`USDC_INTEGRATION.md`](USDC_INTEGRATION.md) explains the token integration
+  and production USDC trust assumptions.
+- [`TESTING_GUIDE.md`](TESTING_GUIDE.md) explains how to run and extend the
+  contract tests.
+- [`CHANGELOG.md`](CHANGELOG.md) records the contract's release history.