6.0 KiB
6.0 KiB
Verbindliche Regeln für alle Coding-KIs
Entwicklungspause auf Userwunsch seit 2026-11-12: Vor Wiederaufnahme docs/handover.md lesen. Bis zu neuem Auftrag keine Entwicklung, Builds, Tests, Deployments oder Jobs starten.
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. Windows beginnt erst nach dessen Abnahme. 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
- Server lokal in Docker auf dem Entwickler-PC; veröffentlichte Dockerports ausschließlich an Loopback binden, auch Datenbank/Verwaltungsports niemals an
0.0.0.0oder[::]. - PC baut SSH zur VM auf: Reverse-Forward
-R 127.0.0.1:18443:127.0.0.1:18443,-N -T,ExitOnForwardFailureund Keepalive gemäßdocs/development.md. VM-Agent verbindet sich ausgehend über dortigen Loopback. - TLS Ende-zu-Ende zwischen VM-Agent und lokalem Server, DNS SAN
rmm-dev.internal, expliziter VM-Hosts-Eintrag oder geprüfter Client-Connect-Override. Vertrauenswürdige Dev-CA installieren/konfigurieren; niemals ungültige Zertifikate/Namen akzeptieren, keincurl -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. - 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.