From 68c6a5ae19a7cf8657af4f43a4473db5e7d1823e Mon Sep 17 00:00:00 2001
From: lexis <lexis@hyperhive>
Date: Sun, 31 May 2026 15:45:30 +0200
Subject: [PATCH] docs(CLAUDE.md): add matrix.md to file index + reading paths
 (follow-up to #811)

---
 CLAUDE.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/CLAUDE.md b/CLAUDE.md
index 54aa3453..ed4e52ab 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -297,6 +297,8 @@ docs/
   damocles-migration.md  future migration plan for damocles → hyperhive
   gateway.md           nginx vhost map, matrix discovery flow, firewall posture,
                        HIVE_FORGE_URL loopback rationale (#764, #772, #793)
+  matrix.md            matrix container shape, serverName/gatewayHost split,
+                       firewall + federation, provisioning flow, fluffychat-web build
 ```
 
 ## Reading paths
@@ -320,6 +322,9 @@ read them à la carte.
   [`docs/gotchas.md`](docs/gotchas.md).
 - **"What nginx vhosts does the gateway serve? How does matrix
   discovery work?"** → [`docs/gateway.md`](docs/gateway.md).
+- **"How does the matrix-tuwunel container work? What about
+  fluffychat-web and per-agent matrix accounts?"** →
+  [`docs/matrix.md`](docs/matrix.md).
 
 ## Conventions & process