diff --git a/README.md b/README.md
index fcd7b8f..6860e3d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,16 @@
-# repo-seed
+# evidence-source
 
-A git repository template to bootstrap coulomb projects from.
\ No newline at end of file
+Document source, ingestion, extraction, metadata, and citation recovery —
+PDF/HTML/MD ingest, fingerprinting, page-/offset-map construction,
+canonical-text extraction, and the recovery behavior for stale selectors.
+
+## MVP status: INTENT only
+
+During the citation-evidence MVP, code lives upstream in
+[`citation-evidence`](../citation-evidence/) under `src/source/`. This repo
+currently holds `INTENT.md` describing what will move here. Contract
+changes belong in
+[`citation-evidence/wiki/SharedContracts.md`](../citation-evidence/wiki/SharedContracts.md),
+not here.
+
+Per the dependency map, source depends on `shared/` and `engine/` only.