From c2360c2e9e6af46c612735c6aa3b2dd2334df9b2 Mon Sep 17 00:00:00 2001
From: Sergej Kern <mopc@tanuki.army>
Date: Fri, 4 Sep 2026 13:18:15 +0200
Subject: [PATCH] Document sibling repo uses and used-by as mermaid diagrams.

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

diff --git a/README.md b/README.md
index 5be580f..eb5b1a9 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,36 @@ logical database over gRPC, plus thin Document/Relational connect helpers.
 This package does **not** reference `Mishima.Nexus.Node.*` (the server host assemblies) — it only
 depends on the generated `Mishima.Nexus.Wire.V1` gRPC stubs, `Robotico.Graph`, and `Robotico.Time`.
 
+<!-- repo-uses:start -->
+## Uses
+
+This repository uses:
+
+```mermaid
+flowchart LR
+  robotico_nexus_client_csharp["robotico-nexus-client-csharp"]
+  mishima_nexus["mishima-nexus"]
+  robotico_nexus_client_csharp --> mishima_nexus
+```
+<!-- repo-uses:end -->
+
+<!-- repo-used-by:start -->
+## Used by
+
+This repository is used by:
+
+```mermaid
+flowchart LR
+  robotico_nexus_client_csharp["robotico-nexus-client-csharp"]
+  mishima_nexus["mishima-nexus"]
+  mishima_nexus_wpf["mishima-nexus-wpf"]
+  tanukiarmy_bot_ng["tanukiarmy-bot-ng"]
+  robotico_nexus_client_csharp --> mishima_nexus
+  robotico_nexus_client_csharp --> mishima_nexus_wpf
+  robotico_nexus_client_csharp --> tanukiarmy_bot_ng
+```
+<!-- repo-used-by:end -->
+
 ## Quick start
 
 ```csharp