failproofai 0.0.6-beta.1 → 0.0.6-beta.2

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

@@ -1,10 +1,10 @@
 ---
 title: Politiques personnalisées
-description: "Écrivez vos propres politiques en JavaScript — appliquez des conventions, prévenez la dérive, détectez les défaillances, intégrez des systèmes externes"
+description: "Rédigez vos propres politiques en JavaScript — appliquez des conventions de projet, évitez la dérive, détectez les échecs, intégrez des systèmes externes"
 icon: code
 ---
 
-Les politiques personnalisées vous permettent d'écrire des règles pour n'importe quel comportement d'agent : appliquer des conventions de projet, prévenir la dérive, bloquer les opérations destructives, détecter les agents bloqués, ou s'intégrer avec Slack, des workflows d'approbation, et bien plus. Elles utilisent le même système d'événements de hook et les mêmes décisions `allow`, `deny`, `instruct` que les politiques intégrées.
+Les politiques personnalisées vous permettent d'écrire des règles pour n'importe quel comportement d'agent : appliquer des conventions de projet, prévenir la dérive, contrôler les opérations destructrices, détecter les agents bloqués, ou s'intégrer avec Slack, des workflows d'approbation, et plus encore. Elles utilisent le même système d'événements hook et les mêmes décisions `allow`, `deny`, `instruct` que les politiques intégrées.
 
 ---
 
@@ -29,7 +29,7 @@ customPolicies.add({
 });
 ```
 
-Installation :
+Installez-le :
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -39,12 +39,12 @@ failproofai policies --install --custom ./my-policies.js
 
 ## Deux façons de charger des politiques personnalisées
 
-### Option 1 : Basée sur les conventions (recommandée)
+### Option 1 : Par convention (recommandé)
 
-Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et ils sont automatiquement chargés — aucun indicateur ni modification de configuration nécessaire. Cela fonctionne comme les hooks git : déposez un fichier, et c'est tout.
+Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et ils sont chargés automatiquement — sans indicateurs ni modifications de configuration. Cela fonctionne comme les hooks git : déposez un fichier, ça fonctionne.
 
 ```
-# Niveau projet — validé dans git, partagé avec l'équipe
+# Niveau projet — commité dans git, partagé avec l'équipe
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
@@ -52,15 +52,15 @@ Déposez des fichiers `*policies.{js,mjs,ts}` dans `.failproofai/policies/` et i
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-**Fonctionnement :**
-- Les répertoires du projet et de l'utilisateur sont tous deux analysés (union — pas de priorité au premier scope)
+**Comment ça fonctionne :**
+- Les répertoires projet et utilisateur sont tous deux analysés (union — pas de priorité par périmètre)
 - Les fichiers sont chargés par ordre alphabétique dans chaque répertoire. Préfixez avec `01-`, `02-` pour contrôler l'ordre
 - Seuls les fichiers correspondant à `*policies.{js,mjs,ts}` sont chargés ; les autres fichiers sont ignorés
 - Chaque fichier est chargé indépendamment (fail-open par fichier)
-- Fonctionne conjointement avec les politiques `--custom` explicites et les politiques intégrées
+- Fonctionne avec les politiques `--custom` explicites et les politiques intégrées
 
 <Tip>
-Les politiques par convention sont le moyen le plus simple de partager des politiques au sein d'une équipe. Validez `.failproofai/policies/` dans git et chaque membre de l'équipe les obtient automatiquement.
+Les politiques par convention sont le moyen le plus simple de définir un standard de qualité pour votre organisation. Commitez `.failproofai/policies/` dans git et chaque membre de l'équipe obtient les mêmes règles automatiquement — aucune configuration individuelle requise. Au fil des découvertes de nouveaux modes d'échec, ajoutez une politique et poussez. Ces politiques deviennent avec le temps un standard de qualité vivant qui s'améliore à chaque contribution.
 </Tip>
 
 ### Option 2 : Chemin de fichier explicite
@@ -72,11 +72,11 @@ failproofai policies --install --custom ./my-policies.js
 # Remplacer le chemin du fichier de politiques
 failproofai policies --install --custom ./new-policies.js
 
-# Supprimer le chemin de politiques personnalisées de la configuration
+# Supprimer le chemin des politiques personnalisées de la configuration
 failproofai policies --uninstall --custom
 ```
 
-Le chemin absolu résolu est stocké dans `policies-config.json` sous `customPoliciesPath`. Le fichier est chargé à nouveau à chaque événement de hook — il n'y a pas de mise en cache entre les événements.
+Le chemin absolu résolu est stocké dans `policies-config.json` sous `customPoliciesPath`. Le fichier est chargé à nouveau à chaque événement hook — il n'y a pas de mise en cache entre les événements.
 
 ### Utiliser les deux ensemble
 
@@ -84,7 +84,7 @@ Les politiques par convention et le fichier `--custom` explicite peuvent coexist
 
 1. Fichier `customPoliciesPath` explicite (si configuré)
 2. Fichiers de convention du projet (`{cwd}/.failproofai/policies/`, alphabétique)
-3. Fichiers de convention de l'utilisateur (`~/.failproofai/policies/`, alphabétique)
+3. Fichiers de convention utilisateur (`~/.failproofai/policies/`, alphabétique)
 
 ---
 
@@ -102,7 +102,7 @@ Enregistre une politique. Appelez cette fonction autant de fois que nécessaire
 
 ```ts
 customPolicies.add({
-  name: string;                         // obligatoire - identifiant unique
+  name: string;                         // requis - identifiant unique
   description?: string;                 // affiché dans la sortie de `failproofai policies`
   match?: { events?: HookEventType[] }; // filtrer par type d'événement ; omettre pour tout correspondre
   fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
@@ -117,26 +117,26 @@ customPolicies.add({
 | `deny(message)` | Bloque l'opération | L'agent ne doit pas effectuer cette action |
 | `instruct(message)` | Ajoute du contexte sans bloquer | Donner à l'agent un contexte supplémentaire pour rester sur la bonne voie |
 
-`deny(message)` — le message apparaît à Claude préfixé par `"Blocked by failproofai:"`. Un seul `deny` court-circuite toute évaluation ultérieure.
+`deny(message)` — le message apparaît à Claude préfixé de `"Blocked by failproofai:"`. Un seul `deny` court-circuite toute évaluation ultérieure.
 
-`instruct(message)` — le message est ajouté au contexte de Claude pour l'appel d'outil en cours. Tous les messages `instruct` sont accumulés et délivrés ensemble.
+`instruct(message)` — le message est ajouté au contexte de Claude pour l'appel d'outil en cours. Tous les messages `instruct` sont accumulés et transmis ensemble.
 
 <Tip>
-Vous pouvez ajouter des indications supplémentaires à n'importe quel message `deny` ou `instruct` en ajoutant un champ `hint` dans `policyParams` — aucune modification de code nécessaire. Cela fonctionne également pour les politiques personnalisées (`custom/`), les politiques de convention de projet (`.failproofai-project/`) et les politiques de convention utilisateur (`.failproofai-user/`). Consultez [Configuration → hint](/fr/configuration#hint-cross-cutting) pour plus de détails.
+Vous pouvez ajouter des instructions supplémentaires à n'importe quel message `deny` ou `instruct` en ajoutant un champ `hint` dans `policyParams` — sans modification de code. Cela fonctionne également pour les politiques personnalisées (`custom/`), par convention de projet (`.failproofai-project/`) et par convention utilisateur (`.failproofai-user/`). Consultez [Configuration → hint](/fr/configuration#hint-cross-cutting) pour plus de détails.
 </Tip>
 
-### Messages d'autorisation informatifs
+### Messages allow informatifs
 
-`allow(message)` autorise l'opération **et** envoie un message informatif à Claude. Le message est délivré en tant que `additionalContext` dans la réponse stdout du gestionnaire de hook — le même mécanisme qu'`instruct`, mais sémantiquement différent : c'est une mise à jour de statut, pas un avertissement.
+`allow(message)` autorise l'opération **et** envoie un message informatif à Claude. Le message est transmis en tant qu'`additionalContext` dans la réponse stdout du gestionnaire de hook — le même mécanisme utilisé par `instruct`, mais sémantiquement différent : c'est une mise à jour de statut, pas un avertissement.
 
 | Fonction | Effet | Utiliser quand |
 |----------|--------|----------|
-| `allow(message)` | Autoriser et envoyer du contexte à Claude | Confirmer qu'une vérification a réussi, ou expliquer pourquoi une vérification a été ignorée |
+| `allow(message)` | Autorise et envoie du contexte à Claude | Confirmer qu'une vérification a réussi, ou expliquer pourquoi une vérification a été ignorée |
 
-Cas d'utilisation :
+Cas d'usage :
 - **Confirmations de statut :** `allow("All CI checks passed.")` — indique à Claude que tout est en ordre
 - **Explications fail-open :** `allow("GitHub CLI not installed, skipping CI check.")` — indique à Claude pourquoi une vérification a été ignorée afin qu'il dispose du contexte complet
-- **Accumulation de plusieurs messages :** si plusieurs politiques retournent chacune `allow(message)`, tous les messages sont joints par des sauts de ligne et délivrés ensemble
+- **Accumulation de plusieurs messages :** si plusieurs politiques retournent chacune `allow(message)`, tous les messages sont joints avec des sauts de ligne et transmis ensemble
 
 ```js
 customPolicies.add({
@@ -162,7 +162,7 @@ customPolicies.add({
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string \| undefined` | L'outil appelé (ex. `"Bash"`, `"Write"`, `"Read"`) |
 | `toolInput` | `Record<string, unknown> \| undefined` | Les paramètres d'entrée de l'outil |
-| `payload` | `Record<string, unknown>` | Charge utile brute complète de l'événement provenant de Claude Code |
+| `payload` | `Record<string, unknown>` | Charge utile brute complète de l'événement depuis Claude Code |
 | `session` | `SessionMetadata \| undefined` | Contexte de session (voir ci-dessous) |
 
 ### Champs de `SessionMetadata`
@@ -177,8 +177,8 @@ customPolicies.add({
 
 | Événement | Quand il se déclenche | Contenu de `toolInput` |
 |-------|--------------|----------------------|
-| `PreToolUse` | Avant que Claude exécute un outil | L'entrée de l'outil (ex. `{ command: "..." }` pour Bash) |
-| `PostToolUse` | Après qu'un outil se termine | L'entrée de l'outil + `tool_result` (la sortie) |
+| `PreToolUse` | Avant qu'un outil soit exécuté par Claude | L'entrée de l'outil (ex. `{ command: "..." }` pour Bash) |
+| `PostToolUse` | Après la fin d'un outil | L'entrée de l'outil + `tool_result` (la sortie) |
 | `Notification` | Quand Claude envoie une notification | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` — les hooks doivent toujours retourner `allow()`, ils ne peuvent pas bloquer les notifications |
 | `Stop` | Quand la session Claude se termine | Vide |
 
@@ -189,19 +189,19 @@ customPolicies.add({
 Les politiques sont évaluées dans cet ordre :
 
 1. Politiques intégrées (dans l'ordre de définition)
-2. Politiques personnalisées explicites depuis `customPoliciesPath` (dans l'ordre `.add()`)
+2. Politiques personnalisées explicites depuis `customPoliciesPath` (dans l'ordre de `.add()`)
 3. Politiques de convention du projet `.failproofai/policies/` (fichiers alphabétiques, ordre `.add()` à l'intérieur)
-4. Politiques de convention de l'utilisateur `~/.failproofai/policies/` (fichiers alphabétiques, ordre `.add()` à l'intérieur)
+4. Politiques de convention utilisateur `~/.failproofai/policies/` (fichiers alphabétiques, ordre `.add()` à l'intérieur)
 
 <Note>
-Le premier `deny` court-circuite toutes les politiques suivantes. Tous les messages `instruct` sont accumulés et délivrés ensemble.
+Le premier `deny` court-circuite toutes les politiques suivantes. Tous les messages `instruct` sont accumulés et transmis ensemble.
 </Note>
 
 ---
 
 ## Imports transitifs
 
-Les fichiers de politiques personnalisées peuvent importer des modules locaux en utilisant des chemins relatifs :
+Les fichiers de politiques personnalisées peuvent importer des modules locaux via des chemins relatifs :
 
 ```js
 // my-policies.js
@@ -218,13 +218,13 @@ customPolicies.add({
 });
 ```
 
-Tous les imports relatifs accessibles depuis le fichier d'entrée sont résolus. Ceci est implémenté en réécrivant les imports `from "failproofai"` vers le chemin dist réel et en créant des fichiers `.mjs` temporaires pour garantir la compatibilité ESM.
+Tous les imports relatifs accessibles depuis le fichier d'entrée sont résolus. Ceci est implémenté en réécrivant les imports `from "failproofai"` vers le chemin dist réel et en créant des fichiers `.mjs` temporaires pour assurer la compatibilité ESM.
 
 ---
 
 ## Filtrage par type d'événement
 
-Utilisez `match.events` pour limiter quand une politique se déclenche :
+Utilisez `match.events` pour limiter le déclenchement d'une politique :
 
 ```js
 customPolicies.add({
@@ -238,23 +238,23 @@ customPolicies.add({
 });
 ```
 
-Omettez `match` entièrement pour se déclencher à chaque type d'événement.
+Omettez `match` entièrement pour se déclencher sur chaque type d'événement.
 
 ---
 
-## Gestion des erreurs et modes de défaillance
+## Gestion des erreurs et modes d'échec
 
-Les politiques personnalisées sont **fail-open** : les erreurs ne bloquent jamais les politiques intégrées ni ne font planter le gestionnaire de hook.
+Les politiques personnalisées sont **fail-open** : les erreurs ne bloquent jamais les politiques intégrées et ne font pas planter le gestionnaire de hook.
 
-| Défaillance | Comportement |
+| Échec | Comportement |
 |---------|----------|
-| `customPoliciesPath` non défini | Aucune politique personnalisée explicite ne s'exécute ; les politiques de convention et les politiques intégrées continuent normalement |
+| `customPoliciesPath` non défini | Aucune politique personnalisée explicite n'est exécutée ; les politiques par convention et intégrées continuent normalement |
 | Fichier introuvable | Avertissement consigné dans `~/.failproofai/hook.log` ; les politiques intégrées continuent |
-| Erreur de syntaxe/import (explicite) | Erreur consignée dans `~/.failproofai/hook.log` ; les politiques personnalisées explicites sont ignorées |
-| Erreur de syntaxe/import (convention) | Erreur consignée ; ce fichier est ignoré, les autres fichiers de convention se chargent quand même |
+| Erreur de syntaxe/import (explicite) | Erreur consignée dans `~/.failproofai/hook.log` ; politiques personnalisées explicites ignorées |
+| Erreur de syntaxe/import (convention) | Erreur consignée ; ce fichier est ignoré, les autres fichiers de convention sont toujours chargés |
 | `fn` lève une exception à l'exécution | Erreur consignée ; ce hook est traité comme `allow` ; les autres hooks continuent |
-| `fn` prend plus de 10 s | Délai consigné ; traité comme `allow` |
-| Répertoire de convention manquant | Aucune politique de convention ne s'exécute ; aucune erreur |
+| `fn` prend plus de 10 secondes | Timeout consigné ; traité comme `allow` |
+| Répertoire de convention manquant | Aucune politique de convention n'est exécutée ; aucune erreur |
 
 <Tip>
 Pour déboguer les erreurs de politiques personnalisées, surveillez le fichier de log :
@@ -272,7 +272,7 @@ tail -f ~/.failproofai/hook.log
 // my-policies.js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
-// Prevent agent from writing to secrets/ directory
+// Empêche l'agent d'écrire dans le répertoire secrets/
 customPolicies.add({
   name: "block-secrets-dir",
   description: "Prevent agent from writing to secrets/ directory",
@@ -285,7 +285,7 @@ customPolicies.add({
   },
 });
 
-// Keep the agent on track: verify tests before committing
+// Maintient l'agent sur la bonne voie : vérifier les tests avant de commiter
 customPolicies.add({
   name: "remind-test-before-commit",
   description: "Keep the agent on track: verify tests pass before committing",
@@ -300,7 +300,7 @@ customPolicies.add({
   },
 });
 
-// Prevent unplanned dependency changes during freeze
+// Empêche les modifications de dépendances non planifiées pendant le gel
 customPolicies.add({
   name: "dependency-freeze",
   description: "Prevent unplanned dependency changes during freeze period",
@@ -327,10 +327,10 @@ Le répertoire `examples/` contient des fichiers de politiques prêts à l'emplo
 
 | Fichier | Contenu |
 |------|----------|
-| `examples/policies-basic.js` | Cinq politiques de démarrage couvrant les modes de défaillance courants des agents |
-| `examples/policies-advanced/index.js` | Modèles avancés : imports transitifs, appels asynchrones, nettoyage des sorties et hooks de fin de session |
-| `examples/convention-policies/security-policies.mjs` | Politiques de sécurité basées sur les conventions (bloquer les écritures .env, empêcher la réécriture de l'historique git) |
-| `examples/convention-policies/workflow-policies.mjs` | Politiques de workflow basées sur les conventions (rappels de tests, audit des écritures de fichiers) |
+| `examples/policies-basic.js` | Cinq politiques de démarrage couvrant les modes d'échec courants des agents |
+| `examples/policies-advanced/index.js` | Modèles avancés : imports transitifs, appels asynchrones, nettoyage de sortie et hooks de fin de session |
+| `examples/convention-policies/security-policies.mjs` | Politiques de sécurité par convention (bloquer les écritures .env, empêcher la réécriture de l'historique git) |
+| `examples/convention-policies/workflow-policies.mjs` | Politiques de workflow par convention (rappels de tests, audit des écritures de fichiers) |
 
 ### Utiliser les exemples de fichiers explicites
 
@@ -338,16 +338,16 @@ Le répertoire `examples/` contient des fichiers de politiques prêts à l'emplo
 failproofai policies --install --custom ./examples/policies-basic.js
 ```
 
-### Utiliser les exemples basés sur les conventions
+### Utiliser les exemples par convention
 
 ```bash
-# Copier au niveau du projet
+# Copier au niveau projet
 mkdir -p .failproofai/policies
 cp examples/convention-policies/*.mjs .failproofai/policies/
 
-# Ou copier au niveau de l'utilisateur
+# Ou copier au niveau utilisateur
 mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```
 
-Aucune commande d'installation nécessaire — les fichiers sont récupérés automatiquement au prochain événement de hook.
+Aucune commande d'installation n'est nécessaire — les fichiers sont automatiquement détectés au prochain événement hook.

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

@@ -1,10 +1,10 @@
 ---
 title: Exemples
-description: "Comment configurer des hooks pour Claude Code et le Agents SDK"
+description: "Comment configurer des hooks pour Claude Code et l'Agents SDK"
 icon: book-open
 ---
 
-Des exemples prêts à l'emploi pour les scénarios courants. Chacun montre comment installer et ce que vous pouvez attendre.
+Des exemples prêts à l'emploi pour les scénarios courants. Chacun montre comment l'installer et ce à quoi s'attendre.
 
 ---
 
@@ -35,15 +35,15 @@ Failproof AI s'intègre à Claude Code via son [système de hooks](https://docs.
     claude
     ```
 
-    Les politiques s'exécutent désormais automatiquement à chaque appel d'outil. Essayez de demander à Claude d'exécuter `sudo rm -rf /` — cela sera bloqué.
+    Les politiques s'exécutent désormais automatiquement à chaque appel d'outil. Essayez de demander à Claude d'exécuter `sudo rm -rf /` — la commande sera bloquée.
   </Step>
 </Steps>
 
 ---
 
-## Configurer des hooks pour le Agents SDK
+## Configurer des hooks pour l'Agents SDK
 
-Si vous développez avec le [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), vous pouvez utiliser le même système de hooks par programmation.
+Si vous développez avec l'[Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), vous pouvez utiliser le même système de hooks de manière programmatique.
 
 <Steps>
   <Step title="Installer failproofai dans votre projet">
@@ -52,7 +52,7 @@ Si vous développez avec le [Agents SDK](https://docs.anthropic.com/en/docs/agen
     ```
   </Step>
   <Step title="Configurer les hooks dans votre agent">
-    Passez des commandes de hooks lors de la création de votre processus agent. Les hooks se déclenchent de la même manière que dans Claude Code — via stdin/stdout JSON :
+    Transmettez des commandes de hooks lors de la création de votre processus agent. Les hooks se déclenchent de la même manière que dans Claude Code — via JSON en stdin/stdout :
 
     ```bash
     failproofai --hook PreToolUse   # appelé avant chaque outil
@@ -65,7 +65,7 @@ Si vous développez avec le [Agents SDK](https://docs.anthropic.com/en/docs/agen
 
     customPolicies.add({
       name: "limit-to-project-dir",
-      description: "Keep the agent inside the project directory",
+      description: "Maintenir l'agent dans le répertoire du projet",
       match: { events: ["PreToolUse"] },
       fn: async (ctx) => {
         const path = String(ctx.toolInput?.file_path ?? "");
@@ -86,7 +86,7 @@ Si vous développez avec le [Agents SDK](https://docs.anthropic.com/en/docs/agen
 
 ---
 
-## Bloquer les commandes destructives
+## Bloquer les commandes destructrices
 
 La configuration la plus courante — empêcher les agents de causer des dommages irréversibles.
 
@@ -94,36 +94,36 @@ La configuration la plus courante — empêcher les agents de causer des dommage
 failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
 ```
 
-Ce que ça fait :
+Ce que cela fait :
 - `block-sudo` — bloque toutes les commandes `sudo`
 - `block-rm-rf` — bloque la suppression récursive de fichiers
-- `block-force-push` — bloque les `git push --force`
-- `block-curl-pipe-sh` — bloque le piping de scripts distants vers le shell
+- `block-force-push` — bloque `git push --force`
+- `block-curl-pipe-sh` — bloque l'exécution de scripts distants via un pipe vers le shell
 
 ---
 
 ## Prévenir les fuites de secrets
 
-Empêchez les agents de voir ou de divulguer des identifiants dans la sortie des outils.
+Empêcher les agents de voir ou de divulguer des identifiants dans la sortie des outils.
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-Ces politiques se déclenchent sur `PostToolUse` — après l'exécution d'un outil, elles nettoient la sortie avant que l'agent ne la voie.
+Ces politiques se déclenchent sur `PostToolUse` — après l'exécution d'un outil, elles nettoient la sortie avant que l'agent ne la reçoive.
 
 ---
 
 ## Recevoir des alertes Slack quand les agents ont besoin d'attention
 
-Utilisez le hook de notification pour transmettre les alertes d'inactivité vers Slack.
+Utilisez le hook de notification pour transférer les alertes d'inactivité vers Slack.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
 
 customPolicies.add({
   name: "slack-on-idle",
-  description: "Alert Slack when the agent is waiting for input",
+  description: "Alerter Slack quand l'agent attend une entrée",
   match: { events: ["Notification"] },
   fn: async (ctx) => {
     const webhookUrl = process.env.SLACK_WEBHOOK_URL;
@@ -160,14 +160,14 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ## Maintenir les agents sur une branche
 
-Empêchez les agents de changer de branche ou de pousser vers des branches protégées.
+Empêcher les agents de changer de branche ou de pousser vers des branches protégées.
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
 
 customPolicies.add({
   name: "stay-on-branch",
-  description: "Prevent the agent from checking out other branches",
+  description: "Empêcher l'agent de basculer sur d'autres branches",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolName !== "Bash") return allow();
@@ -184,14 +184,14 @@ customPolicies.add({
 
 ## Exiger des tests avant les commits
 
-Rappelez aux agents d'exécuter les tests avant de committer.
+Rappeler aux agents d'exécuter les tests avant de committer.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
 
 customPolicies.add({
   name: "test-before-commit",
-  description: "Remind the agent to run tests before committing",
+  description: "Rappeler à l'agent d'exécuter les tests avant de committer",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolName !== "Bash") return allow();
@@ -206,9 +206,9 @@ customPolicies.add({
 
 ---
 
-## Verrouiller un dépôt de production
+## Sécuriser un dépôt de production
 
-Commitez une configuration au niveau du projet pour que tous les développeurs de votre équipe bénéficient des mêmes politiques.
+Committez une configuration au niveau du projet afin que tous les développeurs de votre équipe bénéficient des mêmes politiques.
 
 Créez `.failproofai/policies-config.json` dans votre dépôt :
 
@@ -231,7 +231,7 @@ Créez `.failproofai/policies-config.json` dans votre dépôt :
 }
 ```
 
-Puis commitez-le :
+Puis committez-le :
 
 ```bash
 git add .failproofai/policies-config.json
@@ -242,12 +242,66 @@ Chaque membre de l'équipe ayant failproofai installé récupérera automatiquem
 
 ---
 
+## Établir un standard qualité à l'échelle de l'organisation avec des politiques de convention
+
+La configuration la plus impactante : committez `.failproofai/policies/` dans votre dépôt avec des politiques adaptées à votre projet. Tous les membres de l'équipe les récupèrent automatiquement — sans commandes d'installation ni modifications de configuration.
+
+<Steps>
+  <Step title="Créer le répertoire et ajouter des politiques">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Imposer le gestionnaire de paquets préféré de votre équipe
+    // (ou activez plutôt la politique intégrée prefer-package-manager)
+    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();
+      },
+    });
+
+    // Rappeler à l'agent d'exécuter les tests avant de committer
+    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="Committer dans git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="Continuer à améliorer">
+    Au fur et à mesure que votre équipe rencontre de nouveaux types d'échecs, ajoutez des politiques et poussez-les. Tout le monde reçoit la mise à jour au prochain `git pull`. Ces politiques deviennent un standard qualité vivant qui évolue avec votre équipe.
+  </Step>
+</Steps>
+
+---
+
 ## Plus d'exemples
 
 Le répertoire [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) du dépôt contient :
 
 | Fichier | Ce qu'il illustre |
 |---------|-------------------|
-| `policies-basic.js` | Politiques de démarrage — bloquer les écritures en production, les force-push et les scripts pipés |
+| `policies-basic.js` | Politiques de base — bloquer les écritures en production, les force-push, les scripts pipés |
 | `policies-notification.js` | Alertes Slack pour les notifications d'inactivité et la fin de session |
-| `policies-advanced/index.js` | Imports transitifs, hooks asynchrones, nettoyage de la sortie `PostToolUse`, gestion de l'événement `Stop` |
+| `policies-advanced/index.js` | Imports transitifs, hooks asynchrones, nettoyage de la sortie PostToolUse, gestion de l'événement Stop |

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

@@ -1,13 +1,13 @@
 ---
 title: Démarrage rapide
-description: "Installez failproofai, activez les politiques et laissez vos agents s'exécuter de manière fiable"
+description: "Installez failproofai, activez les politiques et laissez vos agents fonctionner de manière fiable"
 icon: rocket
 ---
 
 ## Prérequis
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (optionnel - uniquement nécessaire pour compiler depuis les sources)
+- **Bun** >= 1.3.0 (optionnel - nécessaire uniquement pour compiler depuis les sources)
 
 ---
 
@@ -31,13 +31,13 @@ bun add -g failproofai
 
 <Steps>
   <Step title="Activer les politiques">
-    Les politiques sont des règles qui s'exécutent avant et après chaque appel d'outil de l'agent. Elles interceptent les commandes destructrices, les fuites de secrets et autres modes de défaillance avant qu'ils ne causent des dommages.
+    Les politiques sont des règles qui s'exécutent avant et après chaque appel d'outil de l'agent. Elles interceptent les commandes destructrices, les fuites de secrets et d'autres modes de défaillance avant qu'ils ne causent des dommages.
 
     ```bash
     failproofai policies --install
     ```
 
-    Cela écrit des entrées de hook dans le fichier `settings.json` de Claude Code. Vous pouvez également installer pour un seul projet ou choisir des politiques spécifiques :
+    Cette commande inscrit les entrées de hook dans le fichier `settings.json` de Claude Code. Vous pouvez également installer pour un seul projet ou choisir des politiques spécifiques :
 
     ```bash
     failproofai policies --install --scope project
@@ -65,7 +65,7 @@ bun add -g failproofai
 
 ---
 
-## Comment fonctionnent les politiques
+## Fonctionnement des politiques
 
 Chaque fois qu'un agent exécute un outil, Claude Code appelle failproofai en tant que sous-processus :
 
@@ -79,14 +79,66 @@ Chaque politique retourne l'une des trois décisions suivantes :
 
 - **allow** - l'agent continue normalement
 - **deny** - l'action est bloquée, l'agent est informé de la raison
-- **instruct** - du contexte supplémentaire est ajouté au prompt de l'agent
+- **instruct** - du contexte supplémentaire est ajouté à l'invite de l'agent
 
 <Note>
-Les politiques s'exécutent dans votre processus local. Aucune donnée n'est envoyée à un service distant.
+Les politiques s'exécutent dans votre processus local. Rien n'est envoyé à un service distant.
 </Note>
 
 ---
 
+## Configurer des politiques d'équipe avec les politiques par convention
+
+La façon la plus rapide d'établir des standards de qualité au sein de votre équipe est la convention `.failproofai/policies/`. Déposez des fichiers de politiques dans ce répertoire et ils sont chargés automatiquement — sans options, sans modification de configuration, sans commandes d'installation.
+
+<Steps>
+  <Step title="Créer le répertoire des politiques">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Ajouter des fichiers de politiques">
+    Copiez les exemples de démarrage ou créez les vôtres :
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Ou créez-en un nouveau :
+
+    ```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="Valider dans git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    Chaque membre de l'équipe ayant failproofai installé récupère ces politiques automatiquement. Aucune configuration individuelle n'est nécessaire.
+  </Step>
+</Steps>
+
+<Tip>
+Commitez `.failproofai/policies/` dans votre dépôt afin que toute l'équipe partage les mêmes standards. Au fur et à mesure que votre équipe découvre de nouveaux modes de défaillance, ajoutez des politiques et poussez-les — tout le monde reçoit la mise à jour au prochain `git pull`. Au fil du temps, ces politiques deviennent un standard de qualité vivant qui ne cesse de s'améliorer.
+</Tip>
+
+---
+
 ## Stockage des données
 
 Toute la configuration et les journaux restent sur votre machine :
@@ -96,8 +148,8 @@ Toute la configuration et les journaux restent sur votre machine :
 | `~/.failproofai/policies-config.json` | Configuration globale des politiques |
 | `~/.failproofai/hook-activity.jsonl` | Historique d'exécution des hooks |
 | `~/.failproofai/hook.log` | Journal de débogage pour les erreurs de hooks personnalisés |
-| `.failproofai/policies-config.json` | Configuration par projet (validée dans le dépôt) |
-| `.failproofai/policies-config.local.json` | Remplacements personnels (ignorés par git) |
+| `.failproofai/policies-config.json` | Configuration par projet (versionnée) |
+| `.failproofai/policies-config.local.json` | Substitutions personnelles (ignorées par git) |
 
 ---
 
@@ -111,12 +163,12 @@ Supprime les entrées de hook du fichier `~/.claude/settings.json`. Les fichiers
 
 ---
 
-## Étapes suivantes
+## Prochaines étapes
 
 <CardGroup cols={2}>
 
 <Card title="Configuration" icon="gear" href="/fr/configuration">
-  Périmètres et format des fichiers de configuration
+  Portées et format des fichiers de configuration
 </Card>
 
 <Card title="Politiques intégrées" icon="shield" href="/fr/built-in-policies">
@@ -127,8 +179,8 @@ Supprime les entrées de hook du fichier `~/.claude/settings.json`. Les fichiers
   Écrivez vos propres politiques en JavaScript
 </Card>
 
-<Card title="Moniteur d'agents" icon="chart-line" href="/fr/dashboard">
-  Surveillez les sessions et consultez l'activité des politiques
+<Card title="Moniteur d'agent" icon="chart-line" href="/fr/dashboard">
+  Surveillez les sessions et examinez l'activité des politiques
 </Card>
 
 </CardGroup>