# Novaris — Arbeitsregeln für KI-Agenten

## Vor jeder Änderung

- `project.yaml` und `ai/governance.lock` lesen.
- Die Trennung zwischen unverändertem Legacy-Vorher-Zustand und modernem
  Vergleichsreaktor erhalten.
- Markdown ist die Quelle der Dokumentation. Gleichnamige HTML-Dateien und der
  Offline-Index nach Änderungen mit `python ci/scripts/md-to-html.py .` erzeugen.

## Prüfen

- Für normale Änderungen `pwsh -NoProfile -File ci/scripts/verify-repository.ps1 -Mode Fast` ausführen.
- Vor einem Release oder einer Migration `-Mode Full` verwenden. Das umfasst
  beide Reaktoren, Coverage-Gates, Frontend-Lint, Tests, Build und Audit.
- `-Mode Integration` nur verwenden, wenn die benötigten Laufzeitdienste und
  Container verfügbar sind.

## Repository-Hygiene

- Keine Secrets, lokalen `.env`-Dateien, Dependency-Verzeichnisse, Build-Ausgaben,
  Testberichte, Logs, PDFs oder mobilen HTML-Ableitungen versionieren.
- Tests, Fixtures, Migrationen, Mocks, Compose-/OpenShift-Dateien und CI-Konfiguration
  sind Quellbestand und bleiben im Repository.
- Gemeinsame Jenkins-, Kafka-, Keycloak-, Datenbank- und Observability-Konfiguration
  gehört in `shared/enterprise-infrastructure`, nicht als Kopie in dieses Projekt.
- Zentral verwaltete Dateien unter `ai/` und `.agents/` nicht lokal auseinanderentwickeln;
  Änderungen erfolgen im Repository `nursude/ai-governance` und werden synchronisiert.