failproofai 0.0.6-beta.0 → 0.0.6-beta.2

package/.next/standalone/docs/de/custom-policies.mdx

@@ -1,10 +1,10 @@
 ---
 title: Benutzerdefinierte Richtlinien
-description: "Schreibe eigene Richtlinien in JavaScript – Konventionen durchsetzen, Drift verhindern, Fehler erkennen, externe Systeme integrieren"
+description: "Schreibe eigene Richtlinien in JavaScript – setze Konventionen durch, verhindere Abweichungen, erkenne Fehler und integriere externe Systeme"
 icon: code
 ---
 
-Benutzerdefinierte Richtlinien ermöglichen es dir, Regeln für jedes Agentenverhalten zu schreiben: Projektkonventionen durchsetzen, Drift verhindern, destruktive Operationen absichern, feststeckende Agenten erkennen oder Slack, Genehmigungsworkflows und mehr integrieren. Sie verwenden dasselbe Hook-Event-System und dieselben `allow`-, `deny`-, `instruct`-Entscheidungen wie eingebaute Richtlinien.
+Benutzerdefinierte Richtlinien ermöglichen es dir, Regeln für jedes Agentenverhalten zu schreiben: Projektkonventionen durchsetzen, Abweichungen verhindern, destruktive Operationen absichern, feststeckende Agenten erkennen oder Integrationen mit Slack, Genehmigungsworkflows und mehr umsetzen. Sie verwenden dasselbe Hook-Event-System und dieselben `allow`-, `deny`- und `instruct`-Entscheidungen wie integrierte Richtlinien.
 
 ---
 
@@ -44,23 +44,23 @@ failproofai policies --install --custom ./my-policies.js
 Lege `*policies.{js,mjs,ts}`-Dateien in `.failproofai/policies/` ab – sie werden automatisch geladen, ohne Flags oder Konfigurationsänderungen. Das funktioniert wie Git-Hooks: Datei ablegen, fertig.
 
 ```
-# Projektebene – in Git eingecheckt, mit dem Team geteilt
+# Projektebene — in Git eingecheckt, wird mit dem Team geteilt
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Benutzerebene – persönlich, gilt für alle Projekte
+# Benutzerebene — persönlich, gilt für alle Projekte
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-**Funktionsweise:**
-- Sowohl Projekt- als auch Benutzerverzeichnisse werden durchsucht (Vereinigung – kein „erste Scope gewinnt")
+**So funktioniert es:**
+- Sowohl Projekt- als auch Benutzerverzeichnisse werden durchsucht (Vereinigung – kein „First-scope-wins")
 - Dateien werden innerhalb jedes Verzeichnisses alphabetisch geladen. Mit `01-`, `02-` als Präfix lässt sich die Reihenfolge steuern
 - Nur Dateien, die auf `*policies.{js,mjs,ts}` passen, werden geladen; andere Dateien werden ignoriert
 - Jede Datei wird unabhängig geladen (fail-open pro Datei)
-- Funktioniert zusammen mit explizitem `--custom` und eingebauten Richtlinien
+- Funktioniert zusammen mit expliziten `--custom`- und integrierten Richtlinien
 
 <Tip>
-Konventionsrichtlinien sind der einfachste Weg, Richtlinien im Team zu teilen. Checke `.failproofai/policies/` in Git ein und alle Teammitglieder erhalten sie automatisch.
+Konventionsrichtlinien sind der einfachste Weg, einen Qualitätsstandard für deine Organisation aufzubauen. Checke `.failproofai/policies/` in Git ein, und jedes Teammitglied erhält automatisch dieselben Regeln – kein Setup pro Entwickler nötig. Wenn dein Team neue Fehlerquellen entdeckt, füge eine Richtlinie hinzu und pushe sie. Mit der Zeit entstehen so lebendige Qualitätsstandards, die mit jedem Beitrag besser werden.
 </Tip>
 
 ### Option 2: Expliziter Dateipfad
@@ -69,7 +69,7 @@ Konventionsrichtlinien sind der einfachste Weg, Richtlinien im Team zu teilen. C
 # Mit einer benutzerdefinierten Richtliniendatei installieren
 failproofai policies --install --custom ./my-policies.js
 
-# Den Richtliniendateipfad ersetzen
+# Den Pfad zur Richtliniendatei ersetzen
 failproofai policies --install --custom ./new-policies.js
 
 # Den benutzerdefinierten Richtlinienpfad aus der Konfiguration entfernen
@@ -78,13 +78,13 @@ failproofai policies --uninstall --custom
 
 Der aufgelöste absolute Pfad wird in `policies-config.json` als `customPoliciesPath` gespeichert. Die Datei wird bei jedem Hook-Event neu geladen – es gibt kein Caching zwischen Events.
 
-### Beide Varianten kombiniert
+### Beide Varianten zusammen verwenden
 
 Konventionsrichtlinien und die explizite `--custom`-Datei können nebeneinander existieren. Ladereihenfolge:
 
-1. Explizite `customPoliciesPath`-Datei (sofern konfiguriert)
-2. Projekt-Konventionsdateien (`{cwd}/.failproofai/policies/`, alphabetisch)
-3. Benutzer-Konventionsdateien (`~/.failproofai/policies/`, alphabetisch)
+1. Explizite `customPoliciesPath`-Datei (falls konfiguriert)
+2. Projektkonventionsdateien (`{cwd}/.failproofai/policies/`, alphabetisch)
+3. Benutzerkonventionsdateien (`~/.failproofai/policies/`, alphabetisch)
 
 ---
 
@@ -103,40 +103,40 @@ Registriert eine Richtlinie. Kann mehrfach aufgerufen werden, um mehrere Richtli
 ```ts
 customPolicies.add({
   name: string;                         // erforderlich – eindeutiger Bezeichner
-  description?: string;                 // erscheint in der `failproofai policies`-Ausgabe
-  match?: { events?: HookEventType[] }; // nach Event-Typ filtern; weglassen für alle Events
+  description?: string;                 // wird in der Ausgabe von `failproofai policies` angezeigt
+  match?: { events?: HookEventType[] }; // nach Event-Typ filtern; weglassen, um alle abzugleichen
   fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
 });
 ```
 
 ### Entscheidungs-Hilfsfunktionen
 
-| Funktion | Wirkung | Verwendung |
-|----------|---------|------------|
-| `allow()` | Operation lautlos zulassen | Die Aktion ist sicher, keine Meldung erforderlich |
+| Funktion | Wirkung | Verwenden, wenn |
+|----------|---------|-----------------|
+| `allow()` | Operation lautlos erlauben | Die Aktion ist sicher, keine Meldung erforderlich |
 | `deny(message)` | Operation blockieren | Der Agent soll diese Aktion nicht ausführen |
-| `instruct(message)` | Kontext hinzufügen ohne zu blockieren | Dem Agenten zusätzlichen Kontext geben, um ihn auf Kurs zu halten |
+| `instruct(message)` | Kontext hinzufügen, ohne zu blockieren | Dem Agenten zusätzlichen Kontext geben, damit er auf Kurs bleibt |
 
-`deny(message)` – die Nachricht erscheint für Claude mit dem Präfix `"Blocked by failproofai:"`. Ein einzelnes `deny` bricht alle weitere Auswertung ab.
+`deny(message)` – die Nachricht wird Claude mit dem Präfix `"Blocked by failproofai:"` angezeigt. Ein einzelnes `deny` bricht die gesamte weitere Auswertung ab.
 
-`instruct(message)` – die Nachricht wird dem Kontext von Claude für den aktuellen Tool-Aufruf angehängt. Alle `instruct`-Nachrichten werden gesammelt und gemeinsam zugestellt.
+`instruct(message)` – die Nachricht wird dem Kontext von Claude für den aktuellen Tool-Aufruf hinzugefügt. Alle `instruct`-Nachrichten werden gesammelt und gemeinsam übermittelt.
 
 <Tip>
-Zu jeder `deny`- oder `instruct`-Nachricht können zusätzliche Hinweise hinzugefügt werden, indem ein `hint`-Feld in `policyParams` gesetzt wird – ohne Codeänderung. Das funktioniert auch für benutzerdefinierte (`custom/`), Projekt-Konventions- (`.failproofai-project/`) und Benutzer-Konventionsrichtlinien (`.failproofai-user/`). Siehe [Konfiguration → hint](/de/configuration#hint-cross-cutting) für Details.
+Du kannst jeder `deny`- oder `instruct`-Nachricht zusätzliche Hinweise hinzufügen, indem du ein `hint`-Feld in `policyParams` setzt – ohne Codeänderung. Das funktioniert auch für benutzerdefinierte (`custom/`), Projektkonventions- (`.failproofai-project/`) und Benutzerkonventionsrichtlinien (`.failproofai-user/`). Weitere Details unter [Konfiguration → hint](/de/configuration#hint-cross-cutting).
 </Tip>
 
 ### Informative Allow-Nachrichten
 
-`allow(message)` erlaubt die Operation **und** sendet eine informative Nachricht zurück an Claude. Die Nachricht wird als `additionalContext` in der stdout-Antwort des Hook-Handlers zugestellt – derselbe Mechanismus wie bei `instruct`, aber semantisch anders: Es ist eine Statusmeldung, keine Warnung.
+`allow(message)` erlaubt die Operation **und** sendet eine informative Nachricht an Claude. Die Nachricht wird als `additionalContext` in der stdout-Antwort des Hook-Handlers übermittelt – derselbe Mechanismus wie bei `instruct`, aber semantisch anders: Es handelt sich um eine Statusmeldung, nicht um eine Warnung.
 
-| Funktion | Wirkung | Verwendung |
-|----------|---------|------------|
-| `allow(message)` | Zulassen und Kontext an Claude senden | Bestätigen, dass eine Prüfung bestanden wurde, oder erklären, warum sie übersprungen wurde |
+| Funktion | Wirkung | Verwenden, wenn |
+|----------|---------|-----------------|
+| `allow(message)` | Erlauben und Kontext an Claude senden | Bestätigen, dass eine Prüfung bestanden wurde, oder erklären, warum eine Prüfung übersprungen wurde |
 
 Anwendungsfälle:
-- **Statusbestätigungen:** `allow("All CI checks passed.")` – teilt Claude mit, dass alles grün ist
+- **Statusbestätigungen:** `allow("All CI checks passed.")` – teilt Claude mit, dass alles in Ordnung ist
 - **Fail-open-Erklärungen:** `allow("GitHub CLI not installed, skipping CI check.")` – erklärt Claude, warum eine Prüfung übersprungen wurde, damit er den vollen Kontext hat
-- **Mehrere Nachrichten werden akkumuliert:** Geben mehrere Richtlinien je ein `allow(message)` zurück, werden alle Nachrichten mit Zeilenumbrüchen verbunden und gemeinsam zugestellt
+- **Mehrere Nachrichten werden akkumuliert:** Wenn mehrere Richtlinien jeweils `allow(message)` zurückgeben, werden alle Nachrichten mit Zeilenumbrüchen verbunden und gemeinsam übermittelt
 
 ```js
 customPolicies.add({
@@ -155,30 +155,30 @@ customPolicies.add({
 });
 ```
 
-### `PolicyContext`-Felder
+### Felder von `PolicyContext`
 
 | Feld | Typ | Beschreibung |
 |------|-----|--------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string \| undefined` | Das aufgerufene Tool (z. B. `"Bash"`, `"Write"`, `"Read"`) |
 | `toolInput` | `Record<string, unknown> \| undefined` | Die Eingabeparameter des Tools |
-| `payload` | `Record<string, unknown>` | Vollständiger roher Event-Payload von Claude Code |
+| `payload` | `Record<string, unknown>` | Vollständige rohe Event-Nutzlast von Claude Code |
 | `session` | `SessionMetadata \| undefined` | Sitzungskontext (siehe unten) |
 
-### `SessionMetadata`-Felder
+### Felder von `SessionMetadata`
 
 | Feld | Typ | Beschreibung |
 |------|-----|--------------|
-| `sessionId` | `string` | Claude Code-Sitzungskennung |
+| `sessionId` | `string` | Claude Code-Sitzungsbezeichner |
 | `cwd` | `string` | Arbeitsverzeichnis der Claude Code-Sitzung |
 | `transcriptPath` | `string` | Pfad zur JSONL-Transkriptdatei der Sitzung |
 
 ### Event-Typen
 
-| Event | Wann es ausgelöst wird | Inhalt von `toolInput` |
-|-------|----------------------|----------------------|
+| Event | Wann ausgelöst | Inhalt von `toolInput` |
+|-------|---------------|------------------------|
 | `PreToolUse` | Bevor Claude ein Tool ausführt | Die Eingabe des Tools (z. B. `{ command: "..." }` für Bash) |
-| `PostToolUse` | Nachdem ein Tool abgeschlossen wurde | Die Eingabe des Tools + `tool_result` (die Ausgabe) |
+| `PostToolUse` | Nachdem ein Tool abgeschlossen ist | Die Eingabe des Tools + `tool_result` (die Ausgabe) |
 | `Notification` | Wenn Claude eine Benachrichtigung sendet | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` – Hooks müssen immer `allow()` zurückgeben, Benachrichtigungen können nicht blockiert werden |
 | `Stop` | Wenn die Claude-Sitzung endet | Leer |
 
@@ -188,18 +188,18 @@ customPolicies.add({
 
 Richtlinien werden in dieser Reihenfolge ausgewertet:
 
-1. Eingebaute Richtlinien (in Definitionsreihenfolge)
+1. Integrierte Richtlinien (in Definitionsreihenfolge)
 2. Explizite benutzerdefinierte Richtlinien aus `customPoliciesPath` (in `.add()`-Reihenfolge)
-3. Konventionsrichtlinien aus dem Projekt `.failproofai/policies/` (Dateien alphabetisch, `.add()`-Reihenfolge innerhalb)
+3. Konventionsrichtlinien aus dem Projekt unter `.failproofai/policies/` (Dateien alphabetisch, `.add()`-Reihenfolge innerhalb)
 4. Konventionsrichtlinien aus dem Benutzerverzeichnis `~/.failproofai/policies/` (Dateien alphabetisch, `.add()`-Reihenfolge innerhalb)
 
 <Note>
-Das erste `deny` bricht alle nachfolgenden Richtlinien ab. Alle `instruct`-Nachrichten werden gesammelt und gemeinsam zugestellt.
+Das erste `deny` bricht alle nachfolgenden Richtlinien ab. Alle `instruct`-Nachrichten werden gesammelt und gemeinsam übermittelt.
 </Note>
 
 ---
 
-## Transitive Importe
+## Transitive Imports
 
 Benutzerdefinierte Richtliniendateien können lokale Module über relative Pfade importieren:
 
@@ -218,13 +218,13 @@ customPolicies.add({
 });
 ```
 
-Alle transitiv erreichbaren relativen Importe von der Einstiegsdatei werden aufgelöst. Dies wird umgesetzt, indem `from "failproofai"`-Importe auf den tatsächlichen dist-Pfad umgeschrieben und temporäre `.mjs`-Dateien erstellt werden, um ESM-Kompatibilität sicherzustellen.
+Alle relativen Imports, die von der Einstiegsdatei aus erreichbar sind, werden aufgelöst. Dies wird implementiert, indem `from "failproofai"`-Imports auf den tatsächlichen dist-Pfad umgeschrieben und temporäre `.mjs`-Dateien erstellt werden, um ESM-Kompatibilität sicherzustellen.
 
 ---
 
-## Event-Typ-Filterung
+## Filterung nach Event-Typ
 
-Mit `match.events` lässt sich einschränken, wann eine Richtlinie ausgelöst wird:
+Verwende `match.events`, um einzuschränken, wann eine Richtlinie ausgelöst wird:
 
 ```js
 customPolicies.add({
@@ -238,26 +238,26 @@ customPolicies.add({
 });
 ```
 
-`match` ganz weglassen, um bei jedem Event-Typ auszulösen.
+Lass `match` vollständig weg, um bei jedem Event-Typ ausgelöst zu werden.
 
 ---
 
-## Fehlerbehandlung und Fehlerverhalten
+## Fehlerbehandlung und Fehlermodi
 
-Benutzerdefinierte Richtlinien sind **fail-open**: Fehler blockieren niemals eingebaute Richtlinien oder bringen den Hook-Handler zum Absturz.
+Benutzerdefinierte Richtlinien sind **fail-open**: Fehler blockieren niemals integrierte Richtlinien oder bringen den Hook-Handler zum Absturz.
 
 | Fehler | Verhalten |
 |--------|-----------|
-| `customPoliciesPath` nicht gesetzt | Keine expliziten benutzerdefinierten Richtlinien werden ausgeführt; Konventionsrichtlinien und eingebaute Richtlinien laufen normal weiter |
-| Datei nicht gefunden | Warnung wird in `~/.failproofai/hook.log` protokolliert; eingebaute Richtlinien laufen weiter |
+| `customPoliciesPath` nicht gesetzt | Keine expliziten benutzerdefinierten Richtlinien werden ausgeführt; Konventionsrichtlinien und integrierte Richtlinien laufen normal weiter |
+| Datei nicht gefunden | Warnung wird in `~/.failproofai/hook.log` protokolliert; integrierte Richtlinien laufen weiter |
 | Syntax-/Importfehler (explizit) | Fehler wird in `~/.failproofai/hook.log` protokolliert; explizite benutzerdefinierte Richtlinien werden übersprungen |
 | Syntax-/Importfehler (Konvention) | Fehler wird protokolliert; diese Datei wird übersprungen, andere Konventionsdateien werden weiterhin geladen |
 | `fn` wirft zur Laufzeit | Fehler wird protokolliert; dieser Hook wird als `allow` behandelt; andere Hooks laufen weiter |
-| `fn` dauert länger als 10 s | Timeout wird protokolliert; wird als `allow` behandelt |
+| `fn` dauert länger als 10 Sekunden | Timeout wird protokolliert; wird als `allow` behandelt |
 | Konventionsverzeichnis fehlt | Keine Konventionsrichtlinien werden ausgeführt; kein Fehler |
 
 <Tip>
-Zum Debuggen von benutzerdefinierten Richtlinienfehlern die Log-Datei beobachten:
+Um Fehler in benutzerdefinierten Richtlinien zu debuggen, beobachte die Protokolldatei:
 
 ```bash
 tail -f ~/.failproofai/hook.log
@@ -272,7 +272,7 @@ tail -f ~/.failproofai/hook.log
 // my-policies.js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
-// Verhindert, dass der Agent in das secrets/-Verzeichnis schreibt
+// Verhindert, dass der Agent in das Verzeichnis secrets/ schreibt
 customPolicies.add({
   name: "block-secrets-dir",
   description: "Prevent agent from writing to secrets/ directory",
@@ -300,7 +300,7 @@ customPolicies.add({
   },
 });
 
-// Verhindert ungeplante Abhängigkeitsänderungen während des Freeze
+// Verhindert ungeplante Abhängigkeitsänderungen während eines Freeze
 customPolicies.add({
   name: "dependency-freeze",
   description: "Prevent unplanned dependency changes during freeze period",
@@ -323,14 +323,14 @@ export { customPolicies };
 
 ## Beispiele
 
-Das Verzeichnis `examples/` enthält direkt ausführbare Richtliniendateien:
+Das Verzeichnis `examples/` enthält fertige Richtliniendateien:
 
 | Datei | Inhalt |
 |-------|--------|
-| `examples/policies-basic.js` | Fünf Starter-Richtlinien für häufige Agenten-Fehlermodi |
-| `examples/policies-advanced/index.js` | Fortgeschrittene Muster: transitive Importe, asynchrone Aufrufe, Ausgabebereinigung und Sitzungsend-Hooks |
-| `examples/convention-policies/security-policies.mjs` | Konventionsbasierte Sicherheitsrichtlinien (blockiert .env-Schreibzugriffe, verhindert Umschreiben der Git-Historie) |
-| `examples/convention-policies/workflow-policies.mjs` | Konventionsbasierte Workflow-Richtlinien (Test-Erinnerungen, Protokollierung von Datei-Schreibzugriffen) |
+| `examples/policies-basic.js` | Fünf Einstiegsrichtlinien für häufige Agenten-Fehlerszenarien |
+| `examples/policies-advanced/index.js` | Fortgeschrittene Muster: transitive Imports, asynchrone Aufrufe, Ausgabebereinigung und Sitzungsende-Hooks |
+| `examples/convention-policies/security-policies.mjs` | Konventionsbasierte Sicherheitsrichtlinien (blockiert .env-Schreibzugriffe, verhindert das Umschreiben der Git-Historie) |
+| `examples/convention-policies/workflow-policies.mjs` | Konventionsbasierte Workflow-Richtlinien (Test-Erinnerungen, Protokollierung von Dateiänderungen) |
 
 ### Explizite Dateibeispiele verwenden
 

package/.next/standalone/docs/de/examples.mdx

@@ -4,13 +4,13 @@ description: "So richten Sie Hooks für Claude Code und das Agents SDK ein"
 icon: book-open
 ---
 
-Sofort einsatzbereite Beispiele für häufige Szenarien. Jedes zeigt, wie die Installation funktioniert und was zu erwarten ist.
+Sofort verwendbare Beispiele für häufige Szenarien. Jedes zeigt, wie man es installiert und was zu erwarten ist.
 
 ---
 
 ## Hooks für Claude Code einrichten
 
-Failproof AI integriert sich mit Claude Code über dessen [Hooks-System](https://docs.anthropic.com/en/docs/claude-code/hooks). Wenn Sie `failproofai policies --install` ausführen, werden Hook-Befehle in der `settings.json` von Claude Code registriert, die bei jedem Tool-Aufruf ausgelöst werden.
+Failproof AI integriert sich mit Claude Code über dessen [Hooks-System](https://docs.anthropic.com/en/docs/claude-code/hooks). Wenn Sie `failproofai policies --install` ausführen, registriert es Hook-Befehle in der `settings.json` von Claude Code, die bei jedem Tool-Aufruf ausgelöst werden.
 
 <Steps>
   <Step title="failproofai installieren">
@@ -28,14 +28,14 @@ Failproof AI integriert sich mit Claude Code über dessen [Hooks-System](https:/
     cat ~/.claude/settings.json | grep failproofai
     ```
 
-    Sie sollten Hook-Einträge für `PreToolUse`-, `PostToolUse`-, `Notification`- und `Stop`-Ereignisse sehen.
+    Sie sollten Hook-Einträge für `PreToolUse`, `PostToolUse`, `Notification` und `Stop`-Ereignisse sehen.
   </Step>
   <Step title="Claude Code starten">
     ```bash
     claude
     ```
 
-    Richtlinien werden nun automatisch bei jedem Tool-Aufruf ausgeführt. Versuchen Sie, Claude aufzufordern, `sudo rm -rf /` auszuführen – der Befehl wird blockiert.
+    Richtlinien werden jetzt automatisch bei jedem Tool-Aufruf ausgeführt. Bitten Sie Claude, `sudo rm -rf /` auszuführen – es wird blockiert.
   </Step>
 </Steps>
 
@@ -43,7 +43,7 @@ Failproof AI integriert sich mit Claude Code über dessen [Hooks-System](https:/
 
 ## Hooks für das Agents SDK einrichten
 
-Wenn Sie mit dem [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) entwickeln, können Sie dasselbe Hook-System programmgesteuert verwenden.
+Wenn Sie mit dem [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) entwickeln, können Sie dasselbe Hook-System programmatisch verwenden.
 
 <Steps>
   <Step title="failproofai in Ihrem Projekt installieren">
@@ -52,7 +52,7 @@ Wenn Sie mit dem [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) ent
     ```
   </Step>
   <Step title="Hooks in Ihrem Agenten konfigurieren">
-    Übergeben Sie Hook-Befehle beim Erstellen Ihres Agentenprozesses. Die Hooks werden genauso wie in Claude Code ausgelöst – über stdin/stdout JSON:
+    Übergeben Sie Hook-Befehle beim Erstellen Ihres Agentenprozesses. Die Hooks werden genauso ausgelöst wie in Claude Code – über stdin/stdout JSON:
 
     ```bash
     failproofai --hook PreToolUse   # wird vor jedem Tool aufgerufen
@@ -104,19 +104,19 @@ Was dies bewirkt:
 
 ## Geheimnis-Leaks verhindern
 
-Verhindert, dass Agenten Anmeldedaten in der Tool-Ausgabe sehen oder weitergeben.
+Verhindert, dass Agenten Anmeldeinformationen in der Tool-Ausgabe sehen oder weitergeben.
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-Diese Richtlinien werden bei `PostToolUse` ausgelöst – nachdem ein Tool ausgeführt wurde, bereinigen sie die Ausgabe, bevor der Agent sie sieht.
+Diese werden bei `PostToolUse` ausgelöst – nachdem ein Tool ausgeführt wurde, bereinigen sie die Ausgabe, bevor der Agent sie sieht.
 
 ---
 
 ## Slack-Benachrichtigungen erhalten, wenn Agenten Aufmerksamkeit benötigen
 
-Verwenden Sie den Notification-Hook, um Leerlauf-Benachrichtigungen an Slack weiterzuleiten.
+Verwenden Sie den Benachrichtigungs-Hook, um Leerlauf-Warnungen an Slack weiterzuleiten.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -150,7 +150,7 @@ customPolicies.add({
 });
 ```
 
-Installation:
+Installieren:
 
 ```bash
 SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
@@ -160,7 +160,7 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ## Agenten auf einem Branch halten
 
-Verhindert, dass Agenten Branches wechseln oder in geschützte Branches pushen.
+Verhindert, dass Agenten Branches wechseln oder auf geschützte Branches pushen.
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
@@ -182,7 +182,7 @@ customPolicies.add({
 
 ---
 
-## Tests vor Commits verlangen
+## Tests vor Commits voraussetzen
 
 Erinnert Agenten daran, vor dem Committen Tests auszuführen.
 
@@ -231,7 +231,7 @@ Erstellen Sie `.failproofai/policies-config.json` in Ihrem Repository:
 }
 ```
 
-Dann committen Sie die Datei:
+Dann committen:
 
 ```bash
 git add .failproofai/policies-config.json
@@ -242,12 +242,66 @@ Jedes Teammitglied, das failproofai installiert hat, übernimmt diese Regeln aut
 
 ---
 
+## Einen organisationsweiten Qualitätsstandard mit Convention-Richtlinien aufbauen
+
+Das wirkungsvollste Setup: Committen Sie `.failproofai/policies/` in Ihr Repository mit auf Ihr Projekt zugeschnittenen Richtlinien. Jedes Teammitglied erhält sie automatisch – keine Installationsbefehle, keine Konfigurationsänderungen.
+
+<Steps>
+  <Step title="Verzeichnis erstellen und Richtlinien hinzufügen">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Bevorzugten Paketmanager Ihres Teams durchsetzen
+    // (oder stattdessen die integrierte prefer-package-manager-Richtlinie aktivieren)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Den Agenten daran erinnern, vor dem Committen Tests auszuführen
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="In Git committen">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="Kontinuierlich verbessern">
+    Wenn Ihr Team auf neue Fehlerquellen stößt, fügen Sie Richtlinien hinzu und pushen Sie. Jeder erhält die Aktualisierung beim nächsten `git pull`. Diese Richtlinien werden zu einem lebendigen Qualitätsstandard, der mit Ihrem Team wächst.
+  </Step>
+</Steps>
+
+---
+
 ## Weitere Beispiele
 
 Das Verzeichnis [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) im Repository enthält:
 
-| Datei | Inhalt |
-|-------|--------|
-| `policies-basic.js` | Grundlegende Richtlinien – blockiert Schreibzugriffe auf Produktion, Force-Push und weitergeleitete Skripte |
-| `policies-notification.js` | Slack-Benachrichtigungen bei Leerlauf-Meldungen und Sitzungsende |
-| `policies-advanced/index.js` | Transitive Imports, asynchrone Hooks, PostToolUse-Ausgabebereinigung, Stop-Ereignisbehandlung |
+| Datei | Was es zeigt |
+|-------|--------------|
+| `policies-basic.js` | Einstiegsrichtlinien – Schreibzugriffe auf Produktion, Force-Push und Piped-Skripte blockieren |
+| `policies-notification.js` | Slack-Benachrichtigungen für Leerlauf-Meldungen und Sitzungsende |
+| `policies-advanced/index.js` | Transitive Imports, asynchrone Hooks, PostToolUse-Ausgabebereinigung, Stop-Event-Behandlung |

package/.next/standalone/docs/de/getting-started.mdx

@@ -7,7 +7,7 @@ icon: rocket
 ## Voraussetzungen
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (optional – wird nur beim Erstellen aus dem Quellcode benötigt)
+- **Bun** >= 1.3.0 (optional – nur für das Erstellen aus dem Quellcode erforderlich)
 
 ---
 
@@ -31,13 +31,13 @@ bun add -g failproofai
 
 <Steps>
   <Step title="Policies aktivieren">
-    Policies sind Regeln, die vor und nach jedem Tool-Aufruf eines Agenten ausgeführt werden. Sie erkennen destruktive Befehle, den Abfluss von Geheimnissen und andere Fehlerquellen, bevor diese Schaden anrichten können.
+    Policies sind Regeln, die vor und nach jedem Werkzeugaufruf eines Agenten ausgeführt werden. Sie erkennen destruktive Befehle, das Durchsickern von Geheimnissen und andere Fehlerquellen, bevor Schaden entsteht.
 
     ```bash
     failproofai policies --install
     ```
 
-    Dadurch werden Hook-Einträge in die `settings.json` von Claude Code geschrieben. Die Installation kann auch auf ein einzelnes Projekt beschränkt oder auf bestimmte Policies begrenzt werden:
+    Dadurch werden Hook-Einträge in die `settings.json` von Claude Code geschrieben. Sie können auch für ein einzelnes Projekt installieren oder bestimmte Policies auswählen:
 
     ```bash
     failproofai policies --install --scope project
@@ -51,23 +51,23 @@ bun add -g failproofai
 
     Zeigt alle Policies an, ob sie aktiviert sind und welche Parameter konfiguriert wurden.
   </Step>
-  <Step title="Dashboard öffnen">
+  <Step title="Dashboard starten">
     ```bash
     failproofai
     ```
 
-    Öffnet ein lokales Dashboard unter `http://localhost:8020`, in dem Sessions durchsucht, Tool-Aufrufe inspiziert und Policies verwaltet werden können.
+    Öffnet ein lokales Dashboard unter `http://localhost:8020`, in dem Sie Sitzungen durchsuchen, Werkzeugaufrufe untersuchen und Policies verwalten können.
   </Step>
-  <Step title="Agenten starten">
-    Claude Code wie gewohnt starten. Wenn der Agent etwas Riskantes versucht, greift failproofai automatisch ein. Der Agent kann unbeaufsichtigt laufen gelassen werden – im Dashboard lässt sich anschließend nachvollziehen, was passiert ist.
+  <Step title="Agenten ausführen">
+    Starten Sie Claude Code wie gewohnt. Wenn der Agent etwas Riskantes versucht, greift failproofai automatisch ein. Lassen Sie ihn unbeaufsichtigt laufen und überprüfen Sie anschließend im Dashboard, was passiert ist.
   </Step>
 </Steps>
 
 ---
 
-## So funktionieren Policies
+## Wie Policies funktionieren
 
-Jedes Mal, wenn ein Agent ein Tool ausführt, ruft Claude Code failproofai als Unterprozess auf:
+Jedes Mal, wenn ein Agent ein Werkzeug ausführt, ruft Claude Code failproofai als Subprozess auf:
 
 ```text
 Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
@@ -78,26 +78,78 @@ Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
 Jede Policy gibt eine von drei Entscheidungen zurück:
 
 - **allow** – der Agent fährt normal fort
-- **deny** – die Aktion wird blockiert, der Agent wird über den Grund informiert
-- **instruct** – dem Prompt des Agenten wird zusätzlicher Kontext hinzugefügt
+- **deny** – die Aktion wird blockiert und dem Agenten wird der Grund mitgeteilt
+- **instruct** – dem Prompt des Agenten werden zusätzliche Informationen hinzugefügt
 
 <Note>
-Policies laufen im lokalen Prozess. Es werden keine Daten an einen externen Dienst gesendet.
+Policies laufen in Ihrem lokalen Prozess. Es werden keine Daten an einen externen Dienst übertragen.
 </Note>
 
 ---
 
+## Team-Policies mit konventionsbasierten Policies einrichten
+
+Der schnellste Weg, Qualitätsstandards im gesamten Team zu etablieren, ist die `.failproofai/policies/`-Konvention. Legen Sie Policy-Dateien in dieses Verzeichnis ab und sie werden automatisch geladen – ohne Flags, ohne Konfigurationsänderungen, ohne Installationsbefehle.
+
+<Steps>
+  <Step title="Policies-Verzeichnis erstellen">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Policy-Dateien hinzufügen">
+    Kopieren Sie die Starter-Beispiele oder schreiben Sie Ihre eigenen:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Oder erstellen Sie eine neue:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="In Git einchecken">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    Jedes Teammitglied, das failproofai installiert hat, übernimmt diese Policies automatisch. Es ist keine individuelle Einrichtung pro Entwickler erforderlich.
+  </Step>
+</Steps>
+
+<Tip>
+Checken Sie `.failproofai/policies/` in Ihr Repository ein, damit das gesamte Team dieselben Standards teilt. Sobald Ihr Team neue Fehlerquellen entdeckt, fügen Sie Policies hinzu und pushen Sie – alle erhalten die Aktualisierung beim nächsten `git pull`. Mit der Zeit werden diese Policies zu einem lebendigen Qualitätsstandard, der sich kontinuierlich verbessert.
+</Tip>
+
+---
+
 ## Datenspeicherung
 
-Alle Konfigurationen und Logs verbleiben auf dem eigenen Rechner:
+Alle Konfigurationen und Protokolle verbleiben auf Ihrem Rechner:
 
-| Pfad | Inhalt |
-|------|--------|
+| Pfad | Gespeicherte Inhalte |
+|------|----------------------|
 | `~/.failproofai/policies-config.json` | Globale Policy-Konfiguration |
-| `~/.failproofai/hook-activity.jsonl` | Hook-Ausführungshistorie |
-| `~/.failproofai/hook.log` | Debug-Log für Fehler in benutzerdefinierten Hooks |
-| `.failproofai/policies-config.json` | Projektspezifische Konfiguration (committed) |
-| `.failproofai/policies-config.local.json` | Persönliche Überschreibungen (gitignored) |
+| `~/.failproofai/hook-activity.jsonl` | Hook-Ausführungsverlauf |
+| `~/.failproofai/hook.log` | Debug-Protokoll für benutzerdefinierte Hook-Fehler |
+| `.failproofai/policies-config.json` | Projektspezifische Konfiguration (eingecheckt) |
+| `.failproofai/policies-config.local.json` | Persönliche Überschreibungen (per gitignore ausgeschlossen) |
 
 ---
 
@@ -128,7 +180,7 @@ Entfernt Hook-Einträge aus `~/.claude/settings.json`. Konfigurationsdateien in
 </Card>
 
 <Card title="Agenten-Monitor" icon="chart-line" href="/de/dashboard">
-  Sessions überwachen und Policy-Aktivitäten einsehen
+  Sitzungen überwachen und Policy-Aktivität einsehen
 </Card>
 
 </CardGroup>