Replace stale repo-seed template README with a real one

Written from SCOPE.md/INTENT.md and direct source inspection. Requested
during reuse-surface REUSE-WP-0017-T05 review follow-up.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

README.md

@@ -1,3 +1,37 @@
-# repo-seed
+# vantage-point
 
-A git repository template to bootstrap coulomb projects from.
+Generic system for exploring, analyzing, and reasoning about dependency
+structures across arbitrary domains, treated as **Network-Based Graph
+Models (NBGM)** — typed graphs of entities (nodes) and relationships
+(edges) enriched with attributes, provenance, and semantics.
+
+Vantage Point is a **multi-perspective exploration environment**: the same
+underlying graph can be viewed from different "vantage points" to answer
+domain-specific questions, rather than binding one fixed visualization or
+domain vocabulary to the model. The vocabulary is grounded in Tamara
+Munzner's nested design model and the NBGM framing from Meyer, Sedlmair,
+and Munzner (BELIV 2012).
+
+## Status
+
+**Specification stage — no implementation yet.** `docs/nbgm-spec-v0.1.md`
+is a substantial (670-line) draft baseline defining core identity/typing
+rules for nodes and edges, the attribute model and namespaces, provenance
+and lineage, a baseline catalog of inspection operations, and alignment
+notes for repo-native graph bindings (e.g. Railiance Fabric). Storage
+engines, query languages, visualization encodings, and domain-specific
+type catalogs are explicitly out of scope for v0.1.
+
+## Getting oriented
+
+- **Intent:** `INTENT.md` — full rationale and grounding in the NBGM
+  research literature
+- **Scope and boundaries:** `SCOPE.md`
+- **The spec:** `docs/nbgm-spec-v0.1.md`
+- **Build history:** `workplans/`
+
+## In scope
+
+NBGM specs, registry, and exploratory docs; State Hub workplans for graph
+exploration features; alignment with `repo-scoping` and `railiance-fabric`
+graph models. See `SCOPE.md` for the full in/out-of-scope breakdown.