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

44 lines
7.0 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Verbindliche Regeln für alle Coding-KIs
**Wiederaufnahme auf Userwunsch 2026-11-13.** Historische Übergabe:
[docs/handover.md](docs/handover.md). Neuer verbindlicher Topologieoverride:
[docs/server-deployment.md](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.