diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..c20f20d
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,33 @@
+# AGENTS.md — thread-net-git
+
+> **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
+
+Compose-Stack auf **CFGMON** (Operating-Host): **Traefik** (TLS für alles Öffentliche),
+**Gitea** (`rohana.axion1337.de`) und **cAdvisor**.
+
+⚠️ Dieser Stack wird **nicht** von Flux verwaltet — Deploy ist manuell auf dem Host
+(`cd /opt/thread-net-git && docker compose up -d`).
+
+## Unumstößliche Regeln (Details in `README.md`)
+
+1. **Projektname `thread-net-git` nie ändern** — das Gitea-Volume ist `external` und hängt am
+   Namen; bei falschem Namen bricht der Deploy laut ab statt still ein leeres Volume anzulegen.
+2. **Volumes `thread-net-git_gitea-data` und `thread-net-git_letsencrypt` nie löschen** —
+   Produktivdaten bzw. `acme.json`.
+3. **Gitea nie auf eine ältere Version pinnen** — die SQLite-DB kennt kein Downgrade.
+4. **Diesen Stack nie über Portainer anfassen** — Portainer identifiziert über den
+   Projektnamen; ein „Stack löschen" dort entfernt die laufenden Container.
+
+## Was hier besonders zählt
+
+Gitea ist die **Flux-Quelle** des Matrix-Clusters und die Container-Registry. Ein Fehler hier
+wirkt bis in die Produktion, obwohl das Repo klein aussieht.
diff --git a/CLAUDE.md b/CLAUDE.md
new file mode 100644
index 0000000..9aef12f
--- /dev/null
+++ b/CLAUDE.md
@@ -0,0 +1 @@
+Read AGENTS.md — the canonical instruction file for this repository. All rules live there.