From e7b00288ed704a6d2cf2d614ad36624c6ed1bb3e Mon Sep 17 00:00:00 2001 From: Thore Cimbal Date: Sat, 15 Aug 2026 12:00:00 +0000 Subject: [PATCH] docs: add group-rules pointer (CLAUDE.md) and repo-specific AGENTS.md Field test F-011 found four of five components carried no pointer file, so a session landing here had no path to the group rules at all. CLAUDE.md is the one-line pointer the check looks for; AGENTS.md links the canonical rules in the management repo (with the Gitea mirror URL for readers outside the lab) and otherwise carries only what is specific and easy to get wrong here. Co-Authored-By: Claude Opus 4.8 --- AGENTS.md | 33 +++++++++++++++++++++++++++++++++ CLAUDE.md | 1 + 2 files changed, 34 insertions(+) create mode 100644 AGENTS.md create mode 100644 CLAUDE.md 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.