diff --git a/README.md b/README.md
index 6df2a96..3afb3aa 100644
--- a/README.md
+++ b/README.md
@@ -5,6 +5,10 @@ snapshots from component codebases — **React + Tailwind/shadcn** and **Vue 3 +
 Vuetify 3** — ready to serve to AI agents via
 [ds-mcp](https://github.com/aestheticfunction/ds-mcp).
 
+> Part of the [dspack ecosystem](https://github.com/aestheticfunction) — the organization profile has the full map of how the repositories fit together.
+>
+> **Kind:** snapshot tool (CLI, experimental, not yet on npm — install from source) · **Audience:** teams with an existing component codebase who want a starting dspack file · **Neighbors:** produces [dspack](https://github.com/aestheticfunction/dspack) documents; serves them via [ds-mcp](https://github.com/aestheticfunction/ds-mcp); see the governed end-to-end chain in [dspack-studio](https://github.com/aestheticfunction/dspack-studio) ([hosted replay](https://studio.aesthetic-function.com))
+
 Component extraction runs through a framework-adapter layer (see
 [docs/adapters.md](docs/adapters.md)); the shared pipeline — token extraction,
 assembly, provenance, warnings, validation, deterministic output — is identical