7.6 KiB
Verbindliche Regeln für alle Coding-KIs
Fokus für den MVP-Abschluss, 2026-11-16: Aktuelle Bestandsaufnahme und Agentaufträge stehen in docs/mvp-completion-plan.md. Vor Fortsetzung dort das nächste offene Gate und seine Originalbelege prüfen. Ein Integrator koordiniert Zieländerungen, WebUI-Bedienung und Gitindex; Unteragents bearbeiten abgegrenzte Aufgaben. Bereits belegte Abnahmen nicht pauschal wiederholen. Neue Tests nur für notwendige Änderungen, konkrete Fehler oder betroffene Sicherheitsinvarianten. Dieser Ablauf ändert keine normativen Produktentscheidungen oder Genehmigungsgrenzen.
Wiederaufnahme auf Userwunsch 2026-11-13. Historische Übergabe: docs/handover.md. Neuer verbindlicher Topologieoverride: docs/server-deployment.md. Der Entwickler-PC ist kein RMM-Server mehr; der dedizierte Internetserver übernimmt diese Rolle. Korrektur 2026-11-13: Dieses Notebook ist ausschließlich Entwicklungsrechner. Hier keinen RMM-Client installieren, enrollen oder als Dienst starten. Aktueller Client ist die Cloud-Test-VM; der festgelegte Cloudserver bleibt endgültiger Server.
Diese Regeln gelten für alle AIs im gesamten Repository. Vor technischen Entscheidungen die vollständige Rust_RMM_Implementierungsspezifikation.md, docs/project-decisions.md und docs/development.md lesen. Normative Produktentscheidungen aus Kapitel 0 der Spezifikation haben Vorrang; Widersprüche offen dokumentieren, nicht stillschweigend abschwächen.
Reihenfolge und reale Nachweise
- Linux-first für ALLE Features: Zuerst auf der tatsächlichen Linux-Test-VM implementieren, ausführen und nachweisen. Lokale Tests, Simulatoren und Cross-Builds ergänzen den VM-Nachweis, ersetzen ihn nicht.
- Erstes Phasenziel ist das Linux-MVP (M0–M5, x86-64) mit WebUI, MCP und menschlich autorisierten dauerhaften Jobs. Useroverride 2026-11-13: Windows-11-Client darf bereits parallel entwickelt und nativ auf der neuen Windows-Test-VM geprüft werden. Dies ersetzt keine Linux-Abnahme und macht Windows nicht zum Linux-MVP-Blocker. Notebook-Host bleibt ausschließlich Entwicklungsrechner; die Windows-VM ist ein eigener Gast. Proxmox/PBS, Cluster und Backups folgen noch später; kein Hypervisorzugang ist Voraussetzung eines Gastagenten.
- Useroverride 2026-11-12: RustDesk aus dieser Umsetzung auslassen. Keine RustDesk-Installation, Profile/Provisionierung oder externe Desktopabnahme; RustDesk ist keine MVP-Pflicht und kein Abnahmeblocker. Bestehende Architekturverträge bleiben ausschließlich für eine spätere optionale Integration erhalten, ohne Ersatz durch eine eigene Desktop-Engine.
- Kein Erfolg ohne realen Nachweis: geplant, implementiert, gebaut, lokal getestet, auf VM getestet und abgenommen getrennt ausweisen. Fehlende Zugänge/Tools/Capabilities und nicht ausgeführte Tests offen nennen. Keine erfundenen Messwerte oder Testergebnisse.
Unumgehbare Genehmigungsgrenze
- Jeder Job aus UI, MCP oder Automatik beginnt als persistenter Antrag
pending_approval. Ein berechtigter Mensch muss den unveränderlichen Plan mit festen Jobs/Versuchen in der WebUI genehmigen. Auch Linux-Dev, Hello World, Live-Diagnose, Retry und Reboot-Folgejobs haben keine Abkürzung. - Einzige Bedienungsausnahme für diese Entwicklungsabnahme (Userentscheidung 2026-11-12): Browserautomatisierung darf ausschließlich im expliziten dev/test-Profil tatsächliche UI-Interaktionen einschließlich Plangenehmigung mit einem deutlich sichtbar als simuliert gekennzeichneten Testprincipal durchführen. Keine Code-Abkürzung:
pending_approval, Planbindung, interaktive UI-Grenze und Sicherheitsprüfungen bleiben erhalten. Audit mussapproval_originundtestsimulationsamt Testprincipal/Planbezug nachvollziehbar kennzeichnen; keine tatsächliche menschliche Identität vortäuschen, kein Produktions-Freigabenachweis. KI/MCP dürfen weiterhin keine direkten API-/DB-Freigaben vornehmen und kein Token erhalten, das die interaktive Grenze unterläuft. Produktionsverhalten bleibt unverändert. Details:docs/project-decisions.mdund Spezifikation Kapitel 0.1. - Vor Genehmigung keine ausführbaren Jobs, Outbox, JobOffers, Startgrants oder Wirkung. Policies begrenzen/verweigern nur. KI, MCP und Automatik genehmigen niemals; auch kein direkter API-/DB-Aufruf als Ersatz für den Menschen.
- Passive Standardinventarisierung/Heartbeats und Lesen gespeicherter Daten sind keine Jobs und benötigen keine Einzelgenehmigung. Angeforderte Live-Erhebung nicht als passives Inventar tarnen.
- Redelivery ist kein neuer Versuch und darf keine zweite Wirkung auslösen. Neue Versuche und veränderte Pläne brauchen neue menschliche Genehmigung. Unklare Wirkung bleibt
unknown, nicht blind wiederholen.
Entwicklungsweg und Sicherheit
- Useroverride 2026-11-13: Server auf dem dedizierten Internetserver, sämtliche Clients verbinden sich direkt ausgehend dorthin. Keine lokale Serverpflicht und kein PC→VM-Reversetunnel mehr. Details und tatsächlicher Deploymentstand in
docs/server-deployment.md. - Dockerports auch auf dem Internetserver ausschließlich an Loopback binden; PostgreSQL ohne veröffentlichten Port. Öffentlichen TLS-Ingress separat und eng begrenzt konfigurieren. Keine öffentlich erreichbare Dev-Anmeldung oder Datenbank; Verwaltungszugang bis zur sicheren öffentlichen Anmeldung ausschließlich über SSH-Tunnel.
- TLS Ende-zu-Ende zum Server, gültige Kette und zum Endpunkt passender SAN/SNI. Ein geprüfter Connect-Override verändert ausschließlich TCP-Ziel/Port. Vertrauenswürdige CA gezielt konfigurieren; niemals ungültige Zertifikate/Namen akzeptieren, kein
curl -koder Abschalten der Verifikation. - SSH ausschließlich Dev-/Bootstraptransport, kein RMM-Sicherheitsersatz: Enrollment, Geräteidentität/mTLS, Tenant-Grenzen, Planbindung und menschliche Genehmigung bleiben erforderlich.
- VM-Zugangsdaten ausschließlich lokal in
credentials/linux-vm.conf;credentials/über.gitignoreausschließen, Verzeichnismodus 700, Dateimodus 600. Keine Secrets aus Neugier lesen, loggen, committen oder in Jobausgaben/MCP-/LLM-Kontexte kopieren. Daten strikt parsen; keinsource,evaloder Ausführen von Konfigurationsinhalten. - Server-SSH-Daten entsprechend in
credentials/server.conf; Root ist ausschließlich Bootstrapzugang. Anwendungsdienst unprivilegiert betreiben. Neue SSH-Hostschlüssel vor Anmeldung unabhängig bestätigen. - Entwicklungs-/Testtools dürfen installiert werden. Daraus folgen keine impliziten Reboots, Updates oder destruktiven Tests am Ziel, auch nicht an der Linux-Test-VM. Bootstrap eng begrenzen und abstimmen; RMM-Testjobs bleiben WebUI-genehmigungspflichtig. Sicherheitsprüfungen nicht für eine Demo umgehen.
- Lokale Serverneustarts sind für diese Entwicklungsabnahme ausdrücklich erlaubt; daraus folgen keine impliziten VM-Reboots, Updates oder destruktiven Zieltests und keine Ersetzung der WebUI-Plangenehmigung.
Arbeitsweise
- Bestehende Projektmuster und bekannte Infrastruktur erhalten: Repository
https://gitea.incoso.eu/kevin_janssen/rust-discovery, RustDesk-Serverrust.ease-technologies.de. Fehlende RustDesk-Profilwerte alsnot_configuredbehandeln, keine eigene Desktop-Engine bauen. - Kleine lauffähige Strecken liefern, Mandantentrennung auf jedem Pfad beachten, betroffene Tests/Fehlerpfade prüfen. Keine Typefehler oder Sicherheitsprüfungen unterdrücken.
- Geplante Start-/Testbefehle ausdrücklich als geplant, nicht ausgeführt kennzeichnen. Tatsächlich ausgeführte Prüfungen mit Ergebnis und Grenzen dokumentieren. Dokumentation und Spezifikationsversion bei geänderten Entscheidungen konsistent halten.