doc: Naming-Regel — 'GitLab' = Forgejo (2026-07-19)

NAMING-GITLAB-EQUALS-FORGEJO.md

@@ -0,0 +1,24 @@
+# Naming: "GitLab" = Forgejo
+
+**Goldene Regel (2026-07-19 verankert):**
+Wenn Bär "GitLab" sagt, ist immer die **Forgejo-Instanz** gemeint.
+
+## Warum
+Die Instanz läuft historisch unter dem Hostnamen `gitlab.wissen.consoro.it`, betreibt aber tatsächlich **Forgejo** (nicht GitLab). Der DNS-Name blieb aus Kompatibilitätsgründen erhalten. Bär nutzt beide Begriffe synonym.
+
+## Wie anwenden
+- Bei "in GitLab dokumentieren" / "push zu GitLab" → **Forgejo-Instanz** nutzen
+- Web-UI: `https://gitlab.wissen.consoro.it/`
+- SSH-Remote: `git@gitlab.wissen.consoro.it:barby/<repo>.git`
+- SSH-Config nutzt Alias `gitlab.wissen.consoro.it` (ProxyJump via `jump-ts`, Port 2222)
+- API-Endpoint: Forgejo-API `http://127.0.0.1:3000/api/v1/...` (nicht GitLab-API!)
+
+## Existierende Repos (Stand 2026-07-19)
+- `barby/claude-chat-status`
+- `barby/claude-hooks`
+- `barby/hermes-erkenntnisse` ← dieses Repo
+
+## Gotchas
+- **"Push to create is not enabled"** — Repo muss vorher via Web-UI oder API angelegt werden, nicht per `git push` neu erstellen
+- Forgejo-Antworten sagen "Forgejo:" im Fehlertext — nicht verwirren lassen, ist dieselbe Instanz
+- Der Login-Hinweis nach SSH-Auth ("Forgejo does not provide shell access") ist normal, kein Fehler