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

CONTRIBUTING.md

@@ -0,0 +1,50 @@
+# Contributing
+
+Dieses Repo ist fuer eine Workstation-/Homelab-nahe Infrastruktur gedacht. Aenderungen sollten daher vor allem diese Ziele schuetzen:
+
+- reproduzierbares Verhalten
+- klare Trennung zwischen Hermes und OpenClaw
+- sichere Defaults
+- moeglichst wenig manuelle Nacharbeit nach Updates
+
+## Branching
+
+- `main` bleibt deploybar
+- neue Arbeit in `feat/...`, `fix/...`, `docs/...`, `chore/...`
+- Merge erst nach lokalem Check
+
+## Vor jedem Merge
+
+```bash
+./scripts/release-check
+./scripts/alanctl validate
+./scripts/alanctl doctor
+```
+
+## Formatierung und Ownership
+
+- nutze einen Editor mit `.editorconfig`-Unterstuetzung
+- beachte `CODEOWNERS` und `docs/maintainers.md` bei Review und Zustaendigkeit
+- Aenderungen an Runtime-, Netz- oder Update-Logik nicht ohne bewusste Review freigeben
+
+## Commit-Stil
+
+Empfohlen:
+
+- `feat: ...`
+- `fix: ...`
+- `docs: ...`
+- `chore: ...`
+- `refactor: ...`
+
+## Release-Regel
+
+Jede aenderungsrelevante Anpassung an Compose, Skripten oder Netz-Logik braucht:
+
+- Eintrag in `CHANGELOG.md`
+- kurzen Hinweis in passender Doku
+- bei Upgrade-Auswirkung einen Eintrag in `docs/upgrade-policy.md`
+
+## Security-Meldungen
+
+Bitte keine sicherheitsrelevanten Probleme oeffentlich als normales Issue posten. Nutze dafuer die Hinweise in `SECURITY.md`.