From 02f874db18958a5c55c060622b15cf0240af2057 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Fri, 26 Jun 2026 10:23:19 +0000
Subject: [PATCH] docs: update translations for changed English sources

---
 docs/i18n/README.ar.md    | 60 ++++++++++++++++----------------
 docs/i18n/README.de.md    | 46 ++++++++++++------------
 docs/i18n/README.es.md    | 40 ++++++++++-----------
 docs/i18n/README.fr.md    | 37 +++++++++++---------
 docs/i18n/README.he.md    | 60 ++++++++++++++++----------------
 docs/i18n/README.hi.md    | 67 ++++++++++++++++++-----------------
 docs/i18n/README.it.md    | 62 ++++++++++++++++-----------------
 docs/i18n/README.ja.md    | 40 ++++++++++-----------
 docs/i18n/README.ko.md    | 50 +++++++++++++--------------
 docs/i18n/README.pt-br.md | 32 ++++++++---------
 docs/i18n/README.ru.md    | 48 ++++++++++++-------------
 docs/i18n/README.tr.md    | 73 ++++++++++++++++++---------------------
 docs/i18n/README.vi.md    | 50 +++++++++++++--------------
 docs/i18n/README.zh.md    | 46 ++++++++++++------------
 14 files changed, 357 insertions(+), 354 deletions(-)

diff --git a/docs/i18n/README.ar.md b/docs/i18n/README.ar.md
index 2e82ae4..7a1f761 100644
--- a/docs/i18n/README.ar.md
+++ b/docs/i18n/README.ar.md
@@ -19,9 +19,9 @@
 
 **الترجمات:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**حل فشل وقت التشغيل لعوامل الترميز.**
-تندمج مع Claude Code و Codex. تقبض على الحلقات والإجراءات الخطرة ويسريب الأسرار
-قبل أن تصبح حوادث. بدون تأخير. يعمل محليًا.
+**حل أعطال وقت التشغيل لوكلاء البرمجة.**
+يتكامل مع Claude Code و Codex. يوقف الحلقات اللانهائية والإجراءات الخطيرة وتسريب الأسرار
+قبل أن تصبح حوادث. بدون تأخير. يعمل محلياً.
 
 </div>
 
@@ -31,7 +31,7 @@
 
 ---
 
-## واجهات سطر الأوامر المدعومة للعوامل
+## واجهات سطر الأوامر المدعومة للوكلاء
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -82,7 +82,7 @@
   </a>
 </p>
 
-> تثبيت الخطافات لواحد أو أي مزيج: `failproofai policies --install --cli opencode pi gemini` (أو `--cli claude codex copilot cursor opencode pi gemini`). حذف `--cli` للكشف التلقائي عن واجهات سطر الأوامر المثبتة والمطالبة.
+> تثبيت الخطافات لواحد أو أي مزيج: `failproofai policies --install --cli opencode pi gemini` (أو `--cli claude codex copilot cursor opencode pi gemini`). تجاهل `--cli` للكشف التلقائي عن واجهات سطر الأوامر المثبتة والمطالبة بها.
 
 ---
 
@@ -90,32 +90,32 @@
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # أو فقط قم بتشغيل `failproofai` وقبول سؤال التشغيل الأول
+failproofai policies --install   # أو ما عليك سوى تشغيل `failproofai` وقبول المطالبة عند أول تشغيل
 failproofai
 ```
 
-30 سياسة مدمجة تنشط فورًا. لوحة معلومات في `localhost:8020`. تعطيل سؤال التشغيل الأول باستخدام `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 سياسة مدمجة تنشط فوراً. لوحة تحكم في `localhost:8020`. عطّل مطالبة أول تشغيل باستخدام `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
 ## ما الذي يوقفه
 
-| السياسة | ما يتم حجبه |
+| السياسة | ما يمنعه |
 |---|---|
 | `block-push-master` | الدفع المباشر إلى `main` / `master` |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | الالتزامات والدمج وإعادة الأساس على `main` / `master` |
-| `block-rm-rf` | حذف الملفات العودي |
-| `sanitize-api-keys` | تسريب مفاتيح API إلى سياق العامل |
+| `block-work-on-main` | التزامات وعمليات دمج وإعادة تأسيس على `main` / `master` |
+| `block-rm-rf` | حذف الملفات بشكل متكرر |
+| `sanitize-api-keys` | تسريب مفاتيح API إلى سياق الوكيل |
 
-→ [جميع 30 سياسة مدمجة](https://docs.befailproof.ai/built-in-policies)
+→ [جميع السياسات المدمجة البالغ عددها 30](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
 ## سياساتك الخاصة
 
-أسقط ملفًا في `.failproofai/policies/` - يتم تحميله تلقائيًا، بدون حاجة إلى أعلام.
-التزم به وسيحصل الفريق بأكمله عليه في السحب التالي.
+ضع ملف في `.failproofai/policies/` — سيتم تحميله تلقائياً، لا حاجة لأي علامات.
+التزم به وستحصل الفريق بأكمله عليه في الطلب التالي.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -125,7 +125,7 @@ customPolicies.add({
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolInput?.file_path?.includes("production"))
-      return deny("عمليات الكتابة إلى مسارات الإنتاج محظورة.");
+      return deny("الكتابة إلى مسارات الإنتاج محظورة.");
     return allow();
   },
 });
@@ -136,8 +136,8 @@ customPolicies.add({
 | القرار | التأثير |
 |---|---|
 | `allow()` | السماح بالعملية |
-| `deny(message)` | حظرها - الرسالة تعود إلى العامل |
-| `instruct(message)` | دعها تمر، لكن أضف سياقًا إلى موجه العامل التالي |
+| `deny(message)` | منعها — ترجع الرسالة إلى الوكيل |
+| `instruct(message)` | السماح بها، لكن أضف سياقاً لمطالبة الوكيل التالية |
 
 → [دليل السياسات المخصصة](https://docs.befailproof.ai/custom-policies)
 
@@ -145,9 +145,9 @@ customPolicies.add({
 
 ## رؤية الجلسة
 
-كل استدعاء أداة يقوم به العامل يتم تسجيله محليًا. لوحة المعلومات توضح ما يعمل،
-وما تم حجبه، وما قالته السياسة للعامل - لذا أنت لا تخمن
-عندما يحدث خطأ ما. → [دليل لوحة المعلومات](https://docs.befailproof.ai/dashboard)
+كل استدعاء أداة يجريها وكيلك يُسجل محلياً. تعرض لوحة التحكم ما تم تشغيله،
+وما تم منعه، وما أخبرت به السياسة الوكيل — لذا لن تكون تخميناً
+عندما يحدث خطأ ما. → [دليل لوحة التحكم](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -156,33 +156,33 @@ customPolicies.add({
 | | |
 |---|---|
 | [البدء السريع](https://docs.befailproof.ai/getting-started) | التثبيت والخطوات الأولى |
-| [السياسات المدمجة](https://docs.befailproof.ai/built-in-policies) | جميع 30 سياسة مع المعاملات |
-| [السياسات المخصصة](https://docs.befailproof.ai/custom-policies) | اكتب الخاصة بك |
+| [السياسات المدمجة](https://docs.befailproof.ai/built-in-policies) | جميع السياسات الثلاثون مع المعاملات |
+| [السياسات المخصصة](https://docs.befailproof.ai/custom-policies) | اكتب سياساتك الخاصة |
 | [التكوين](https://docs.befailproof.ai/configuration) | نطاقات التكوين وقواعد الدمج |
-| [لوحة المعلومات](https://docs.befailproof.ai/dashboard) | مراقب الجلسة ونشاط السياسة |
+| [لوحة التحكم](https://docs.befailproof.ai/dashboard) | مراقب الجلسة ونشاط السياسة |
 | [العمارة](https://docs.befailproof.ai/architecture) | كيفية عمل نظام الخطافات |
 
 ---
 
 ## الترخيص
 
-MIT مع [Commons Clause](https://commonsclause.com/) - مجاني للاستخدام الداخلي والشخصي؛ إعادة بيع failproofai نفسه تجاريًا يتطلب اتفاقية منفصلة. انظر [LICENSE](./LICENSE) للنص الكامل.
+MIT مع [Commons Clause](https://commonsclause.com/) — مجاني للاستخدام الداخلي والشخصي؛ إعادة البيع التجاري لـ failproofai نفسه يتطلب اتفاقية منفصلة. انظر [LICENSE](./LICENSE) للنص الكامل.
 
 ---
 
 ## المساهمة
 
-انظر [CONTRIBUTING.md](./CONTRIBUTING.md). السياسات الجديدة والحالات الحدية والترجمات كلها مرحب بها.
+انظر [CONTRIBUTING.md](./CONTRIBUTING.md). السياسات الجديدة والحالات الحدية والترجمات جميعها مرحب بها.
 
-> **بناء قبل أن تبدأ.** قم بتشغيل `bun install && bun run build` أولاً. يقوم هذا المستودع بتشغيل
-> خطافات failproofai الخاصة به على نفسه، وتحل فهرس failproofai ضد
-> حزمة `dist/` المترجمة - بدون بناء ستصطدم بـ `Cannot find package 'failproofai'`
-> أخطاء الخطافات. أعد البناء بعد تغيير `src/`. انظر
+> **بناء قبل أن تبدأ.** شغّل `bun install && bun run build` أولاً. يقوم هذا المستودع بتشغيل
+> خطافات failproofai الخاصة به على نفسه، ويحل استيراد `failproofai` مقابل
+> حزمة `dist/` المترجمة — بدون بناء ستواجه أخطاء خطافات `Cannot find package 'failproofai'`
+>. أعد البناء بعد تغيير `src/`. انظر
 > [بناء قبل أن تعمل خطافات dev في المستودع](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
 
-تم بناؤه بواسطة [Nivedit Jain](https://github.com/NiveditJain) و [Nikita Agarwal](https://github.com/nk-ag).
+بنتج من قبل [Nivedit Jain](https://github.com/NiveditJain) و [Nikita Agarwal](https://github.com/nk-ag).
 [befailproof.ai](https://befailproof.ai)
 
 
diff --git a/docs/i18n/README.de.md b/docs/i18n/README.de.md
index 1ca4697..a36e57b 100644
--- a/docs/i18n/README.de.md
+++ b/docs/i18n/README.de.md
@@ -17,8 +17,8 @@
 
 **Übersetzungen:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**Laufzeit-Fehlerbehebung für Coding-Agents.**
-Greift in Claude Code und Codex ein. Erkennt Endlosschleifen, gefährliche Aktionen und geheime Datenlecks,
+**Laufzeit-Fehlerbehebung für Coding-Agenten.**
+Klinkt sich in Claude Code und Codex ein. Erkennt Endlosschleifen, gefährliche Aktionen und geheime Datenlecks,
 bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.
 
 </div>
@@ -29,7 +29,7 @@ bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.
 
 ---
 
-## Unterstützte Agent-CLIs
+## Unterstützte Agenten-CLIs
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -80,7 +80,7 @@ bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.
   </a>
 </p>
 
-> Hooks für eine oder mehrere Kombinationen installieren: `failproofai policies --install --cli opencode pi gemini` (oder `--cli claude codex copilot cursor opencode pi gemini`). `--cli` weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl anzuzeigen.
+> Hooks für eine oder mehrere CLIs installieren: `failproofai policies --install --cli opencode pi gemini` (oder `--cli claude codex copilot cursor opencode pi gemini`). `--cli` weglassen, um installierte CLIs automatisch zu erkennen und eine Auswahl zu erhalten.
 
 ---
 
@@ -88,23 +88,23 @@ bevor sie zu Vorfällen werden. Keine zusätzliche Latenz. Läuft lokal.
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # oder einfach `failproofai` ausführen und die Erststart-Abfrage bestätigen
+failproofai policies --install   # oder einfach `failproofai` ausführen und beim ersten Start bestätigen
 failproofai
 ```
 
-30 integrierte Richtlinien werden sofort aktiviert. Dashboard unter `localhost:8020`. Die Erststart-Abfrage lässt sich mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren.
+30 integrierte Richtlinien werden sofort aktiv. Dashboard unter `localhost:8020`. Den Erststart-Dialog mit `FAILPROOFAI_NO_FIRST_RUN=1` deaktivieren.
 
 ---
 
 ## Was blockiert wird
 
-| Richtlinie | Was sie verhindert |
+| Richtlinie | Was sie blockiert |
 |---|---|
-| `block-push-master` | Direkte Pushes nach `main` / `master` |
+| `block-push-master` | Direkte Pushes auf `main` / `master` |
 | `block-force-push` | `git push --force` |
 | `block-work-on-main` | Commits, Merges und Rebases auf `main` / `master` |
 | `block-rm-rf` | Rekursives Löschen von Dateien |
-| `sanitize-api-keys` | API-Schlüssel, die in den Agent-Kontext gelangen |
+| `sanitize-api-keys` | API-Keys, die in den Agenten-Kontext gelangen |
 
 → [Alle 30 integrierten Richtlinien](https://docs.befailproof.ai/built-in-policies)
 
@@ -112,8 +112,8 @@ failproofai
 
 ## Eigene Richtlinien
 
-Eine Datei in `.failproofai/policies/` ablegen — sie wird automatisch geladen, ohne zusätzliche Parameter.
-Ins Repository einchecken und das gesamte Team erhält sie beim nächsten Pull.
+Eine Datei in `.failproofai/policies/` ablegen – sie wird automatisch geladen, ohne weitere Optionen.
+Ins Repository committen, und das gesamte Team erhält sie beim nächsten Pull.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -129,23 +129,23 @@ customPolicies.add({
 });
 ```
 
-Drei Entscheidungen stehen jeder Richtlinie zur Verfügung:
+Drei Entscheidungstypen stehen jeder Richtlinie zur Verfügung:
 
 | Entscheidung | Wirkung |
 |---|---|
 | `allow()` | Operation zulassen |
-| `deny(message)` | Blockieren — die Nachricht wird an den Agent zurückgegeben |
-| `instruct(message)` | Durchlassen, aber dem nächsten Prompt des Agents Kontext hinzufügen |
+| `deny(message)` | Blockieren – die Nachricht wird an den Agenten zurückgegeben |
+| `instruct(message)` | Durchlassen, aber dem nächsten Agenten-Prompt zusätzlichen Kontext hinzufügen |
 
 → [Leitfaden für eigene Richtlinien](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## Sitzungstransparenz
+## Sitzungsübersicht
 
-Jeder Tool-Aufruf des Agents wird lokal protokolliert. Das Dashboard zeigt, was ausgeführt wurde,
-was blockiert wurde und was die Richtlinie dem Agent mitgeteilt hat — damit Sie bei Problemen
-nicht im Dunkeln tappen. → [Dashboard-Leitfaden](https://docs.befailproof.ai/dashboard)
+Jeder Tool-Aufruf des Agenten wird lokal protokolliert. Das Dashboard zeigt, was ausgeführt wurde,
+was blockiert wurde und was die Richtlinie dem Agenten mitgeteilt hat – damit man bei Problemen
+nicht im Dunkeln tappt. → [Dashboard-Leitfaden](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -164,18 +164,18 @@ nicht im Dunkeln tappen. → [Dashboard-Leitfaden](https://docs.befailproof.ai/d
 
 ## Lizenz
 
-MIT mit [Commons Clause](https://commonsclause.com/) — kostenlos für den internen und privaten Einsatz; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine gesonderte Vereinbarung. Den vollständigen Text finden Sie in [LICENSE](./LICENSE).
+MIT mit [Commons Clause](https://commonsclause.com/) – kostenlos für den internen und persönlichen Gebrauch; der kommerzielle Weiterverkauf von failproofai selbst erfordert eine separate Vereinbarung. Den vollständigen Text findet man in der [LICENSE](./LICENSE)-Datei.
 
 ---
 
 ## Mitwirken
 
-Siehe [CONTRIBUTING.md](./CONTRIBUTING.md). Neue Richtlinien, Grenzfälle und Übersetzungen sind herzlich willkommen.
+Siehe [CONTRIBUTING.md](./CONTRIBUTING.md). Neue Richtlinien, Grenzfälle und Übersetzungen sind stets willkommen.
 
 > **Vor dem Start bauen.** Zuerst `bun install && bun run build` ausführen. Dieses Repository verwendet
-> failproofai's eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import gegen das
-> kompilierte `dist/`-Bundle auf — ohne einen Build treten `Cannot find package 'failproofai'`
-> Hook-Fehler auf. Nach Änderungen an `src/` neu bauen. Siehe
+> failproofai's eigene Hooks auf sich selbst, und diese lösen den `failproofai`-Import anhand des
+> kompilierten `dist/`-Bundles auf – ohne Build tritt der Hook-Fehler `Cannot find package 'failproofai'` auf.
+> Nach Änderungen an `src/` neu bauen. Siehe
 > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
diff --git a/docs/i18n/README.es.md b/docs/i18n/README.es.md
index a378a7d..3bc9a3f 100644
--- a/docs/i18n/README.es.md
+++ b/docs/i18n/README.es.md
@@ -17,9 +17,9 @@
 
 **Traducciones:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**Resolución de fallos en tiempo de ejecución para agentes de codificación.**
-Se integra con Claude Code y Codex. Detecta bucles, acciones peligrosas y filtraciones de secretos
-antes de que se conviertan en incidentes. Latencia cero. Se ejecuta localmente.
+**Resolución de fallos en tiempo de ejecución para agentes de código.**
+Se integra con Claude Code y Codex. Detecta bucles, acciones peligrosas y fugas de secretos
+antes de que se conviertan en incidentes. Sin latencia. Se ejecuta localmente.
 
 </div>
 
@@ -88,21 +88,21 @@ antes de que se conviertan en incidentes. Latencia cero. Se ejecuta localmente.
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # o simplemente ejecuta `failproofai` y acepta el aviso del primer inicio
+failproofai policies --install   # o simplemente ejecuta `failproofai` y acepta el aviso en el primer uso
 failproofai
 ```
 
-30 políticas integradas se activan de inmediato. Panel de control en `localhost:8020`. Desactiva el aviso del primer inicio con `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 políticas integradas se activan de inmediato. Panel de control en `localhost:8020`. Desactiva el aviso del primer uso con `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
-## Qué detiene
+## Qué bloquea
 
 | Política | Qué bloquea |
 |---|---|
 | `block-push-master` | Envíos directos a `main` / `master` |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | Commits, merges, rebases en `main` / `master` |
+| `block-work-on-main` | Commits, merges y rebases en `main` / `master` |
 | `block-rm-rf` | Eliminación recursiva de archivos |
 | `sanitize-api-keys` | Claves de API que se filtran al contexto del agente |
 
@@ -113,7 +113,7 @@ failproofai
 ## Tus propias políticas
 
 Coloca un archivo en `.failproofai/policies/` — se carga automáticamente, sin necesidad de indicadores.
-Confírmalo y todo el equipo lo obtendrá en el próximo pull.
+Confírmalo en el repositorio y todo el equipo lo recibirá en el próximo pull.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -133,17 +133,17 @@ Tres decisiones disponibles para cada política:
 
 | Decisión | Efecto |
 |---|---|
-| `allow()` | Permite la operación |
-| `deny(message)` | La bloquea — el mensaje se devuelve al agente |
-| `instruct(message)` | La deja pasar, pero añade contexto al siguiente prompt del agente |
+| `allow()` | Permitir la operación |
+| `deny(message)` | Bloquearla — el mensaje se devuelve al agente |
+| `instruct(message)` | Dejarla pasar, pero agregar contexto al siguiente prompt del agente |
 
 → [Guía de políticas personalizadas](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## Visibilidad de la sesión
+## Visibilidad de sesión
 
-Cada llamada a herramienta que realiza tu agente se registra localmente. El panel de control muestra qué se ejecutó,
+Cada llamada a herramientas que realiza tu agente se registra localmente. El panel de control muestra qué se ejecutó,
 qué fue bloqueado y qué le indicó la política al agente — para que no tengas que adivinar
 cuando algo sale mal. → [Guía del panel de control](https://docs.befailproof.ai/dashboard)
 
@@ -153,7 +153,7 @@ cuando algo sale mal. → [Guía del panel de control](https://docs.befailproof.
 
 | | |
 |---|---|
-| [Primeros pasos](https://docs.befailproof.ai/getting-started) | Instalación y pasos iniciales |
+| [Primeros pasos](https://docs.befailproof.ai/getting-started) | Instalación y primeros pasos |
 | [Políticas integradas](https://docs.befailproof.ai/built-in-policies) | Las 30 políticas con sus parámetros |
 | [Políticas personalizadas](https://docs.befailproof.ai/custom-policies) | Escribe las tuyas propias |
 | [Configuración](https://docs.befailproof.ai/configuration) | Ámbitos de configuración y reglas de combinación |
@@ -164,18 +164,18 @@ cuando algo sale mal. → [Guía del panel de control](https://docs.befailproof.
 
 ## Licencia
 
-MIT con [Commons Clause](https://commonsclause.com/) — gratuito para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo por separado. Consulta [LICENSE](./LICENSE) para el texto completo.
+MIT con [Commons Clause](https://commonsclause.com/) — gratuito para uso interno y personal; la reventa comercial de failproofai en sí requiere un acuerdo separado. Consulta [LICENSE](./LICENSE) para el texto completo.
 
 ---
 
 ## Contribuciones
 
-Consulta [CONTRIBUTING.md](./CONTRIBUTING.md). Son bienvenidas nuevas políticas, casos límite y traducciones.
+Consulta [CONTRIBUTING.md](./CONTRIBUTING.md). Se aceptan nuevas políticas, casos límite y traducciones.
 
-> **Compila antes de empezar.** Ejecuta `bun install && bun run build` primero. Este repositorio ejecuta
-> los propios hooks de failproofai sobre sí mismo, y resuelven la importación `failproofai` contra el
-> paquete compilado `dist/` — sin una compilación obtendrás errores de hook `Cannot find package 'failproofai'`.
-> Recompila después de modificar `src/`. Consulta
+> **Compila antes de comenzar.** Ejecuta primero `bun install && bun run build`. Este repositorio ejecuta
+> los propios hooks de failproofai sobre sí mismo, y estos resuelven la importación de `failproofai` contra el
+> paquete compilado en `dist/` — sin una compilación previa obtendrás errores de hook con `Cannot find package 'failproofai'`.
+> Vuelve a compilar después de modificar `src/`. Consulta
 > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
diff --git a/docs/i18n/README.fr.md b/docs/i18n/README.fr.md
index a6f7859..2392d97 100644
--- a/docs/i18n/README.fr.md
+++ b/docs/i18n/README.fr.md
@@ -18,8 +18,8 @@
 **Traductions :** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
 **Résolution des erreurs d'exécution pour les agents de code.**
-Se connecte à Claude Code et Codex. Détecte les boucles, les actions dangereuses et les fuites de secrets
-avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local.
+S'intègre à Claude Code et Codex. Détecte les boucles, les actions dangereuses et les fuites de secrets
+avant qu'elles ne deviennent des incidents. Zéro latence. Fonctionne en local.
 
 </div>
 
@@ -29,7 +29,7 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local.
 
 ---
 
-## CLI d'agents pris en charge
+## CLIs d'agents pris en charge
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -80,7 +80,7 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local.
   </a>
 </p>
 
-> Installez les hooks pour un ou plusieurs CLI au choix : `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omettez `--cli` pour détecter automatiquement les CLI installés et afficher une invite.
+> Installez les hooks pour un ou plusieurs CLIs au choix : `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omettez `--cli` pour détecter automatiquement les CLIs installés et afficher une invite.
 
 ---
 
@@ -88,19 +88,19 @@ avant qu'ils ne deviennent des incidents. Zéro latence. Fonctionne en local.
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # or just run `failproofai` and accept the first-run prompt
+failproofai policies --install   # ou lancez simplement `failproofai` et acceptez l'invite au premier démarrage
 failproofai
 ```
 
-30 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur `localhost:8020`. Désactivez l'invite de premier démarrage avec `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 politiques intégrées s'activent immédiatement. Tableau de bord disponible sur `localhost:8020`. Désactivez l'invite au premier démarrage avec `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
-## Ce que ça bloque
+## Ce qu'il bloque
 
-| Politique | Ce qui est bloqué |
+| Politique | Ce qu'elle bloque |
 |---|---|
-| `block-push-master` | Les push directs vers `main` / `master` |
+| `block-push-master` | Les pushes directs vers `main` / `master` |
 | `block-force-push` | `git push --force` |
 | `block-work-on-main` | Les commits, merges et rebases sur `main` / `master` |
 | `block-rm-rf` | La suppression récursive de fichiers |
@@ -112,7 +112,7 @@ failproofai
 
 ## Vos propres politiques
 
-Déposez un fichier dans `.failproofai/policies/` — il se charge automatiquement, aucun flag requis.
+Déposez un fichier dans `.failproofai/policies/` — il se charge automatiquement, sans aucun flag.
 Commitez-le et toute l'équipe en bénéficiera au prochain pull.
 
 ```js
@@ -141,10 +141,10 @@ Trois décisions disponibles pour chaque politique :
 
 ---
 
-## Visibilité de session
+## Visibilité de la session
 
-Chaque appel d'outil effectué par votre agent est enregistré en local. Le tableau de bord affiche ce qui a été exécuté,
-ce qui a été bloqué et ce que la politique a indiqué à l'agent — pour ne plus jamais être dans le flou
+Chaque appel d'outil effectué par votre agent est journalisé localement. Le tableau de bord affiche ce qui s'est exécuté,
+ce qui a été bloqué, et ce que la politique a transmis à l'agent — plus besoin de deviner
 quand quelque chose tourne mal. → [Guide du tableau de bord](https://docs.befailproof.ai/dashboard)
 
 ---
@@ -164,18 +164,21 @@ quand quelque chose tourne mal. → [Guide du tableau de bord](https://docs.befa
 
 ## Licence
 
-MIT avec [Commons Clause](https://commonsclause.com/) — gratuit pour usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Voir [LICENSE](./LICENSE) pour le texte complet.
+MIT avec [Commons Clause](https://commonsclause.com/) — gratuit pour un usage interne et personnel ; la revente commerciale de failproofai lui-même nécessite un accord séparé. Voir [LICENSE](./LICENSE) pour le texte complet.
 
 ---
 
 ## Contribution
 
-Voir [CONTRIBUTING.md](./CONTRIBUTING.md). Nouvelles politiques, cas limites et traductions sont les bienvenus.
+Consultez [CONTRIBUTING.md](./CONTRIBUTING.md). Les nouvelles politiques, cas limites et traductions sont les bienvenus.
 
-> **Compilez avant de commencer.** Exécutez d'abord `bun install && bun run build`. Ce dépôt fait tourner ses propres hooks sur lui-même, et ils résolvent l'import `failproofai` depuis le bundle compilé `dist/` — sans compilation, vous obtiendrez des erreurs de hook `Cannot find package 'failproofai'`. Recompilez après avoir modifié `src/`. Voir
+> **Compilez avant de commencer.** Exécutez d'abord `bun install && bun run build`. Ce dépôt fait tourner
+> les propres hooks de failproofai sur lui-même, et ils résolvent l'import `failproofai` depuis le
+> bundle compilé `dist/` — sans compilation, vous obtiendrez des erreurs de hook `Cannot find package 'failproofai'`.
+> Recompilez après avoir modifié `src/`. Voir
 > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
 
-Créé par [Nivedit Jain](https://github.com/NiveditJain) et [Nikita Agarwal](https://github.com/nk-ag).
+Développé par [Nivedit Jain](https://github.com/NiveditJain) et [Nikita Agarwal](https://github.com/nk-ag).
 [befailproof.ai](https://befailproof.ai)
diff --git a/docs/i18n/README.he.md b/docs/i18n/README.he.md
index 4e6e199..7d1a111 100644
--- a/docs/i18n/README.he.md
+++ b/docs/i18n/README.he.md
@@ -19,19 +19,19 @@
 
 **תרגומים:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**פתרון כשלים בזמן ריצה עבור סוכני קידוד.**
-מתחברים ל-Claude Code וב-Codex. תופסים לולאות, פעולות מסוכנות, ודיפוזיות של סודות
-לפני שהם הופכים לתקריות. אפס השהיה. רץ מקומי.
+**פתרון כשלים בזמן ריצה לסוכנים קוד.**
+מתחברים ל-Claude Code ו-Codex. תופסים לולאות, פעולות מסוכנות, והדלפות סודות
+לפני שהם הופכים לתקריות. אפס עיכוב. רץ באופן מקומי.
 
 </div>
 
 <p align="center">
-  <img src="readme-arch-hq.gif" alt="Failproof AI in action" width="800" />
+  <img src="readme-arch-hq.gif" alt="Failproof AI בפעולה" width="800" />
 </p>
 
 ---
 
-## CLI סוכנים נתמכים
+## CLIs סוכנים נתמכים
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -82,7 +82,7 @@
   </a>
 </p>
 
-> התקינו hooks עבור אחד או כל שילוב: `failproofai policies --install --cli opencode pi gemini` (או `--cli claude codex copilot cursor opencode pi gemini`). השמיטו `--cli` לזיהוי אוטומטי של CLI מותקנות והנחיה.
+> התקן hook-ים עבור אחד או כל שילוב: `failproofai policies --install --cli opencode pi gemini` (או `--cli claude codex copilot cursor opencode pi gemini`). הוסר `--cli` להתקלת אוטומטית של CLIs מותקנים ושאילתה.
 
 ---
 
@@ -90,11 +90,11 @@
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # או פשוט הריצו `failproofai` וקבלו את ההנחיה בריצה ראשונה
+failproofai policies --install   # או פשוט הרץ `failproofai` וקבל את הודעת ההרצה הראשונה
 failproofai
 ```
 
-30 מדיניות מובנות מופעלות מיד. לוח מחוונים ב-`localhost:8020`. השבתו את ההנחיה בריצה ראשונה עם `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 מדיניות מובנות מופעלות מייד. לוח בקרה ב-`localhost:8020`. השבת את הודעת ההרצה הראשונה עם `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
@@ -104,18 +104,18 @@ failproofai
 |---|---|
 | `block-push-master` | דחיפות ישירות ל-`main` / `master` |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | קומיטים, מיזוגים, rebases על `main` / `master` |
+| `block-work-on-main` | commits, merges, rebases על `main` / `master` |
 | `block-rm-rf` | מחיקת קבצים רקורסיבית |
-| `sanitize-api-keys` | מפתחות API דולפים לתוך הקשר הסוכן |
+| `sanitize-api-keys` | API keys הדולפות להקשר הסוכן |
 
 → [כל 30 המדיניות המובנות](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
-## המדיניות שלך
+## המדיניויות שלך
 
-הנח קובץ ל-`.failproofai/policies/` — הוא נטען אוטומטית, ללא דגלים נדרשים.
-קומיטו אותו והצוות כולו מקבל אותו בפול הבא.
+שחרר קובץ ל-`.failproofai/policies/` — זה נטען באופן אוטומטי, ללא דגלים נדרשים.
+בצע commit שלו והצוות כולו יקבל אותו בעת ה-pull הבא.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -137,17 +137,17 @@ customPolicies.add({
 |---|---|
 | `allow()` | אפשר את הפעולה |
 | `deny(message)` | חסום אותה — ההודעה חוזרת לסוכן |
-| `instruct(message)` | תן לזה לעבור, אבל הוסף הקשר לתא הבא של הסוכן |
+| `instruct(message)` | תן לזה לעבור, אך הוסף הקשר להודעה הבאה של הסוכן |
 
 → [מדריך מדיניות מותאם אישית](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## נראות הסדרה
+## נראות הפעילות
 
-כל קריאת כלים שהסוכן שלך מבצע נרשמת מקומית. לוח המחוונים מראה מה רץ,
+כל קריאת כלי שהסוכן שלך מבצע מתועדת באופן מקומי. לוח הבקרה מציג מה רץ,
 מה נחסם, ומה המדיניות אמרה לסוכן — כך שאתה לא מנחש
-כשמשהו הולך לא טוב. → [מדריך לוח המחוונים](https://docs.befailproof.ai/dashboard)
+כשמשהו הולך לא בסדר. → [מדריך לוח הבקרה](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -155,30 +155,30 @@ customPolicies.add({
 
 | | |
 |---|---|
-| [התחלה מהירה](https://docs.befailproof.ai/getting-started) | התקנה וצעדים ראשונים |
-| [מדיניות מובנות](https://docs.befailproof.ai/built-in-policies) | כל 30 המדיניות עם פרמטרים |
-| [מדיניות מותאמות אישית](https://docs.befailproof.ai/custom-policies) | כתוב שלך |
-| [תצורה](https://docs.befailproof.ai/configuration) | היקפי תצורה וכללי מיזוג |
-| [לוח מחוונים](https://docs.befailproof.ai/dashboard) | צג סדרה ופעילות מדיניות |
-| [ארכיטקטורה](https://docs.befailproof.ai/architecture) | איך מערכת ה-hook עובדת |
+| [התחל](https://docs.befailproof.ai/getting-started) | התקנה והצעדים הראשונים |
+| [מדיניויות מובנות](https://docs.befailproof.ai/built-in-policies) | כל 30 המדיניויות עם פרמטרים |
+| [מדיניויות מותאמות](https://docs.befailproof.ai/custom-policies) | כתוב שלך |
+| [הגדרה](https://docs.befailproof.ai/configuration) | הגדרות היקף וכללי מיזוג |
+| [לוח בקרה](https://docs.befailproof.ai/dashboard) | מנטר פעילות ופעילות מדיניות |
+| [אדריכלות](https://docs.befailproof.ai/architecture) | כיצד מערכת ה-hook עובדת |
 
 ---
 
 ## רישיון
 
-MIT עם [Commons Clause](https://commonsclause.com/) — חינם לשימוש פנימי ואישי; מכירה מחדש מסחרית של failproofai עצמו דורשת הסכם נפרד. ראה [LICENSE](./LICENSE) לטקסט המלא.
+MIT עם [Commons Clause](https://commonsclause.com/) — חופשי לשימוש פנימי ואישי; מכירה מחדש מסחרית של failproofai עצמו דורשת הסכמה נפרדת. ראה [LICENSE](./LICENSE) לטקסט המלא.
 
 ---
 
 ## תרומה
 
-ראה [CONTRIBUTING.md](./CONTRIBUTING.md). מדיניות חדשות, מקרי קצה, ותרגומים כולם מוזמנים.
+ראה [CONTRIBUTING.md](./CONTRIBUTING.md). מדיניויות חדשות, cases קצה, ותרגומים כולם בברכה.
 
-> **בנו לפני שתתחילו.** הריצו `bun install && bun run build` תחילה. מאגר זה מריץ
-> hooks של failproofai על עצמו, והם פותרים את היבוא `failproofai` כנגד
-> bundle המהדר `dist/` — ללא build תפגעו ב-`Cannot find package 'failproofai'`
-> שגיאות hook. בנו מחדש לאחר שינוי `src/`. ראה
-> [בנו לפני שה-in-repo dev hooks יעבדו](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
+> **בנה לפני שתתחיל.** הרץ `bun install && bun run build` תחילה. ריפו זה מריץ
+> את hook-ים של failproofai בעצמו, והם פותרים את `failproofai` import כנגד
+> bundle `dist/` המהדורה — בלי build תקבל `Cannot find package 'failproofai'`
+> hook errors. בנה מחדש אחרי שינוי `src/`. ראה
+> [בנה לפני שה-in-repo dev hooks יעבדו](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
 
diff --git a/docs/i18n/README.hi.md b/docs/i18n/README.hi.md
index b5312b9..906d2b3 100644
--- a/docs/i18n/README.hi.md
+++ b/docs/i18n/README.hi.md
@@ -18,8 +18,8 @@
 **अनुवाद:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
 **कोडिंग एजेंटों के लिए रनटाइम विफलता समाधान।**
-Claude Code और Codex में हुक किया गया। लूप्स, खतरनाक क्रियाएं, और सीक्रेट लीक को
-समस्याओं से पहले पकड़ता है। शून्य विलंबता। स्थानीय रूप से चलता है।
+Claude Code और Codex में हुक करता है। लूप्स, खतरनाक कार्यों और सीक्रेट लीक को पकड़ता है
+इससे पहले कि वे घटनाएं बनें। शून्य विलंबता। स्थानीय रूप से चलता है।
 
 </div>
 
@@ -80,7 +80,7 @@ Claude Code और Codex में हुक किया गया। लूप
   </a>
 </p>
 
-> एक या किसी भी संयोजन के लिए हुक इंस्टॉल करें: `failproofai policies --install --cli opencode pi gemini` (या `--cli claude codex copilot cursor opencode pi gemini`)। स्वचालित रूप से इंस्टॉल किए गए CLIs का पता लगाने और संकेत देने के लिए `--cli` को छोड़ दें।
+> एक या किसी भी संयोजन के लिए हुक इंस्टॉल करें: `failproofai policies --install --cli opencode pi gemini` (या `--cli claude codex copilot cursor opencode pi gemini`)। स्वचालित रूप से इंस्टॉल किए गए CLIs को खोजने और प्रॉम्प्ट करने के लिए `--cli` को छोड़ें।
 
 ---
 
@@ -88,32 +88,32 @@ Claude Code और Codex में हुक किया गया। लूप
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # या बस `failproofai` चलाएं और पहली बार चलाने के संकेत को स्वीकार करें
+failproofai policies --install   # या बस `failproofai` चलाएं और पहली बार चलाने वाले प्रॉम्प्ट को स्वीकार करें
 failproofai
 ```
 
-30 बिल्ट-इन नीतियां तुरंत सक्रिय होती हैं। डैशबोर्ड `localhost:8020` पर। `FAILPROOFAI_NO_FIRST_RUN=1` के साथ पहली बार चलाने के संकेत को अक्षम करें।
+30 बिल्ट-इन पॉलिसीज तुरंत सक्रिय हो जाती हैं। डैशबोर्ड `localhost:8020` पर उपलब्ध है। `FAILPROOFAI_NO_FIRST_RUN=1` के साथ पहली बार चलाने वाले प्रॉम्प्ट को अक्षम करें।
 
 ---
 
 ## यह क्या रोकता है
 
-| नीति | यह क्या ब्लॉक करता है |
+| पॉलिसी | यह क्या ब्लॉक करता है |
 |---|---|
-| `block-push-master` | `main` / `master` के लिए सीधे पुश |
+| `block-push-master` | `main` / `master` को सीधे पुश करना |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | `main` / `master` पर कमिट, मर्ज, रीबेस |
-| `block-rm-rf` | पुनरावर्ती फ़ाइल हटाना |
-| `sanitize-api-keys` | एजेंट संदर्भ में API कुंजियां लीक होना |
+| `block-work-on-main` | `main` / `master` पर कमिट, मर्ज, रीबेस करना |
+| `block-rm-rf` | पुनरावर्ती फाइल हटाना |
+| `sanitize-api-keys` | API कीज़ एजेंट संदर्भ में लीक होना |
 
-→ [सभी 30 बिल्ट-इन नीतियां](https://docs.befailproof.ai/built-in-policies)
+→ [सभी 30 बिल्ट-इन पॉलिसीज](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
-## आपकी अपनी नीतियां
+## आपकी अपनी पॉलिसीज
 
-`.failproofai/policies/` में एक फ़ाइल छोड़ें — यह स्वचालित रूप से लोड होती है, कोई फ्लैग की आवश्यकता नहीं है।
-इसे कमिट करें और पूरी टीम को अगले पुल पर मिल जाएगा।
+`.failproofai/policies/` में एक फाइल ड्रॉप करें — यह स्वचालित रूप से लोड हो जाती है, किसी फ्लैग की आवश्यकता नहीं।
+इसे कमिट करें और पूरी टीम को अगली पुल पर यह मिल जाएगी।
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -129,51 +129,56 @@ customPolicies.add({
 });
 ```
 
-हर नीति के लिए तीन निर्णय उपलब्ध हैं:
+प्रत्येक पॉलिसी के लिए तीन निर्णय उपलब्ध हैं:
 
 | निर्णय | प्रभाव |
 |---|---|
-| `allow()` | संचालन की अनुमति दें |
+| `allow()` | ऑपरेशन की अनुमति दें |
 | `deny(message)` | इसे ब्लॉक करें — संदेश एजेंट को वापस जाता है |
-| `instruct(message)` | इसे जारी रखें, लेकिन एजेंट के अगले संकेत में संदर्भ जोड़ें |
+| `instruct(message)` | इसे आगे बढ़ने दें, लेकिन एजेंट के अगले प्रॉम्प्ट में संदर्भ जोड़ें |
 
-→ [कस्टम नीतियां गाइड](https://docs.befailproof.ai/custom-policies)
+→ [कस्टम पॉलिसीज गाइड](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## सत्र दृश्यता
+## सेशन दृश्यमानता
 
-आपके एजेंट द्वारा किया गया प्रत्येक टूल कॉल स्थानीय रूप से लॉग किया जाता है। डैशबोर्ड दिखाता है कि क्या चला,
-क्या ब्लॉक किया गया, और नीति ने एजेंट को क्या बताया — इसलिए जब कुछ गलत हो जाए तो आप अनुमान नहीं लगाते हैं। → [डैशबोर्ड गाइड](https://docs.befailproof.ai/dashboard)
+आपका एजेंट जो भी टूल कॉल करता है वह स्थानीय रूप से लॉग किया जाता है। डैशबोर्ड दिखाता है कि क्या चला,
+क्या ब्लॉक किया गया, और पॉलिसी ने एजेंट को क्या बताया — इसलिए आप अनुमान नहीं लगा रहे हैं
+जब कुछ गलत हो जाता है। → [डैशबोर्ड गाइड](https://docs.befailproof.ai/dashboard)
 
 ---
 
-## दस्तावेज़
+## डॉक्यूमेंटेशन
 
 | | |
 |---|---|
-| [शुरुआत करना](https://docs.befailproof.ai/getting-started) | इंस्टॉलेशन और पहले कदम |
-| [बिल्ट-इन नीतियां](https://docs.befailproof.ai/built-in-policies) | सभी 30 नीतियां पैरामीटर के साथ |
-| [कस्टम नीतियां](https://docs.befailproof.ai/custom-policies) | अपनी स्वयं की लिखें |
-| [कॉन्फ़िगरेशन](https://docs.befailproof.ai/configuration) | कॉन्फ़िगरेशन स्कोप और विलय नियम |
-| [डैशबोर्ड](https://docs.befailproof.ai/dashboard) | सत्र मॉनिटर और नीति गतिविधि |
+| [शुरुआत करें](https://docs.befailproof.ai/getting-started) | इंस्टॉलेशन और पहले कदम |
+| [बिल्ट-इन पॉलिसीज](https://docs.befailproof.ai/built-in-policies) | सभी 30 पॉलिसीज पैरामीटर के साथ |
+| [कस्टम पॉलिसीज](https://docs.befailproof.ai/custom-policies) | अपनी खुद की लिखें |
+| [कॉन्फ़िगरेशन](https://docs.befailproof.ai/configuration) | कॉन्फ़िग स्कोप और मर्ज नियम |
+| [डैशबोर्ड](https://docs.befailproof.ai/dashboard) | सेशन मॉनिटर और पॉलिसी गतिविधि |
 | [आर्किटेक्चर](https://docs.befailproof.ai/architecture) | हुक सिस्टम कैसे काम करता है |
 
 ---
 
 ## लाइसेंस
 
-MIT with [Commons Clause](https://commonsclause.com/) — आंतरिक और व्यक्तिगत उपयोग के लिए मुक्त; failproofai के वाणिज्यिक पुनर्विक्रय के लिए एक अलग समझौते की आवश्यकता है। पूरे पाठ के लिए [LICENSE](./LICENSE) देखें।
+[Commons Clause](https://commonsclause.com/) के साथ MIT — आंतरिक और व्यक्तिगत उपयोग के लिए मुफ्त; failproofai का व्यावसायिक पुनर्विक्रय एक अलग समझौते की आवश्यकता है। पूर्ण पाठ के लिए [LICENSE](./LICENSE) देखें।
 
 ---
 
 ## योगदान
 
-[CONTRIBUTING.md](./CONTRIBUTING.md) देखें। नई नीतियां, किनारे के मामले, और अनुवाद सभी का स्वागत है।
+[CONTRIBUTING.md](./CONTRIBUTING.md) देखें। नई पॉलिसीज, एज केस, और अनुवाद सभी स्वागत हैं।
 
-> **शुरू करने से पहले बिल्ड करें।** पहले `bun install && bun run build` चलाएं। यह रिपो failproofai की स्वयं की नीतियों को स्वयं पर चलाता है, और वे `failproofai` आयात को संकलित `dist/` बंडल के विरुद्ध हल करते हैं — एक बिल्ड के बिना आप `Cannot find package 'failproofai'` हुक त्रुटियों से टकराएंगे। `src/` बदलने के बाद पुनर्निर्माण करें। [बिल्ड करें इससे पहले कि रिपो में dev हुक काम करें](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) देखें।
+> **बिल्ड शुरू करने से पहले।** पहले `bun install && bun run build` चलाएं। यह रेपो
+> failproofai के अपने हुक को स्वयं पर चलाता है, और वे `failproofai` इंपोर्ट को संकलित
+> `dist/` बंडल के विरुद्ध हल करते हैं — बिल्ड के बिना आपको `Cannot find package 'failproofai'`
+> हुक त्रुटियां मिलेंगी। `src/` बदलने के बाद पुनः बिल्ड करें। देखें
+> [इन-रेपो डेव हुक काम करने से पहले बिल्ड करें](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)।
 
 ---
 
-[Nivedit Jain](https://github.com/NiveditJain) और [Nikita Agarwal](https://github.com/nk-ag) द्वारा बनाया गया।
+[Nivedit Jain](https://github.com/NiveditJain) और [Nikita Agarwal](https://github.com/nk-ag) द्वारा निर्मित।
 [befailproof.ai](https://befailproof.ai)
diff --git a/docs/i18n/README.it.md b/docs/i18n/README.it.md
index dac6804..2beb45e 100644
--- a/docs/i18n/README.it.md
+++ b/docs/i18n/README.it.md
@@ -17,9 +17,9 @@
 
 **Traduzioni:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**Risoluzione dei guasti in tempo reale per agenti di codifica.**
-Si integra con Claude Code e Codex. Cattura loop, azioni pericolose e perdite di segreti
-prima che diventino incidenti. Zero latenza. Esecuzione locale.
+**Risoluzione dei guasti runtime per gli agenti di codifica.**
+Si integra con Claude Code e Codex. Cattura i loop, le azioni pericolose e le fughe di segreti
+prima che diventino incidenti. Latenza zero. Eseguito localmente.
 
 </div>
 
@@ -29,7 +29,7 @@ prima che diventino incidenti. Zero latenza. Esecuzione locale.
 
 ---
 
-## CLI di agenti supportati
+## CLI agente supportati
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -80,7 +80,7 @@ prima che diventino incidenti. Zero latenza. Esecuzione locale.
   </a>
 </p>
 
-> Installa gli hook per uno o una qualsiasi combinazione: `failproofai policies --install --cli opencode pi gemini` (oppure `--cli claude codex copilot cursor opencode pi gemini`). Ometti `--cli` per rilevare automaticamente i CLI installati e ricevere un prompt.
+> Installa i hook per uno o qualsiasi combinazione: `failproofai policies --install --cli opencode pi gemini` (oppure `--cli claude codex copilot cursor opencode pi gemini`). Ometti `--cli` per rilevare automaticamente i CLI installati e ricevere un prompt.
 
 ---
 
@@ -88,11 +88,11 @@ prima che diventino incidenti. Zero latenza. Esecuzione locale.
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # oppure esegui semplicemente `failproofai` e accetta il prompt al primo avvio
+failproofai policies --install   # o semplicemente esegui `failproofai` e accetta il primo prompt
 failproofai
 ```
 
-30 policy predefinite si attivano immediatamente. Dashboard disponibile su `localhost:8020`. Disabilita il prompt al primo avvio con `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 policy built-in si attivano immediatamente. Dashboard su `localhost:8020`. Disabilita il primo prompt con `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
@@ -104,16 +104,16 @@ failproofai
 | `block-force-push` | `git push --force` |
 | `block-work-on-main` | Commit, merge, rebase su `main` / `master` |
 | `block-rm-rf` | Eliminazione ricorsiva di file |
-| `sanitize-api-keys` | API key che si perdono nel contesto dell'agente |
+| `sanitize-api-keys` | Chiavi API che fuggono nel contesto dell'agente |
 
-→ [Tutte le 30 policy predefinite](https://docs.befailproof.ai/built-in-policies)
+→ [Tutte le 30 policy built-in](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
-## Le tue policy personalizzate
+## Le tue policy
 
-Rilascia un file in `.failproofai/policies/` — viene caricato automaticamente, senza flag necessari.
-Eseguine il commit e l'intero team la riceverà al prossimo pull.
+Rilascia un file in `.failproofai/policies/` — si carica automaticamente, nessun flag necessario.
+Esegui il commit e l'intero team lo riceve al prossimo pull.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -123,7 +123,7 @@ customPolicies.add({
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolInput?.file_path?.includes("production"))
-      return deny("Le scritture su percorsi di produzione sono bloccate.");
+      return deny("Writes to production paths are blocked.");
     return allow();
   },
 });
@@ -134,8 +134,8 @@ Tre decisioni disponibili per ogni policy:
 | Decisione | Effetto |
 |---|---|
 | `allow()` | Consenti l'operazione |
-| `deny(message)` | Bloccala — il messaggio torna all'agente |
-| `instruct(message)` | Lasciala passare, ma aggiungi contesto al prossimo prompt dell'agente |
+| `deny(message)` | Bloccalo — il messaggio torna all'agente |
+| `instruct(message)` | Lascialo passare, ma aggiungi contesto al prossimo prompt dell'agente |
 
 → [Guida alle policy personalizzate](https://docs.befailproof.ai/custom-policies)
 
@@ -143,9 +143,9 @@ Tre decisioni disponibili per ogni policy:
 
 ## Visibilità della sessione
 
-Ogni chiamata di tool che il tuo agente fa viene registrata localmente. Il dashboard mostra cosa è stato eseguito,
-cosa è stato bloccato e cosa la policy ha comunicato all'agente — così non devi indovinare
-quando qualcosa va storto. → [Guida al dashboard](https://docs.befailproof.ai/dashboard)
+Ogni chiamata di strumento che il tuo agente effettua viene registrata localmente. Il dashboard mostra cosa è stato eseguito,
+cosa è stato bloccato e cosa la policy ha detto all'agente — così non stai indovinando
+quando qualcosa va male. → [Guida al dashboard](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -153,32 +153,32 @@ quando qualcosa va storto. → [Guida al dashboard](https://docs.befailproof.ai/
 
 | | |
 |---|---|
-| [Iniziare](https://docs.befailproof.ai/getting-started) | Installazione e primi passi |
-| [Policy predefinite](https://docs.befailproof.ai/built-in-policies) | Tutte le 30 policy con parametri |
-| [Policy personalizzate](https://docs.befailproof.ai/custom-policies) | Scrivi le tue |
-| [Configurazione](https://docs.befailproof.ai/configuration) | Ambiti di configurazione e regole di merge |
-| [Dashboard](https://docs.befailproof.ai/dashboard) | Monitor di sessione e attività delle policy |
-| [Architettura](https://docs.befailproof.ai/architecture) | Come funziona il sistema di hook |
+| [Getting Started](https://docs.befailproof.ai/getting-started) | Installazione e primi passi |
+| [Built-in Policies](https://docs.befailproof.ai/built-in-policies) | Tutte le 30 policy con parametri |
+| [Custom Policies](https://docs.befailproof.ai/custom-policies) | Scrivi le tue |
+| [Configuration](https://docs.befailproof.ai/configuration) | Ambiti di configurazione e regole di merge |
+| [Dashboard](https://docs.befailproof.ai/dashboard) | Monitor di sessione e attività policy |
+| [Architecture](https://docs.befailproof.ai/architecture) | Come funziona il sistema di hook |
 
 ---
 
 ## Licenza
 
-MIT con [Commons Clause](https://commonsclause.com/) — gratuito per uso interno e personale; la rivendita commerciale di failproofai stesso richiede un accordo separato. Consulta [LICENSE](./LICENSE) per il testo completo.
+MIT con [Commons Clause](https://commonsclause.com/) — gratuito per uso interno e personale; la rivendita commerciale di failproofai stesso richiede un accordo separato. Vedi [LICENSE](./LICENSE) per il testo completo.
 
 ---
 
 ## Contribuire
 
-Consulta [CONTRIBUTING.md](./CONTRIBUTING.md). Nuove policy, casi limite e traduzioni sono tutti benvenuti.
+Vedi [CONTRIBUTING.md](./CONTRIBUTING.md). Nuove policy, casi limite e traduzioni sono tutti benvenuti.
 
 > **Compila prima di iniziare.** Esegui `bun install && bun run build` per primo. Questo repository esegue
-> gli hook di failproofai su se stesso e risolvono l'import di `failproofai` rispetto al
-> bundle compilato `dist/` — senza una compilazione riceverai errori di hook `Cannot find package 'failproofai'`.
-> Ricompila dopo aver modificato `src/`. Consulta
-> [Compilare prima che gli hook di sviluppo in-repo funzionino](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
+> i propri hook di failproofai su se stesso, e risolvono l'import `failproofai` rispetto al
+> bundle compilato `dist/` — senza una build otterrai errori di hook `Cannot find package 'failproofai'`.
+> Ricompila dopo aver modificato `src/`. Vedi
+> [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
 
-Costruito da [Nivedit Jain](https://github.com/NiveditJain) e [Nikita Agarwal](https://github.com/nk-ag).
+Creato da [Nivedit Jain](https://github.com/NiveditJain) e [Nikita Agarwal](https://github.com/nk-ag).
 [befailproof.ai](https://befailproof.ai)
diff --git a/docs/i18n/README.ja.md b/docs/i18n/README.ja.md
index 948b472..a76c786 100644
--- a/docs/i18n/README.ja.md
+++ b/docs/i18n/README.ja.md
@@ -17,9 +17,9 @@
 
 **翻訳:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**コーディングエージェントの実行時障害を解決する。**
-Claude Code および Codex にフックして、ループ・危険な操作・シークレットの漏洩を
-インシデントになる前に検出します。レイテンシーゼロ。ローカル実行。
+**コーディングエージェントのランタイム障害を解決します。**
+Claude Code および Codex にフックし、ループ・危険な操作・シークレットの漏洩を
+インシデントになる前にキャッチします。レイテンシーゼロ。ローカル実行。
 
 </div>
 
@@ -80,7 +80,7 @@ Claude Code および Codex にフックして、ループ・危険な操作・
   </a>
 </p>
 
-> 1つまたは任意の組み合わせでフックをインストールできます: `failproofai policies --install --cli opencode pi gemini`（または `--cli claude codex copilot cursor opencode pi gemini`）。`--cli` を省略すると、インストール済み CLI を自動検出してプロンプトを表示します。
+> 1つまたは複数の組み合わせでフックをインストールできます: `failproofai policies --install --cli opencode pi gemini`（または `--cli claude codex copilot cursor opencode pi gemini`）。`--cli` を省略すると、インストール済みの CLI を自動検出してプロンプトを表示します。
 
 ---
 
@@ -92,28 +92,28 @@ failproofai policies --install   # または `failproofai` を実行して初回
 failproofai
 ```
 
-30 個の組み込みポリシーが即座に有効になります。ダッシュボードは `localhost:8020` で確認できます。初回起動プロンプトを無効にするには `FAILPROOFAI_NO_FIRST_RUN=1` を設定してください。
+30個の組み込みポリシーが即座に有効化されます。ダッシュボードは `localhost:8020` で確認できます。初回起動プロンプトを無効にするには `FAILPROOFAI_NO_FIRST_RUN=1` を設定してください。
 
 ---
 
-## 防止できる操作
+## 防止できること
 
 | ポリシー | ブロック対象 |
 |---|---|
 | `block-push-master` | `main` / `master` への直接プッシュ |
 | `block-force-push` | `git push --force` |
 | `block-work-on-main` | `main` / `master` へのコミット・マージ・リベース |
-| `block-rm-rf` | 再帰的なファイル削除 |
-| `sanitize-api-keys` | エージェントのコンテキストへの API キーの漏洩 |
+| `block-rm-rf` | ファイルの再帰的削除 |
+| `sanitize-api-keys` | エージェントコンテキストへの API キー漏洩 |
 
-→ [全 30 件の組み込みポリシー](https://docs.befailproof.ai/built-in-policies)
+→ [組み込みポリシー全30件](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
 ## 独自ポリシーの作成
 
-`.failproofai/policies/` にファイルを置くだけで自動的に読み込まれます。フラグは不要です。
-コミットすれば、次回のプル時にチーム全員に反映されます。
+`.failproofai/policies/` にファイルを配置するだけで自動読み込みされます。フラグは不要です。
+コミットしておけば、次回プル時にチーム全員に適用されます。
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -129,21 +129,21 @@ customPolicies.add({
 });
 ```
 
-すべてのポリシーで使用できる 3 種類の判定:
+各ポリシーで使用できる判定は3種類です:
 
 | 判定 | 効果 |
 |---|---|
 | `allow()` | 操作を許可する |
-| `deny(message)` | 操作をブロックし、メッセージをエージェントに返す |
-| `instruct(message)` | 操作を通過させ、エージェントの次のプロンプトにコンテキストを追加する |
+| `deny(message)` | ブロックする — メッセージがエージェントに返される |
+| `instruct(message)` | 通過させつつ、エージェントの次のプロンプトにコンテキストを追加する |
 
 → [カスタムポリシーガイド](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## セッションの可視化
+## セッションの可視性
 
-エージェントが行ったすべてのツール呼び出しはローカルに記録されます。ダッシュボードには実行内容・ブロックされた操作・ポリシーがエージェントに伝えた内容が表示されるため、問題発生時に推測で対処する必要がありません。→ [ダッシュボードガイド](https://docs.befailproof.ai/dashboard)
+エージェントが行ったすべてのツール呼び出しはローカルに記録されます。ダッシュボードでは、実行された内容・ブロックされた内容・ポリシーがエージェントに伝えた内容を確認できるため、問題発生時に推測に頼る必要がありません。→ [ダッシュボードガイド](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -152,7 +152,7 @@ customPolicies.add({
 | | |
 |---|---|
 | [はじめに](https://docs.befailproof.ai/getting-started) | インストールと最初のステップ |
-| [組み込みポリシー](https://docs.befailproof.ai/built-in-policies) | パラメーター付き全 30 ポリシー |
+| [組み込みポリシー](https://docs.befailproof.ai/built-in-policies) | パラメータ付き全30ポリシー |
 | [カスタムポリシー](https://docs.befailproof.ai/custom-policies) | 独自ポリシーの作成方法 |
 | [設定](https://docs.befailproof.ai/configuration) | 設定スコープとマージルール |
 | [ダッシュボード](https://docs.befailproof.ai/dashboard) | セッションモニターとポリシーアクティビティ |
@@ -162,15 +162,15 @@ customPolicies.add({
 
 ## ライセンス
 
-MIT with [Commons Clause](https://commonsclause.com/) — 社内利用および個人利用は無料。failproofai 自体の商用再販には別途契約が必要です。全文は [LICENSE](./LICENSE) をご覧ください。
+MIT with [Commons Clause](https://commonsclause.com/) — 社内利用および個人利用は無料。failproofai 自体の商業的再販には別途契約が必要です。全文は [LICENSE](./LICENSE) をご覧ください。
 
 ---
 
 ## コントリビューション
 
-[CONTRIBUTING.md](./CONTRIBUTING.md) をご参照ください。新しいポリシー、エッジケース、翻訳など、どなたでも歓迎します。
+[CONTRIBUTING.md](./CONTRIBUTING.md) をご覧ください。新しいポリシー・エッジケース・翻訳はいずれも歓迎します。
 
-> **開発を始める前にビルドしてください。** 最初に `bun install && bun run build` を実行してください。このリポジトリは failproofai 自身のフックを自身に対して実行しており、`failproofai` のインポートはコンパイル済みの `dist/` バンドルに対して解決されます。ビルドなしで実行すると `Cannot find package 'failproofai'` というフックエラーが発生します。`src/` を変更した後は再ビルドしてください。詳細は [リポジトリ内の開発フックを動作させるためのビルド手順](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) をご覧ください。
+> **作業前にビルドしてください。** 最初に `bun install && bun run build` を実行してください。このリポジトリは failproofai 自身のフックを自分自身に対して実行しており、`failproofai` のインポートをコンパイル済みの `dist/` バンドルに対して解決します。ビルドを行わないと、`Cannot find package 'failproofai'` というフックエラーが発生します。`src/` を変更した後は再ビルドしてください。詳細は [リポジトリ内開発フックを動作させる前にビルドする](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work) をご覧ください。
 
 ---
 
diff --git a/docs/i18n/README.ko.md b/docs/i18n/README.ko.md
index 80c9498..ae03f5d 100644
--- a/docs/i18n/README.ko.md
+++ b/docs/i18n/README.ko.md
@@ -17,9 +17,9 @@
 
 **번역:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**코딩 에이전트를 위한 런타임 장애 해결 도구.**
-Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿 유출을
-인시던트가 되기 전에 차단합니다. 지연 시간 없음. 로컬에서 실행.
+**코딩 에이전트를 위한 런타임 오류 해결 도구.**
+Claude Code 및 Codex에 연결되어, 루프·위험한 작업·시크릿 유출을
+인시던트가 되기 전에 차단합니다. 지연 없음. 로컬 실행.
 
 </div>
 
@@ -80,7 +80,7 @@ Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿 
   </a>
 </p>
 
-> 하나 또는 원하는 조합으로 훅을 설치하세요: `failproofai policies --install --cli opencode pi gemini` (또는 `--cli claude codex copilot cursor opencode pi gemini`). `--cli`를 생략하면 설치된 CLI를 자동으로 감지하고 선택을 묻습니다.
+> 하나 또는 여러 CLI에 훅을 설치하려면: `failproofai policies --install --cli opencode pi gemini` (또는 `--cli claude codex copilot cursor opencode pi gemini`). `--cli`를 생략하면 설치된 CLI를 자동 감지하고 선택을 안내합니다.
 
 ---
 
@@ -88,32 +88,32 @@ Claude Code 및 Codex에 연동됩니다. 루프, 위험한 동작, 시크릿 
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # 또는 그냥 `failproofai`를 실행하고 최초 실행 프롬프트에서 수락
+failproofai policies --install   # 또는 `failproofai`를 실행하고 첫 실행 프롬프트에서 수락
 failproofai
 ```
 
-30개의 내장 정책이 즉시 활성화됩니다. 대시보드는 `localhost:8020`에서 확인할 수 있습니다. 최초 실행 프롬프트를 비활성화하려면 `FAILPROOFAI_NO_FIRST_RUN=1`을 설정하세요.
+30개의 기본 제공 정책이 즉시 활성화됩니다. 대시보드는 `localhost:8020`에서 확인할 수 있습니다. `FAILPROOFAI_NO_FIRST_RUN=1`로 첫 실행 프롬프트를 비활성화할 수 있습니다.
 
 ---
 
-## 차단하는 항목
+## 차단 항목
 
 | 정책 | 차단 내용 |
 |---|---|
-| `block-push-master` | `main` / `master`로의 직접 푸시 |
+| `block-push-master` | `main` / `master`에 대한 직접 푸시 |
 | `block-force-push` | `git push --force` |
 | `block-work-on-main` | `main` / `master`에서의 커밋, 머지, 리베이스 |
 | `block-rm-rf` | 재귀적 파일 삭제 |
 | `sanitize-api-keys` | 에이전트 컨텍스트로 유출되는 API 키 |
 
-→ [내장 정책 30개 전체 보기](https://docs.befailproof.ai/built-in-policies)
+→ [30개 기본 제공 정책 전체 목록](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
-## 나만의 정책
+## 나만의 정책 만들기
 
-`.failproofai/policies/` 폴더에 파일을 추가하면 별도 설정 없이 자동으로 로드됩니다.
-커밋하면 팀 전체가 다음 pull 시 적용받습니다.
+`.failproofai/policies/` 디렉터리에 파일을 추가하면 별도 설정 없이 자동으로 로드됩니다.
+커밋하면 팀 전체가 다음 풀 시 동일한 정책을 적용받습니다.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -131,11 +131,11 @@ customPolicies.add({
 
 모든 정책에서 사용할 수 있는 세 가지 결정:
 
-| 결정 | 동작 |
+| 결정 | 효과 |
 |---|---|
 | `allow()` | 작업 허용 |
 | `deny(message)` | 차단 — 메시지가 에이전트에게 반환됨 |
-| `instruct(message)` | 통과 허용, 단 에이전트의 다음 프롬프트에 컨텍스트 추가 |
+| `instruct(message)` | 통과시키되, 에이전트의 다음 프롬프트에 컨텍스트 추가 |
 
 → [커스텀 정책 가이드](https://docs.befailproof.ai/custom-policies)
 
@@ -143,9 +143,9 @@ customPolicies.add({
 
 ## 세션 가시성
 
-에이전트가 실행하는 모든 도구 호출이 로컬에 기록됩니다. 대시보드에서 실행된 내용,
+에이전트가 수행하는 모든 도구 호출은 로컬에 기록됩니다. 대시보드에서 실행된 내용,
 차단된 내용, 정책이 에이전트에게 전달한 내용을 확인할 수 있어 — 문제가 발생했을 때
-추측에 의존할 필요가 없습니다. → [대시보드 가이드](https://docs.befailproof.ai/dashboard)
+추측에 의존하지 않아도 됩니다. → [대시보드 가이드](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -153,8 +153,8 @@ customPolicies.add({
 
 | | |
 |---|---|
-| [시작하기](https://docs.befailproof.ai/getting-started) | 설치 및 첫 번째 단계 |
-| [내장 정책](https://docs.befailproof.ai/built-in-policies) | 파라미터를 포함한 30개 정책 전체 |
+| [시작하기](https://docs.befailproof.ai/getting-started) | 설치 및 첫 단계 |
+| [기본 제공 정책](https://docs.befailproof.ai/built-in-policies) | 파라미터 포함 30개 정책 전체 |
 | [커스텀 정책](https://docs.befailproof.ai/custom-policies) | 직접 작성하기 |
 | [설정](https://docs.befailproof.ai/configuration) | 설정 범위 및 병합 규칙 |
 | [대시보드](https://docs.befailproof.ai/dashboard) | 세션 모니터 및 정책 활동 |
@@ -164,19 +164,19 @@ customPolicies.add({
 
 ## 라이선스
 
-[Commons Clause](https://commonsclause.com/)가 포함된 MIT 라이선스 — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전문은 [LICENSE](./LICENSE)를 참고하세요.
+[Commons Clause](https://commonsclause.com/)가 포함된 MIT — 내부 및 개인 사용은 무료이며, failproofai 자체의 상업적 재판매는 별도 계약이 필요합니다. 전체 내용은 [LICENSE](./LICENSE)를 참조하세요.
 
 ---
 
 ## 기여하기
 
-[CONTRIBUTING.md](./CONTRIBUTING.md)를 참고하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다.
+[CONTRIBUTING.md](./CONTRIBUTING.md)를 참조하세요. 새로운 정책, 엣지 케이스, 번역 모두 환영합니다.
 
-> **시작하기 전에 빌드하세요.** 먼저 `bun install && bun run build`를 실행하세요. 이 저장소는
-> failproofai 자체 훅을 스스로에게 적용하며, `failproofai` 임포트를 컴파일된 `dist/` 번들로
-> 해석합니다 — 빌드 없이는 `Cannot find package 'failproofai'` 훅 오류가 발생합니다.
-> `src/`를 수정한 후에는 다시 빌드하세요. 자세한 내용은
-> [저장소 내 개발 훅이 동작하려면 빌드가 먼저입니다](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)를 참고하세요.
+> **시작 전에 빌드를 먼저 실행하세요.** `bun install && bun run build`를 먼저 실행하십시오. 이 저장소는
+> failproofai 자체 훅을 스스로에게 적용하며, `failproofai` 임포트를
+> 컴파일된 `dist/` 번들로 해석합니다 — 빌드 없이 시작하면 `Cannot find package 'failproofai'`
+> 훅 오류가 발생합니다. `src/`를 변경한 후에는 다시 빌드하세요.
+> [저장소 내 개발 훅 동작을 위한 빌드 방법](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)을 참조하세요.
 
 ---
 
diff --git a/docs/i18n/README.pt-br.md b/docs/i18n/README.pt-br.md
index 6a6b6bf..ff99f4d 100644
--- a/docs/i18n/README.pt-br.md
+++ b/docs/i18n/README.pt-br.md
@@ -17,9 +17,9 @@
 
 **Traduções:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**Resolução de falhas em tempo de execução para agentes de código.**
+**Resolução de falhas em tempo de execução para agentes de codificação.**
 Integra-se ao Claude Code e ao Codex. Detecta loops, ações perigosas e vazamentos de segredos
-antes que se tornem incidentes. Latência zero. Roda localmente.
+antes que virem incidentes. Latência zero. Executa localmente.
 
 </div>
 
@@ -80,7 +80,7 @@ antes que se tornem incidentes. Latência zero. Roda localmente.
   </a>
 </p>
 
-> Instale hooks para um ou qualquer combinação: `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omita `--cli` para detectar automaticamente as CLIs instaladas e ser guiado por um prompt.
+> Instale hooks para um ou qualquer combinação: `failproofai policies --install --cli opencode pi gemini` (ou `--cli claude codex copilot cursor opencode pi gemini`). Omita `--cli` para detectar automaticamente os CLIs instalados e exibir um prompt.
 
 ---
 
@@ -88,15 +88,15 @@ antes que se tornem incidentes. Latência zero. Roda localmente.
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # ou simplesmente execute `failproofai` e aceite o prompt da primeira execução
+failproofai policies --install   # ou simplesmente execute `failproofai` e aceite o prompt na primeira execução
 failproofai
 ```
 
-30 políticas integradas são ativadas imediatamente. Dashboard em `localhost:8020`. Desative o prompt da primeira execução com `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 políticas integradas são ativadas imediatamente. Dashboard disponível em `localhost:8020`. Desative o prompt de primeira execução com `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
-## O que é bloqueado
+## O que ele bloqueia
 
 | Política | O que bloqueia |
 |---|---|
@@ -104,7 +104,7 @@ failproofai
 | `block-force-push` | `git push --force` |
 | `block-work-on-main` | Commits, merges e rebases em `main` / `master` |
 | `block-rm-rf` | Exclusão recursiva de arquivos |
-| `sanitize-api-keys` | Vazamento de chaves de API para o contexto do agente |
+| `sanitize-api-keys` | Vazamento de chaves de API no contexto do agente |
 
 → [Todas as 30 políticas integradas](https://docs.befailproof.ai/built-in-policies)
 
@@ -113,7 +113,7 @@ failproofai
 ## Suas próprias políticas
 
 Coloque um arquivo em `.failproofai/policies/` — ele é carregado automaticamente, sem necessidade de flags.
-Faça o commit e toda a equipe receberá a política no próximo pull.
+Faça commit e toda a equipe receberá na próxima atualização.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -143,9 +143,9 @@ Três decisões disponíveis para cada política:
 
 ## Visibilidade da sessão
 
-Cada chamada de ferramenta feita pelo seu agente é registrada localmente. O dashboard mostra o que foi executado,
-o que foi bloqueado e o que a política comunicou ao agente — para que você não fique no escuro
-quando algo der errado. → [Guia do Dashboard](https://docs.befailproof.ai/dashboard)
+Cada chamada de ferramenta que seu agente realiza é registrada localmente. O dashboard mostra o que foi executado,
+o que foi bloqueado e o que a política informou ao agente — para que você não fique no escuro
+quando algo der errado. → [Guia do dashboard](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -155,7 +155,7 @@ quando algo der errado. → [Guia do Dashboard](https://docs.befailproof.ai/dash
 |---|---|
 | [Primeiros Passos](https://docs.befailproof.ai/getting-started) | Instalação e primeiros passos |
 | [Políticas Integradas](https://docs.befailproof.ai/built-in-policies) | Todas as 30 políticas com parâmetros |
-| [Políticas Personalizadas](https://docs.befailproof.ai/custom-policies) | Escreva as suas próprias |
+| [Políticas Personalizadas](https://docs.befailproof.ai/custom-policies) | Crie as suas próprias |
 | [Configuração](https://docs.befailproof.ai/configuration) | Escopos de configuração e regras de mesclagem |
 | [Dashboard](https://docs.befailproof.ai/dashboard) | Monitor de sessão e atividade de políticas |
 | [Arquitetura](https://docs.befailproof.ai/architecture) | Como o sistema de hooks funciona |
@@ -164,7 +164,7 @@ quando algo der errado. → [Guia do Dashboard](https://docs.befailproof.ai/dash
 
 ## Licença
 
-MIT com [Commons Clause](https://commonsclause.com/) — gratuito para uso interno e pessoal; a revenda comercial do próprio failproofai requer um acordo separado. Veja [LICENSE](./LICENSE) para o texto completo.
+MIT com [Commons Clause](https://commonsclause.com/) — gratuito para uso interno e pessoal; a revenda comercial do próprio failproofai requer um acordo separado. Consulte [LICENSE](./LICENSE) para o texto completo.
 
 ---
 
@@ -172,10 +172,10 @@ MIT com [Commons Clause](https://commonsclause.com/) — gratuito para uso inter
 
 Consulte [CONTRIBUTING.md](./CONTRIBUTING.md). Novas políticas, casos extremos e traduções são bem-vindos.
 
-> **Faça o build antes de começar.** Execute `bun install && bun run build` primeiro. Este repositório roda
+> **Faça o build antes de começar.** Execute `bun install && bun run build` primeiro. Este repositório executa
 > os próprios hooks do failproofai sobre si mesmo, e eles resolvem o import `failproofai` em relação ao
-> bundle compilado em `dist/` — sem um build, você receberá erros de hook como `Cannot find package 'failproofai'`.
-> Refaça o build após alterar `src/`. Veja
+> bundle compilado em `dist/` — sem um build você encontrará erros de hook `Cannot find package 'failproofai'`.
+> Refaça o build após alterar `src/`. Consulte
 > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
diff --git a/docs/i18n/README.ru.md b/docs/i18n/README.ru.md
index 44a12f8..6204b02 100644
--- a/docs/i18n/README.ru.md
+++ b/docs/i18n/README.ru.md
@@ -19,12 +19,12 @@
 
 **Разрешение ошибок во время выполнения для кодирующих агентов.**
 Интегрируется с Claude Code и Codex. Перехватывает бесконечные циклы, опасные действия и утечки секретов
-прежде, чем они станут инцидентами. Нулевая задержка. Работает локально.
+до того, как они станут инцидентами. Нулевая латентность. Работает локально.
 
 </div>
 
 <p align="center">
-  <img src="readme-arch-hq.gif" alt="Failproof AI in action" width="800" />
+  <img src="readme-arch-hq.gif" alt="Failproof AI в действии" width="800" />
 </p>
 
 ---
@@ -80,7 +80,7 @@
   </a>
 </p>
 
-> Установите hooks для одного или нескольких: `failproofai policies --install --cli opencode pi gemini` (или `--cli claude codex copilot cursor opencode pi gemini`). Пропустите `--cli` для автоматического определения установленных CLI и подтверждения.
+> Установите хуки для одного или любой комбинации: `failproofai policies --install --cli opencode pi gemini` (или `--cli claude codex copilot cursor opencode pi gemini`). Опустите `--cli` для автоматического обнаружения установленных CLI и выбора.
 
 ---
 
@@ -92,7 +92,7 @@ failproofai policies --install   # или просто запустите `failp
 failproofai
 ```
 
-30 встроенных политик активируются сразу же. Панель управления доступна на `localhost:8020`. Отключите предложение при первом запуске с помощью `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 встроенных политик активируются немедленно. Панель управления на `localhost:8020`. Отключите подсказку при первом запуске с `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
@@ -100,20 +100,20 @@ failproofai
 
 | Политика | Что она блокирует |
 |---|---|
-| `block-push-master` | Прямые push в `main` / `master` |
+| `block-push-master` | Прямые пуши в `main` / `master` |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | Commits, merges, rebases на `main` / `master` |
+| `block-work-on-main` | Коммиты, слияния, перебазирования на `main` / `master` |
 | `block-rm-rf` | Рекурсивное удаление файлов |
-| `sanitize-api-keys` | Утечки API ключей в контекст агента |
+| `sanitize-api-keys` | Утечки API-ключей в контекст агента |
 
 → [Все 30 встроенных политик](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
-## Собственные политики
+## Ваши собственные политики
 
-Поместите файл в `.failproofai/policies/` — он загружается автоматически без дополнительных флагов.
-Заcommitьте его, и вся команда получит обновление при следующем pull.
+Просто скиньте файл в `.failproofai/policies/` — он загружается автоматически, никаких флагов не нужно.
+Закоммитьте его, и вся команда получит его при следующем пуле.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -134,18 +134,18 @@ customPolicies.add({
 | Решение | Эффект |
 |---|---|
 | `allow()` | Разрешить операцию |
-| `deny(message)` | Заблокировать — сообщение вернётся агенту |
-| `instruct(message)` | Пропустить, но добавить контекст в следующий prompt агента |
+| `deny(message)` | Заблокировать её — сообщение вернётся агенту |
+| `instruct(message)` | Пропустить, но добавить контекст в следующий запрос агента |
 
 → [Руководство по пользовательским политикам](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## Видимость сеанса
+## Видимость сессии
 
-Каждый вызов инструмента, который делает ваш агент, логируется локально. Панель управления показывает, что запустилось,
-что было заблокировано и что политика сказала агенту — так что вы не гадаете,
-когда что-то идёт не так. → [Руководство по панели управления](https://docs.befailproof.ai/dashboard)
+Каждый вызов инструмента, который делает ваш агент, логируется локально. Панель управления показывает, что было запущено,
+что было заблокировано и что политика сказала агенту — так что вы не будете гадать,
+когда что-то пойдёт не так. → [Руководство по панели управления](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -153,12 +153,12 @@ customPolicies.add({
 
 | | |
 |---|---|
-| [Начало работы](https://docs.befailproof.ai/getting-started) | Установка и первые шаги |
-| [Встроенные политики](https://docs.befailproof.ai/built-in-policies) | Все 30 политик с параметрами |
-| [Пользовательские политики](https://docs.befailproof.ai/custom-policies) | Напишите свои собственные |
-| [Конфигурация](https://docs.befailproof.ai/configuration) | Области конфигурации и правила объединения |
-| [Панель управления](https://docs.befailproof.ai/dashboard) | Мониторинг сеанса и активность политик |
-| [Архитектура](https://docs.befailproof.ai/architecture) | Как работает система hooks |
+| [Getting Started](https://docs.befailproof.ai/getting-started) | Установка и первые шаги |
+| [Built-in Policies](https://docs.befailproof.ai/built-in-policies) | Все 30 политик с параметрами |
+| [Custom Policies](https://docs.befailproof.ai/custom-policies) | Напишите свои |
+| [Configuration](https://docs.befailproof.ai/configuration) | Области конфигурации и правила слияния |
+| [Dashboard](https://docs.befailproof.ai/dashboard) | Монитор сессий и активность политик |
+| [Architecture](https://docs.befailproof.ai/architecture) | Как работает система хуков |
 
 ---
 
@@ -170,9 +170,9 @@ MIT с [Commons Clause](https://commonsclause.com/) — бесплатно дл
 
 ## Вклад
 
-См. [CONTRIBUTING.md](./CONTRIBUTING.md). Новые политики, граничные случаи и переводы приветствуются.
+См. [CONTRIBUTING.md](./CONTRIBUTING.md). Новые политики, граничные случаи и переводы всегда приветствуются.
 
-> **Сначала выполните сборку.** Запустите `bun install && bun run build`. Этот репозиторий запускает собственные hooks failproofai на себе, и они разрешают импорт `failproofai` относительно скомпилированного пакета `dist/` — без сборки вы получите ошибки hooks `Cannot find package 'failproofai'`. Пересоберите после изменений в `src/`. See
+> **Сначала соберите проект.** Запустите `bun install && bun run build`. Этот репозиторий использует собственные хуки failproofai, и они разрешают импорт `failproofai` относительно скомпилированного бандла `dist/` — без сборки вы получите ошибки хуков `Cannot find package 'failproofai'`. Пересоберите после изменений в `src/`. См.
 > [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
diff --git a/docs/i18n/README.tr.md b/docs/i18n/README.tr.md
index f61d093..c810508 100644
--- a/docs/i18n/README.tr.md
+++ b/docs/i18n/README.tr.md
@@ -17,19 +17,19 @@
 
 **Çeviriler:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**Kodlama ajanları için runtime hata çözümü.**
-Claude Code ve Codex ile entegrasyon. Döngüleri, tehlikeli işlemleri ve gizli bilgilerin sızmasını
-bunlar sorun olmadan önce yakalar. Sıfır gecikme. Yerel olarak çalışır.
+**Kodlama ajanları için çalışma zamanı hata çözümü.**
+Claude Code ve Codex ile entegre olur. Döngüleri, tehlikeli işlemleri ve gizli sızıntıları
+olay haline gelmeden yakalar. Sıfır gecikme. Yerel olarak çalışır.
 
 </div>
 
 <p align="center">
-  <img src="readme-arch-hq.gif" alt="Failproof AI in action" width="800" />
+  <img src="readme-arch-hq.gif" alt="Failproof AI işlemde" width="800" />
 </p>
 
 ---
 
-## Desteklenen ajan CLIleri
+## Desteklenen ajan CLI'ları
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -80,40 +80,40 @@ bunlar sorun olmadan önce yakalar. Sıfır gecikme. Yerel olarak çalışır.
   </a>
 </p>
 
-> Hook'ları bir veya birkaç kombinasyon için yükleyin: `failproofai policies --install --cli opencode pi gemini` (veya `--cli claude codex copilot cursor opencode pi gemini`). Kurulu CLIleri otomatik olarak algılamak ve seçim yapmak için `--cli` parametresini ihmal edin.
+> Bir veya birkaç kombinasyon için hook'ları yükleyin: `failproofai policies --install --cli opencode pi gemini` (veya `--cli claude codex copilot cursor opencode pi gemini`). Kurulu CLI'ları otomatik olarak algılamak ve istemde görüntülemek için `--cli` parametresini atlayın.
 
 ---
 
-## Yükleme
+## Kurulum
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # veya sadece `failproofai` komutunu çalıştırın ve ilk çalıştırma istemini kabul edin
+failproofai policies --install   # veya sadece `failproofai` çalıştırın ve ilk çalışmada istemi kabul edin
 failproofai
 ```
 
-30 yerleşik politika hemen etkinleşir. Pano adresinde `localhost:8020` bulunur. İlk çalıştırma istemini `FAILPROOFAI_NO_FIRST_RUN=1` ile devre dışı bırakabilirsiniz.
+30 yerleşik ilke hemen devreye girer. Gösterge paneli `localhost:8020` adresinde bulunur. İlk çalışma istemini `FAILPROOFAI_NO_FIRST_RUN=1` ile devre dışı bırakın.
 
 ---
 
-## Neyi durdurur
+## Ne engeller
 
-| Politika | Neyi engeller |
+| İlke | Ne engellediği |
 |---|---|
-| `block-push-master` | `main` / `master` dalına doğrudan push işlemleri |
-| `block-force-push` | `git push --force` komutu |
-| `block-work-on-main` | `main` / `master` dalında commit, merge, rebase işlemleri |
-| `block-rm-rf` | Özyinelemeli dosya silme |
+| `block-push-master` | `main` / `master` dalına doğrudan itme |
+| `block-force-push` | `git push --force` |
+| `block-work-on-main` | `main` / `master` üzerinde değişiklikleri kaydetme, birleştirme, yeniden temellendirme |
+| `block-rm-rf` | Tekrarlamalı dosya silme |
 | `sanitize-api-keys` | API anahtarlarının ajan bağlamına sızması |
 
-→ [Tüm 30 yerleşik politika](https://docs.befailproof.ai/built-in-policies)
+→ [Tüm 30 yerleşik ilke](https://docs.befailproof.ai/built-in-policies)
 
 ---
 
-## Kendi politikalarınız
+## Kendi ilkeleriniz
 
-`.failproofai/policies/` klasörüne bir dosya koyun — otomatik olarak yüklenir, bayrak gerekmez.
-Commit edin ve tüm takım bir sonraki pull'da bunu alır.
+`.failproofai/policies/` klasörüne bir dosya bırakın — otomatik olarak yüklenir, hiçbir parametre gerekmez.
+Bunu kaydedin ve tüm takım bir sonraki çekme sırasında alır.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -123,29 +123,28 @@ customPolicies.add({
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolInput?.file_path?.includes("production"))
-      return deny("Writes to production paths are blocked.");
+      return deny("Production yollarına yazma işlemleri engellenir.");
     return allow();
   },
 });
 ```
 
-Her politika için üç karar mevcuttur:
+Her ilke için kullanılabilir üç karar:
 
 | Karar | Etki |
 |---|---|
 | `allow()` | İşleme izin ver |
-| `deny(message)` | Engelle — mesaj ajana geri gönderilir |
-| `instruct(message)` | Geçişe izin ver, ama ajana bir sonraki komutuna bağlam ekle |
+| `deny(message)` | Engelle — mesaj ajana geri döner |
+| `instruct(message)` | İzin ver, ancak ajanın bir sonraki isteme bağlam ekle |
 
-→ [Özel politikalar kılavuzu](https://docs.befailproof.ai/custom-policies)
+→ [Özel ilkeler rehberi](https://docs.befailproof.ai/custom-policies)
 
 ---
 
 ## Oturum görünürlüğü
 
-Ajanınızın yaptığı her araç çağrısı yerel olarak günlüğe kaydedilir. Pano, neyin çalıştığını,
-neyin engellendiğini ve politikanın ajana ne söylediğini gösterir — böylece bir şey yanlış gittiğinde
-tahmin etmeniz gerekmez. → [Pano kılavuzu](https://docs.befailproof.ai/dashboard)
+Ajanınızın yaptığı her araç çağrısı yerel olarak günlüğe kaydedilir. Gösterge paneli neyin çalıştığını,
+neyin engellendiğini ve ilkenin ajana söylediklerini gösterir — böylece bir şeyler yanlış gittiğinde tahmin yapmıyorsunuz. → [Gösterge paneli rehberi](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -153,32 +152,28 @@ tahmin etmeniz gerekmez. → [Pano kılavuzu](https://docs.befailproof.ai/dashbo
 
 | | |
 |---|---|
-| [Başlangıç](https://docs.befailproof.ai/getting-started) | Yükleme ve ilk adımlar |
-| [Yerleşik Politikalar](https://docs.befailproof.ai/built-in-policies) | Tüm 30 politika ve parametreleri |
-| [Özel Politikalar](https://docs.befailproof.ai/custom-policies) | Kendi politikalarınızı yazın |
+| [Başlangıç](https://docs.befailproof.ai/getting-started) | Kurulum ve ilk adımlar |
+| [Yerleşik İlkeler](https://docs.befailproof.ai/built-in-policies) | Tüm 30 ilke ve parametreleri |
+| [Özel İlkeler](https://docs.befailproof.ai/custom-policies) | Kendi ilkelerinizi yazın |
 | [Yapılandırma](https://docs.befailproof.ai/configuration) | Yapılandırma kapsamları ve birleştirme kuralları |
-| [Pano](https://docs.befailproof.ai/dashboard) | Oturum izleyici ve politika aktivitesi |
+| [Gösterge Paneli](https://docs.befailproof.ai/dashboard) | Oturum monitörü ve ilke aktivitesi |
 | [Mimari](https://docs.befailproof.ai/architecture) | Hook sistemi nasıl çalışır |
 
 ---
 
 ## Lisans
 
-MIT with [Commons Clause](https://commonsclause.com/) — dahili ve kişisel kullanım için ücretsiz; failproofai'nin ticari yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için [LICENSE](./LICENSE) bölümüne bakın.
+MIT ve [Commons Clause](https://commonsclause.com/) — dahili ve kişisel kullanım için ücretsiz; failproofai'nin ticari yeniden satışı ayrı bir anlaşma gerektirir. Tam metin için [LICENSE](./LICENSE) dosyasına bakın.
 
 ---
 
 ## Katkıda Bulunma
 
-[CONTRIBUTING.md](./CONTRIBUTING.md) bölümüne bakın. Yeni politikalar, kenar durumları ve çeviriler her zaman hoş karşılanır.
+[CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın. Yeni ilkeler, kenar durumlar ve çeviriler hoş karşılanır.
 
-> **Başlamadan önce derleyin.** Önce `bun install && bun run build` komutunu çalıştırın. Bu repo,
-> failproofai'nin kendi hook'larını kendisinde çalıştırır ve `failproofai` importunu
-> derlenmiş `dist/` paketi ile çözer — derleme olmadan `Cannot find package 'failproofai'`
-> hook hataları alırsınız. `src/` dosyalarında değişiklik yaptıktan sonra yeniden derleyin. Bkz.
-> [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
+> **Başlamadan önce derleyin.** Önce `bun install && bun run build` komutunu çalıştırın. Bu depo, failproofai'nin kendi hook'larını kendisi üzerinde çalıştırır ve `failproofai` ithalatını derlenmiş `dist/` paketine karşı çözer — derleme olmadan `Cannot find package 'failproofai'` hook hatalarına rastlarsınız. `src/` değişikliklerinden sonra yeniden derleyin. Bkz. [In-repo dev hook'larının çalışması için derleme gerekli](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
 
-[Nivedit Jain](https://github.com/NiveditJain) ve [Nikita Agarwal](https://github.com/nk-ag) tarafından yapıldı.
+[Nivedit Jain](https://github.com/NiveditJain) ve [Nikita Agarwal](https://github.com/nk-ag) tarafından yapılmıştır.
 [befailproof.ai](https://befailproof.ai)
diff --git a/docs/i18n/README.vi.md b/docs/i18n/README.vi.md
index 4ff04bc..5606074 100644
--- a/docs/i18n/README.vi.md
+++ b/docs/i18n/README.vi.md
@@ -17,8 +17,8 @@
 
 **Bản dịch:** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**Giải pháp xử lý lỗi trong thời gian chạy cho các agent lập trình.**
-Kết hợp với Claude Code và Codex. Phát hiện vòng lặp, hành động nguy hiểm và rò rỉ bí mật
+**Giải pháp xử lý lỗi thời gian chạy cho các tác nhân lập trình.**
+Kết nối với Claude Code và Codex. Phát hiện vòng lặp, hành động nguy hiểm và rò rỉ bí mật
 trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy cục bộ.
 
 </div>
@@ -29,7 +29,7 @@ trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy c
 
 ---
 
-## Các CLI agent được hỗ trợ
+## Hỗ trợ các CLI tác nhân
 
 <p align="center">
   <a href="https://claude.com/claude-code" title="Claude Code">
@@ -80,7 +80,7 @@ trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy c
   </a>
 </p>
 
-> Cài đặt hook cho một hoặc nhiều: `failproofai policies --install --cli opencode pi gemini` (hoặc `--cli claude codex copilot cursor opencode pi gemini`). Bỏ qua `--cli` để tự động phát hiện các CLI được cài đặt và nhắc lựa chọn.
+> Cài đặt hook cho một hoặc nhiều kết hợp: `failproofai policies --install --cli opencode pi gemini` (hoặc `--cli claude codex copilot cursor opencode pi gemini`). Bỏ qua `--cli` để tự động phát hiện các CLI đã cài đặt và nhắc nhở.
 
 ---
 
@@ -92,7 +92,7 @@ failproofai policies --install   # hoặc chỉ cần chạy `failproofai` và c
 failproofai
 ```
 
-30 chính sách tích hợp được kích hoạt ngay lập tức. Bảng điều khiển tại `localhost:8020`. Vô hiệu hóa lời nhắc lần đầu bằng `FAILPROOFAI_NO_FIRST_RUN=1`.
+30 chính sách tích hợp được kích hoạt ngay lập tức. Bảng điều khiển tại `localhost:8020`. Vô hiệu hóa lời nhắc lần đầu với `FAILPROOFAI_NO_FIRST_RUN=1`.
 
 ---
 
@@ -102,9 +102,9 @@ failproofai
 |---|---|
 | `block-push-master` | Đẩy trực tiếp đến `main` / `master` |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | Commit, merge, rebase trên `main` / `master` |
+| `block-work-on-main` | Commit, hợp nhất, rebase trên `main` / `master` |
 | `block-rm-rf` | Xóa tệp đệ quy |
-| `sanitize-api-keys` | API key rò rỉ vào ngữ cảnh agent |
+| `sanitize-api-keys` | Khóa API rò rỉ vào ngữ cảnh tác nhân |
 
 → [Tất cả 30 chính sách tích hợp](https://docs.befailproof.ai/built-in-policies)
 
@@ -113,7 +113,7 @@ failproofai
 ## Chính sách của riêng bạn
 
 Thả một tệp vào `.failproofai/policies/` — nó tải tự động, không cần cờ nào.
-Commit nó và toàn bộ nhóm sẽ nhận được nó ở lần kéo tiếp theo.
+Commit nó và toàn bộ nhóm sẽ nhận được nó vào lần pull tiếp theo.
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -123,7 +123,7 @@ customPolicies.add({
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (ctx.toolInput?.file_path?.includes("production"))
-      return deny("Writes to production paths are blocked.");
+      return deny("Ghi vào đường dẫn sản xuất bị chặn.");
     return allow();
   },
 });
@@ -133,19 +133,19 @@ Ba quyết định có sẵn cho mọi chính sách:
 
 | Quyết định | Hiệu ứng |
 |---|---|
-| `allow()` | Cho phép hoạt động |
-| `deny(message)` | Chặn nó — thông báo quay trở lại agent |
-| `instruct(message)` | Để nó tiếp tục, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent |
+| `allow()` | Cho phép thao tác |
+| `deny(message)` | Chặn nó — thông báo quay lại tác nhân |
+| `instruct(message)` | Cho phép nó thông qua, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của tác nhân |
 
 → [Hướng dẫn chính sách tùy chỉnh](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## Tính nhìn thấy phiên
+## Khả năng hiển thị phiên
 
-Mọi lệnh công cụ mà agent của bạn thực hiện đều được ghi nhật ký cục bộ. Bảng điều khiển hiển thị những gì đã chạy,
-những gì bị chặn và những gì chính sách nói với agent — vì vậy bạn không phải đoán
-khi có gì đó không ổn. → [Hướng dẫn bảng điều khiển](https://docs.befailproof.ai/dashboard)
+Mọi lệnh gọi công cụ mà tác nhân của bạn thực hiện đều được ghi lại cục bộ. Bảng điều khiển hiển thị những gì đã chạy,
+những gì bị chặn và những gì chính sách cho tác nhân — vì vậy bạn không phải đoán
+khi có điều gì đó không ổn. → [Hướng dẫn bảng điều khiển](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -154,8 +154,8 @@ khi có gì đó không ổn. → [Hướng dẫn bảng điều khiển](https:
 | | |
 |---|---|
 | [Bắt đầu](https://docs.befailproof.ai/getting-started) | Cài đặt và các bước đầu tiên |
-| [Chính sách tích hợp](https://docs.befailproof.ai/built-in-policies) | Tất cả 30 chính sách với tham số |
-| [Chính sách tùy chỉnh](https://docs.befailproof.ai/custom-policies) | Viết của riêng bạn |
+| [Chính sách tích hợp](https://docs.befailproof.ai/built-in-policies) | Tất cả 30 chính sách với các tham số |
+| [Chính sách tùy chỉnh](https://docs.befailproof.ai/custom-policies) | Viết chính sách của riêng bạn |
 | [Cấu hình](https://docs.befailproof.ai/configuration) | Phạm vi cấu hình và quy tắc hợp nhất |
 | [Bảng điều khiển](https://docs.befailproof.ai/dashboard) | Giám sát phiên và hoạt động chính sách |
 | [Kiến trúc](https://docs.befailproof.ai/architecture) | Cách hệ thống hook hoạt động |
@@ -164,19 +164,19 @@ khi có gì đó không ổn. → [Hướng dẫn bảng điều khiển](https:
 
 ## Giấy phép
 
-MIT với [Commons Clause](https://commonsclause.com/) — miễn phí cho sử dụng nội bộ và cá nhân; tái bán thương mại của failproofai cần thỏa thuận riêng. Xem [LICENSE](./LICENSE) để xem toàn bộ văn bản.
+MIT với [Commons Clause](https://commonsclause.com/) — miễn phí để sử dụng nội bộ và cá nhân; bán lại thương mại của failproofai yêu cầu một thỏa thuận riêng. Xem [LICENSE](./LICENSE) để biết toàn bộ nội dung.
 
 ---
 
 ## Đóng góp
 
-Xem [CONTRIBUTING.md](./CONTRIBUTING.md). Các chính sách mới, trường hợp biên, và bản dịch đều được chào đón.
+Xem [CONTRIBUTING.md](./CONTRIBUTING.md). Chính sách mới, trường hợp cạnh biên và bản dịch đều được hoan nghênh.
 
-> **Xây dựng trước khi bắt đầu.** Chạy `bun install && bun run build` trước tiên. Repository này chạy
-> các hook của failproofai trên chính nó, và chúng giải quyết import `failproofai` đối với
-> bundle `dist/` được biên dịch — nếu không xây dựng bạn sẽ gặp lỗi hook `Cannot find package 'failproofai'`.
-> Xây dựng lại sau khi thay đổi `src/`. Xem
-> [Build before the in-repo dev hooks will work](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
+> **Xây dựng trước khi bắt đầu.** Chạy `bun install && bun run build` trước tiên. Kho này chạy
+> hook của failproofai trên chính nó, và chúng giải quyết nhập `failproofai` so với
+> gói `dist/` đã biên dịch — nếu không có bản dựng bạn sẽ gặp lỗi `Cannot find package 'failproofai'`
+> hook. Xây dựng lại sau khi thay đổi `src/`. Xem
+> [Xây dựng trước khi hook dev trong kho sẽ hoạt động](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work).
 
 ---
 
diff --git a/docs/i18n/README.zh.md b/docs/i18n/README.zh.md
index 304e523..1800b6c 100644
--- a/docs/i18n/README.zh.md
+++ b/docs/i18n/README.zh.md
@@ -17,8 +17,8 @@
 
 **翻译版本：** [简体中文](./docs/i18n/README.zh.md) · [日本語](./docs/i18n/README.ja.md) · [한국어](./docs/i18n/README.ko.md) · [Español](./docs/i18n/README.es.md) · [Português](./docs/i18n/README.pt-br.md) · [Deutsch](./docs/i18n/README.de.md) · [Français](./docs/i18n/README.fr.md) · [Русский](./docs/i18n/README.ru.md) · [हिन्दी](./docs/i18n/README.hi.md) · [Türkçe](./docs/i18n/README.tr.md) · [Tiếng Việt](./docs/i18n/README.vi.md) · [Italiano](./docs/i18n/README.it.md) · [العربية](./docs/i18n/README.ar.md) · [עברית](./docs/i18n/README.he.md)
 
-**为编码智能体提供运行时故障解决方案。**
-接入 Claude Code 和 Codex，在死循环、危险操作和密钥泄漏演变为事故之前将其拦截。零延迟，本地运行。
+**为编码智能体提供运行时故障处理能力。**
+集成 Claude Code 和 Codex，在循环、危险操作和密钥泄露酿成事故之前将其拦截。零延迟，本地运行。
 
 </div>
 
@@ -79,7 +79,7 @@
   </a>
 </p>
 
-> 为一个或多个 CLI 安装 hook：`failproofai policies --install --cli opencode pi gemini`（或 `--cli claude codex copilot cursor opencode pi gemini`）。省略 `--cli` 参数可自动检测已安装的 CLI 并提示选择。
+> 可为一个或多个 CLI 安装 hooks：`failproofai policies --install --cli opencode pi gemini`（或 `--cli claude codex copilot cursor opencode pi gemini`）。省略 `--cli` 则自动检测已安装的 CLI 并提示选择。
 
 ---
 
@@ -87,11 +87,11 @@
 
 ```sh
 npm install -g failproofai
-failproofai policies --install   # 或直接运行 `failproofai` 并接受首次运行提示
+failproofai policies --install   # 或直接运行 `failproofai` 并在首次运行提示中确认
 failproofai
 ```
 
-30 条内置策略即刻生效。控制台访问地址：`localhost:8020`。可通过设置 `FAILPROOFAI_NO_FIRST_RUN=1` 禁用首次运行提示。
+30 条内置策略立即生效。Dashboard 地址为 `localhost:8020`。设置 `FAILPROOFAI_NO_FIRST_RUN=1` 可禁用首次运行提示。
 
 ---
 
@@ -99,11 +99,11 @@ failproofai
 
 | 策略 | 拦截内容 |
 |---|---|
-| `block-push-master` | 直接推送至 `main` / `master` 分支 |
+| `block-push-master` | 直接推送到 `main` / `master` 分支 |
 | `block-force-push` | `git push --force` |
-| `block-work-on-main` | 在 `main` / `master` 上的提交、合并、变基操作 |
+| `block-work-on-main` | 在 `main` / `master` 上提交、合并、变基 |
 | `block-rm-rf` | 递归删除文件 |
-| `sanitize-api-keys` | 防止 API 密钥泄漏到智能体上下文中 |
+| `sanitize-api-keys` | API 密钥泄露到智能体上下文 |
 
 → [全部 30 条内置策略](https://docs.befailproof.ai/built-in-policies)
 
@@ -111,7 +111,7 @@ failproofai
 
 ## 自定义策略
 
-将文件放入 `.failproofai/policies/` 目录即可自动加载，无需任何额外参数。将其提交到版本库，团队成员下次拉取后即可同步生效。
+将文件放入 `.failproofai/policies/` 目录即可自动加载，无需任何额外参数。提交到代码库后，团队成员在下次拉取时即可同步生效。
 
 ```js
 import { customPolicies, deny, allow } from "failproofai";
@@ -132,16 +132,16 @@ customPolicies.add({
 | 决策 | 效果 |
 |---|---|
 | `allow()` | 允许该操作 |
-| `deny(message)` | 拦截该操作——消息将反馈给智能体 |
-| `instruct(message)` | 放行该操作，但向智能体的下一次提示中追加上下文信息 |
+| `deny(message)` | 拦截操作——消息将返回给智能体 |
+| `instruct(message)` | 放行，但在智能体的下一次提示中附加上下文 |
 
 → [自定义策略指南](https://docs.befailproof.ai/custom-policies)
 
 ---
 
-## 会话可见性
+## 会话可视化
 
-智能体发起的每一次工具调用均会在本地记录日志。控制台会展示执行了哪些操作、哪些被拦截、以及策略向智能体反馈了什么——出现问题时无需靠猜测排查。→ [控制台指南](https://docs.befailproof.ai/dashboard)
+智能体的每一次工具调用都会在本地记录日志。Dashboard 展示了哪些操作已执行、哪些被拦截，以及策略向智能体返回了什么内容——让你在出现问题时不再两眼一抹黑。→ [Dashboard 指南](https://docs.befailproof.ai/dashboard)
 
 ---
 
@@ -149,28 +149,28 @@ customPolicies.add({
 
 | | |
 |---|---|
-| [快速开始](https://docs.befailproof.ai/getting-started) | 安装与初始配置 |
+| [快速入门](https://docs.befailproof.ai/getting-started) | 安装与初始配置 |
 | [内置策略](https://docs.befailproof.ai/built-in-policies) | 全部 30 条策略及其参数说明 |
-| [自定义策略](https://docs.befailproof.ai/custom-policies) | 编写自己的策略 |
-| [配置说明](https://docs.befailproof.ai/configuration) | 配置作用域与合并规则 |
-| [控制台](https://docs.befailproof.ai/dashboard) | 会话监控与策略活动 |
-| [架构](https://docs.befailproof.ai/architecture) | hook 系统的工作原理 |
+| [自定义策略](https://docs.befailproof.ai/custom-policies) | 编写你自己的策略 |
+| [配置](https://docs.befailproof.ai/configuration) | 配置作用域与合并规则 |
+| [Dashboard](https://docs.befailproof.ai/dashboard) | 会话监控与策略活动 |
+| [架构](https://docs.befailproof.ai/architecture) | Hook 系统的工作原理 |
 
 ---
 
 ## 许可证
 
-MIT 协议附加 [Commons Clause](https://commonsclause.com/)——内部及个人使用免费；若需将 failproofai 本身作为商业产品转售，须另行签署协议。完整条款请参见 [LICENSE](./LICENSE)。
+MIT 附加 [Commons Clause](https://commonsclause.com/)——个人及内部使用免费；将 failproofai 本身用于商业转售需另行签订协议。完整条款请参阅 [LICENSE](./LICENSE)。
 
 ---
 
-## 参与贡献
+## 贡献
 
-请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。欢迎贡献新策略、边界用例处理和翻译内容。
+请参阅 [CONTRIBUTING.md](./CONTRIBUTING.md)。欢迎贡献新策略、边界用例以及翻译。
 
-> **开始前请先构建项目。** 首先运行 `bun install && bun run build`。本仓库会对自身运行 failproofai 的 hook，这些 hook 会从编译后的 `dist/` 包中解析 `failproofai` 导入——若未先构建，将出现 `Cannot find package 'failproofai'` 的 hook 错误。修改 `src/` 后需重新构建。详见 [构建后仓库内开发 hook 方可正常工作](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)。
+> **开始前请先构建项目。** 首先运行 `bun install && bun run build`。本仓库使用 failproofai 自身的 hooks 对自身进行管控，这些 hooks 会将 `failproofai` 的导入解析到编译后的 `dist/` 包——若未构建，则会出现 `Cannot find package 'failproofai'` 的 hook 错误。修改 `src/` 后需重新构建。详见 [构建说明：让仓库内开发 hooks 正常工作](./CONTRIBUTING.md#build-before-the-in-repo-dev-hooks-will-work)。
 
 ---
 
-由 [Nivedit Jain](https://github.com/NiveditJain) 和 [Nikita Agarwal](https://github.com/nk-ag) 构建。
+由 [Nivedit Jain](https://github.com/NiveditJain) 和 [Nikita Agarwal](https://github.com/nk-ag) 共同构建。
 [befailproof.ai](https://befailproof.ai)