# 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.