Was macht Unternehmens-Agent-Guardrails?
Zweck
Definiere und erzwinge praktische Sicherheitsvorgaben für KI-Coding-Agenten bei Keshet – sichtbare, durch Menschen bestätigte Kontrolle über gefährliche Aktionen, nicht Sandbox-Sicherheit. Gilt für alle Agenten in Claude Code, Cowork und jede Pipeline oder Automatisierung, die Claude verwendet. Standard-Richtlinienkategorien und app-spezifische Dateipfade befinden sich in reference.md.
Auslösebedingungen
Immer aktiv für jede KI-Agenten-Sitzung. Explizit aktivieren, wenn: eine neue Sitzung an einem Keshet-Projekt beginnt, ein Agent kurz davor ist, Shell-/Git-/MCP-Aufrufe auszuführen, ein Benutzer weitreichende Autonomie gewährt („erledige das einfach“), eine Pipeline entworfen oder überprüft wird oder eine Aktion Geheimnisse oder Dateien außerhalb des Projektverzeichnisses berühren würde.
Erste Prinzipien
- Identifiziere die Aktionsoberfläche: Shell, Datei-Lese-/Schreibzugriffe, Git, MCP-Aufrufe, Paketinstallationen, Hooks, Skills, Geheimnisse.
- Klassifiziere jede Kontrolle als
deny,ask,monitoroderguidance. - Bevorzuge kleine, explizite Regeln gegenüber breiten, vagen.
- Bewahre die Produktivität der Entwickler – frage bei mehrdeutigen Aktionen, verweigere nur eindeutig unsichere.
- Gib Einschränkungen klar an: Anweisungsdateien leiten das Verhalten; Hooks/Endpoint-Tools erzwingen mehr, aber keines ist eine vollständige OS-Sandbox ohne echte Eindämmung.
Workflow zum Erstellen von Regeln
- Frage, wo die Regel leben soll: persönliche Konfiguration, gemeinsame Projektkonfiguration oder beides.
- Frage, was pro Kategorie passieren soll: blockieren, fragen, überwachen oder erlauben.
- Entwerfe den kleinsten nützlichen Regelsatz.
- Füge Beispiele für Aktionen hinzu, die die Regel auslösen.
- Füge bekannte Einschränkungen hinzu – was noch Sandboxing oder Endpunktkontrollen erfordert.
- Wenn Dateien geschrieben werden, verwende den nativen Speicherort der Ziel-App; halte die Richtlinienformulierung app-agnostisch.
Empfohlene Standard-Haltung
Verwende dies, es sei denn, das Unternehmen stellt eine strengere Richtlinie bereit:
- Deny: Secret-Exfiltration, Pipe-to-Shell (
curl ... | sh), Deaktivierung von Sandbox/Berechtigungen, destruktive Systembefehle (rekursives Löschen, Datenträgerformatierung, Verlaufslöschung), Zugriff auf Credential-Stores. - Ask: Git Push/Force-Push, Deployments, Paketinstallationen, Schemaänderungen, Schreibvorgänge außerhalb des Projektverzeichnisses, jeder MCP-Tool-Aufruf, der nicht auf der vom Unternehmen genehmigten Liste steht.
- Monitor: Jede Shell-Ausführung, Datei-Schreibvorgänge innerhalb des Projekts, externe API-Aufrufe – protokolliert und sichtbar, nicht blockiert.
Was NICHT zu tun ist
- Keine MCP-Server, Hooks oder persistenten Dienste ohne explizite Benutzerzustimmung installieren
- Keine
.env-Dateien oder Credential-Dateien lesen, anzeigen oder in einen Kontext übergeben - Keine destruktiven Shell-Befehle ohne Bestätigung ausführen
- Kein Git-Push oder Deployment durchführen, ohne dass der Benutzer genau sieht, was gepusht wird
- Keine Dateipfade außerhalb des aktuellen Projektverzeichnisses zugreifen
- Keine fehlgeschlagenen Operationen stillschweigend wiederholen – Fehler immer anzeigen
- Keine reinen Anweisungs-Guardrail-Dateien als OS-Durchsetzung behandeln
- Keine Tools von Drittanbieter-Agenten aus ungeprüften Quellen ohne Sicherheitsüberprüfung installieren – Quellcode-Überprüfung vor der Installation vorgefertigter Release-Artefakte bevorzugen und Installationen durch Prüfsummenverifikation und eine Pilotumgebung leiten
Ausgabe-Template
Wenn du einen Guardrail-Satz vorschlägst, antworte immer mit:
## Guardrail-Zusammenfassung
<kurze Zusammenfassung dessen, was geschützt wird>
## Richtlinien
- Deny: <Aktionen, die vollständig blockiert werden>
- Ask: <Aktionen, die eine explizite Benutzerbestätigung erfordern>
- Monitor: <Aktionen, die protokolliert und sichtbar, aber nicht blockiert werden>
## Zu erstellende oder zu aktualisierende Dateien
- `<Pfad>`: <Zweck dieser Datei>
## Einschränkungen
<was diese Guardrails NICHT erzwingen – was zusätzliches Sandboxing oder Endpunktkontrollen erfordert>