Files
rust-discovery/AGENTS.md
T
2026-11-13 13:49:11 +01:00

7.0 KiB
Raw Blame History

Verbindliche Regeln für alle Coding-KIs

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 muss approval_origin und testsimulation samt 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.md und 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 -k oder 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 .gitignore ausschließen, Verzeichnismodus 700, Dateimodus 600. Keine Secrets aus Neugier lesen, loggen, committen oder in Jobausgaben/MCP-/LLM-Kontexte kopieren. Daten strikt parsen; kein source, eval oder 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-Server rust.ease-technologies.de. Fehlende RustDesk-Profilwerte als not_configured behandeln, 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.