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 <noreply@anthropic.com>
This commit is contained in:
co-authored by
Claude Opus 4.8
parent
8d089e238a
commit
fc30ce83a4
@@ -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.
|
||||
Reference in New Issue
Block a user