Initial version of the Hermes self learning agent setup of JR IT Services.

docs/gitea-import.md

@@ -0,0 +1,84 @@
+# Gitea-Import
+
+## Repo-Name
+
+Empfohlen: `alan-agents-workstation`
+
+## Schnellweg
+
+```bash
+cd /pfad/zu/alan
+
+git init
+git branch -M main
+git add .
+git commit -m "Initial workstation stack for Hermes + OpenClaw coexistence"
+
+git remote add origin ssh://git@<dein-gitea-host>/<dein-user>/alan-agents-workstation.git
+git push -u origin main
+```
+
+## Branching
+
+Einfach und robust fuer Single-Workstation-Infra:
+
+- `main` fuer den stabilen Stand
+- `feat/...` fuer lokale Erweiterungen
+- Tags fuer getestete Snapshots, z. B. `v0.1.0`
+
+## Was ins Repo gehoert
+
+- Compose-Dateien
+- Skripte
+- Doku
+- Beispiel-Env-Dateien
+- systemd-User-Units
+
+## Was nicht ins Repo gehoert
+
+- echte API-Keys
+- echte Hermes-Daten aus `state/hermes`
+- Backup-Archive
+- lokale Debug-Logs
+
+
+## Empfohlene Zusatzdateien fuer Gitea
+
+Dieses Repo bringt bereits mit:
+
+- `CHANGELOG.md`
+- `CONTRIBUTING.md`
+- `.gitea/ISSUE_TEMPLATE/*`
+- `.gitea/pull_request_template.md`
+- `.gitea/workflows/repo-check.yml`
+- `docs/release-process.md`
+- `docs/upgrade-policy.md`
+
+Damit bekommst du in Gitea:
+
+- strukturierte Fehlermeldungen und Feature-Wuensche
+- einheitliche PR-Checklisten
+- einfache serverseitige Grundpruefungen fuer das Repo
+- nachvollziehbare Releases mit Tagging und Upgrade-Hinweisen
+
+## Release-Empfehlung
+
+Fuer jedes verteilte Repo-Update:
+
+1. `CHANGELOG.md` pflegen
+2. `./scripts/release-check` ausfuehren
+3. Release-Tag setzen, z. B. `v0.1.1`
+4. in Gitea Release Notes mit Upgrade-Hinweisen anlegen
+
+## Beispiel fuer Release Notes
+
+```text
+Neu:
+- robusteres br0-Uplink-Handling
+- verbesserter Rollback-Workflow
+
+Wichtig fuer bestehende Installationen:
+- `.env.example` geaendert: neuer Key XYZ
+- vor Upgrade bitte `./scripts/alanctl backup` ausfuehren
+- Rollback bleibt ueber `./scripts/alanctl rollback-hermes` moeglich
+```