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.

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.

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.