docs: add vendor README with submodule setup instructions

ruvnet · ruvnet · commit f771cf8461e6 · 2026-03-04T13:31:19.000-05:00
Co-Authored-By: claude-flow &lt;ruv@ruv.net&gt;
diff --git a/vendor/README.md b/vendor/README.md
@@ -0,0 +1,35 @@
+# vendor/
+
+Third-party dependencies managed as [git submodules](https://git-scm.com/book/en/v2/Git-Tools-Submodules).
+
+| Directory | Upstream | Description |
+|-----------|----------|-------------|
+| `midstream/` | [ruvnet/midstream](https://github.com/ruvnet/midstream) | Claude Flow middleware and agent orchestration |
+| `ruvector/` | [ruvnet/ruvector](https://github.com/ruvnet/ruvector) | RuVector signal processing and ML pipelines |
+| `sublinear-time-solver/` | [ruvnet/sublinear-time-solver](https://github.com/ruvnet/sublinear-time-solver) | Sublinear-time optimization solvers |
+
+All submodules track the `main` branch of their upstream repos.
+
+## Setup
+
+After cloning this repo, initialize submodules:
+
+```bash
+git submodule update --init --recursive
+```
+
+Or clone with submodules in one step:
+
+```bash
+git clone --recurse-submodules https://github.com/ruvnet/RuView.git
+```
+
+## Update to latest upstream
+
+```bash
+git submodule update --remote --merge
+git add vendor/
+git commit -m "chore: update vendor submodules"
+```
+
+A GitHub Actions workflow also checks for updates every 6 hours and opens a PR automatically.
