diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 00000000..bd2fe93a
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,33 @@
+# AGENTS.md — ThreadNet-Web
+
+> **Die Gruppenregeln sind kanonisch im `management`-Repo:**
+> [`AGENTS.md`](https://git.lab/axion1337.chat/management/-/blob/main/AGENTS.md)
+> — von außerhalb des Labs über den Gitea-Mirror lesbar:
+> `https://rohana.axion1337.de/sorb/management`. Dort stehen Repo-Topologie und
+> Mirror-Regeln, das Kanban-Framework (Status-Labels, WIP-Limit 2, ADR-Pflicht),
+> Deploy-Übergabe und AAR-Verfahren, Secrets-Handhabung und die
+> Karpathy-Leitlinien. Sie gelten für **jede** Session in diesem Repo.
+> Hier steht nur, was zusätzlich für dieses Repository gilt.
+
+## Was dieses Repo ist
+
+Fork von **Element Web/Desktop** (Basis `1.12.17`) für axion1337.chat.
+
+⚠️ **`README.md` und der Großteil von `docs/` sind unverändertes Upstream-Material** und
+beschreiben diesen Fork ausdrücklich **nicht**. Wer sich danach richtet, übersieht jede
+Anpassung.
+
+## Der eine Ort, der zählt
+
+**[`docs/axion1337-fork.md`](docs/axion1337-fork.md)** ist die vollständige Liste dessen, was
+dieser Fork gegenüber Upstream ändert — und zugleich die **Portier-Checkliste** für jedes
+Upstream-Upgrade: dort stehen die kritischen Dateien, an denen die Merge-Reibung entsteht.
+
+**Jede Änderung am Fork gehört dort hinein.** Eine Anpassung, die nur im Code steht, geht beim
+nächsten Rebase verloren — genau dafür existiert die Datei.
+
+## Bauen & Ausrollen
+
+Image wird in die Registry auf `rohana.axion1337.de` publiziert; die laufende Version zieht der
+Cluster über den Tag im gitops-Repo (`apps/production/`). Ein Upgrade ist deshalb zweistufig:
+erst hier rebasen und bauen, dann dort den Tag anheben.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 00000000..9aef12f7
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+Read AGENTS.md — the canonical instruction file for this repository. All rules live there.