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