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