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

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

@@ -1,10 +1,10 @@
 ---
-title: מדיניות מותאמות אישית
-description: "כתוב כללים משלך ב-JavaScript - אכוף קונבנציות, מנע סחיפה, גלה כשלים, היווצרות קשור עם מערכות חיצוניות"
+title: מדיניויות מותאמות אישית
+description: "כתוב כללים משלך ב-JavaScript - אכוף קונבנציות, מנע סטיות, גלה כשלים, שלב עם מערכות חיצוניות"
 icon: code
 ---
 
-מדיניות מותאמות אישית מאפשרת לך לכתוב כללים לכל התנהגות סוכן: אכוף קונבנציות פרויקט, מנע סחיפה, תגדור פעולות הרסניות, גלה סוכנים תקועים, או היווצרות קשור עם Slack, זרימות אישור, ועוד. הם משתמשים באותה מערכת אירוע hook ובהחלטות `allow`, `deny`, `instruct` כמו מדיניות מובנית.
+מדיניויות מותאמות אישית מאפשרות לך לכתוב כללים לכל התנהגות של סוכן: אכוף קונבנציות פרויקט, מנע סטיות, חסום פעולות הרסניות, גלה סוכנים תקועים, או שלב עם Slack, זרימות אישור ועוד. הם משתמשים באותה מערכת אירועי hook וקבלות החלטות `allow`, `deny`, `instruct` כמו מדיניויות מובנות.
 
 ---
 
@@ -29,7 +29,7 @@ customPolicies.add({
 });
 ```
 
-התקן אותו:
+התקן אותה:
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -37,54 +37,54 @@ failproofai policies --install --custom ./my-policies.js
 
 ---
 
-## שתי דרכים לטעון מדיניות מותאמת אישית
+## שתי דרכים לטעון מדיניויות מותאמות אישית
 
 ### אפשרות 1: מבוססת קונבנציה (מומלץ)
 
-שים קבצים `*policies.{js,mjs,ts}` ב-`.failproofai/policies/` והם נטענים באופן אוטומטי — אין צורך בדגלים או שינויי תצורה. זה עובד כמו git hooks: שים קובץ, זה פשוט עובד.
+שם קבצי `*policies.{js,mjs,ts}` ב-`.failproofai/policies/` והם נטענים באופן אוטומטי — אין צורך בדגלים או שינויי תצורה. זה פועל כמו git hooks: שם קובץ, זה פשוט עובד.
 
 ```
-# Project level — committed to git, shared with the team
+# ברמת פרויקט — מחויב ב-git, משותף עם הצוות
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# User level — personal, applies to all projects
+# ברמת משתמש — אישי, חל על כל הפרויקטים
 ~/.failproofai/policies/my-policies.mjs
 ```
 
 **איך זה עובד:**
-- שתי ספריות פרויקט ומשתמש סורקות (איחוד — לא ראשון-סקופ-ינצחון)
-- קבצים נטענים בסדר אלפביתי בתוך כל ספרייה. הוספת קידומת עם `01-`, `02-` לשליטה בסדר
-- רק קבצים המתאימים ל-`*policies.{js,mjs,ts}` נטענים; קבצים אחרים מתעלמים
-- כל קובץ נטען באופן עצמאי (fail-open לכל קובץ)
-- עובד לצד `--custom` מפורשים ומדיניות מובנית
+- שני הספריות של פרויקט ומשתמש סורקות (איחוד — לא first-scope-wins)
+- קבצים נטענים באופן אלפביתי בכל ספרייה. הוסף קידומת עם `01-`, `02-` כדי לשלוט בסדר
+- רק קבצים התואמים `*policies.{js,mjs,ts}` נטענים; קבצים אחרים מתעלמים
+- כל קובץ נטען בנפרד (fail-open לכל קובץ)
+- עובד לצד `--custom` מפורש ומדיניויות מובנות
 
 <Tip>
-מדיניות קונבנציה היא הדרך הקלה ביותר לשתף מדיניות בכל הקבוצה. Commit `.failproofai/policies/` ל-git וכל חברי הקבוצה מקבלים אותם באופן אוטומטי.
+מדיניויות קונבנציה הן הדרך הקלה ביותר לבנות תקן איכות עבור הארגון שלך. קבע `.failproofai/policies/` ל-git וכל חברי הצוות יקבלו את אותם כללים באופן אוטומטי — אין צורך בהתקנה לכל מפתח. כאשר הצוות שלך גוקל מצבי כשל חדשים, הוסף מדיניות ודחוף. עם הזמן אלה הופכים לתקן איכות חי המשתפר עם כל תרומה.
 </Tip>
 
 ### אפשרות 2: נתיב קובץ מפורש
 
 ```bash
-# Install with a custom policies file
+# התקן עם קובץ מדיניויות מותאם אישית
 failproofai policies --install --custom ./my-policies.js
 
-# Replace the policies file path
+# החלף את נתיב קובץ המדיניויות
 failproofai policies --install --custom ./new-policies.js
 
-# Remove the custom policies path from config
+# הסר את נתיב המדיניויות המותאמות אישית מהתצורה
 failproofai policies --uninstall --custom
 ```
 
-הנתיב המוחלט שהוסדר מאוחסן ב-`policies-config.json` כ-`customPoliciesPath`. הקובץ נטען טרי בכל אירוע hook - אין שומרון בין אירועים.
+הנתיב המוחלט שנפתר מאוחסן ב-`policies-config.json` כ-`customPoliciesPath`. הקובץ נטען מחדש בכל אירוע hook - אין caching בין אירועים.
 
-### שימוש בשניהם ביחד
+### שימוש בשניהם יחד
 
-מדיניות קונבנציה וקובץ `--custom` מפורש יכולים להתקיים זה לצד זה. סדר טעינה:
+מדיניויות קונבנציה וקובץ `--custom` מפורש יכולים להתקיים. סדר הטעינה:
 
-1. קובץ `customPoliciesPath` מפורש (אם מחוקרן)
-2. קבצי קונבנציה פרויקט (`{cwd}/.failproofai/policies/`, אלפביתי)
-3. קבצי קונבנציה משתמש (`~/.failproofai/policies/`, אלפביתי)
+1. קובץ `customPoliciesPath` מפורש (אם מוגדר)
+2. קבצי קונבנציה של פרויקט (`{cwd}/.failproofai/policies/`, אלפביתי)
+3. קבצי קונבנציה של משתמש (`~/.failproofai/policies/`, אלפביתי)
 
 ---
 
@@ -98,7 +98,7 @@ import { customPolicies, allow, deny, instruct } from "failproofai";
 
 ### `customPolicies.add(hook)`
 
-רושם מדיניות. קרא זה כמה פעמים שצריך עבור מדיניות מרובות באותו קובץ.
+רושם מדיניות. קרא לפונקציה זו כמה פעמים שנדרש עבור מדיניויות מרובות באותו קובץ.
 
 ```ts
 customPolicies.add({
@@ -111,32 +111,32 @@ customPolicies.add({
 
 ### עוזרי החלטה
 
-| פונקציה | אפקט | השתמש כאשר |
+| פונקציה | השפעה | השתמש כאשר |
 |----------|--------|----------|
 | `allow()` | אפשר את הפעולה בשקט | הפעולה בטוחה, לא צריך הודעה |
 | `deny(message)` | חסום את הפעולה | הסוכן לא צריך לבצע פעולה זו |
-| `instruct(message)` | הוסף הקשר ללא חסימה | תן לסוכן הקשר נוסף כדי להישמר על מסלול |
+| `instruct(message)` | הוסף הקשר ללא חסימה | תן לסוכן הקשר נוסף להישארות על המסלול |
 
-`deny(message)` - ההודעה מופיעה ל-Claude עם קידומת `"Blocked by failproofai:"`. ערך `deny` יחיד מקצר את כל ההערכה הנוספת.
+`deny(message)` - ההודעה מופיעה לClaude עם קידומת `"Blocked by failproofai:"`. `deny` יחיד מקצר את כל ההערכה הנוספת.
 
-`instruct(message)` - ההודעה מוספת להקשר של Claude לקריאת הכלי הנוכחית. כל הודעות `instruct` מצטברות ומועברות ביחד.
+`instruct(message)` - ההודעה מצורפת להקשר של Claude לקריאת הכלי הנוכחית. כל הודעות `instruct` מצטברות ומועברות ביחד.
 
 <Tip>
-אתה יכול להוסיף הדרכה נוספת לכל הודעת `deny` או `instruct` על ידי הוספת שדה `hint` ב-`policyParams` — אין צורך בשינוי קוד. זה עובד עבור מדיניות מותאמת אישית (`custom/`), מדיניות קונבנציה פרויקט (`.failproofai-project/`), ומדיניות קונבנציה משתמש (`.failproofai-user/`) גם כן. ראה [Configuration → hint](/he/configuration#hint-cross-cutting) לפרטים.
+אתה יכול להוסיף הנחיה נוספת לכל הודעת `deny` או `instruct` על ידי הוספת שדה `hint` ב-`policyParams` — אין צורך בשינוי קוד. זה עובד עבור מדיניויות מותאמות אישית (`custom/`), קונבנציה של פרויקט (`.failproofai-project/`), וקונבנציה של משתמש (`.failproofai-user/`) גם כן. ראה [Configuration → hint](/he/configuration#hint-cross-cutting) לפרטים.
 </Tip>
 
 ### הודעות allow מידע
 
-`allow(message)` מאפשר את הפעולה **וגם** שולח הודעת מידע חזרה ל-Claude. ההודעה מועברת כ-`additionalContext` בתגובת stdout של מטפל hook — אותו מנגנון המשמש ב-`instruct`, אך שונה מבחינה סמנטית: זו עדכון סטטוס, לא אזהרה.
+`allow(message)` מאפשרת את הפעולה **וגם** שולחת הודעה מידע חזרה לClaude. ההודעה מועברת כ-`additionalContext` בתגובת stdout של מטפל ה-hook — אותה מנגנון המשמש `instruct`, אך שונה מבחינה סמנטית: זהו עדכון סטטוס, לא אזהרה.
 
-| פונקציה | אפקט | השתמש כאשר |
+| פונקציה | השפעה | השתמש כאשר |
 |----------|--------|----------|
-| `allow(message)` | אפשר ושלח הקשר ל-Claude | אשר שצ'ק עבר, או הסבר למה צ'ק דולק |
+| `allow(message)` | אפשר ושלח הקשר לClaude | אשר שצ'ק עבר, או הסבר למה צ'ק דולג |
 
 מקרי שימוש:
-- **אישורי סטטוס:** `allow("All CI checks passed.")` — אומר ל-Claude שהכל ירוק
-- **הסברי fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — אומר ל-Claude למה צ'ק דולק כדי שיהיה להם הקשר מלא
-- **הודעות מרובות מצטברות:** אם מדיניות מרובות מחזירות כל אחת `allow(message)`, כל ההודעות משולבות עם שורות חדשות ומועברות ביחד
+- **אישורי סטטוס:** `allow("All CI checks passed.")` — אומר לClaude שהכל ירוק
+- **הסברי fail-open:** `allow("GitHub CLI not installed, skipping CI check.")` — אומר לClaude למה צ'ק דולג כדי שיהיה לו הקשר מלא
+- **הודעות מרובות מצטברות:** אם מספר מדיניויות כל אחת החזר `allow(message)`, כל ההודעות מחוברות עם שורות חדשות ומועברות ביחד
 
 ```js
 customPolicies.add({
@@ -160,48 +160,48 @@ customPolicies.add({
 | שדה | סוג | תיאור |
 |-------|------|-------------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
-| `toolName` | `string \| undefined` | הכלי הנקרא (למשל `"Bash"`, `"Write"`, `"Read"`) |
+| `toolName` | `string \| undefined` | הכלי שנקרא (למשל `"Bash"`, `"Write"`, `"Read"`) |
 | `toolInput` | `Record<string, unknown> \| undefined` | פרמטרי הקלט של הכלי |
-| `payload` | `Record<string, unknown>` | חומלת עומס של אירוע גולמי מלא מ-Claude Code |
-| `session` | `SessionMetadata \| undefined` | הקשר של הפעילות (ראה להלן) |
+| `payload` | `Record<string, unknown>` | כל payload האירוע הגולמי מClaude Code |
+| `session` | `SessionMetadata \| undefined` | הקשר הסשן (ראה להלן) |
 
 ### שדות `SessionMetadata`
 
 | שדה | סוג | תיאור |
 |-------|------|-------------|
-| `sessionId` | `string` | Claude Code זהה הפעילות |
-| `cwd` | `string` | ספרייה עובדת של הפעילות Claude Code |
-| `transcriptPath` | `string` | נתיב לקובץ תמלול JSONL של הפעילות |
+| `sessionId` | `string` | מזהה סשן של Claude Code |
+| `cwd` | `string` | ספריית העבודה של סשן Claude Code |
+| `transcriptPath` | `string` | נתיב לקובץ תמליל JSONL של הסשן |
 
-### סוגי אירוע
+### סוגי אירועים
 
-| אירוע | מתי זה מתעורר | תוכן `toolInput` |
+| אירוע | מתי זה נוסק | תוכן `toolInput` |
 |-------|--------------|----------------------|
-| `PreToolUse` | לפני Claude מפעיל כלי | קלט הכלי (למשל `{ command: "..." }` עבור Bash) |
-| `PostToolUse` | לאחר השלמת כלי | קלט הכלי + `tool_result` (הפלט) |
-| `Notification` | כאשר Claude שולח הודעה | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hooks חייבים להחזיר תמיד `allow()`, הם לא יכולים חסום הודעות |
-| `Stop` | כאשר הפעילות Claude מסתיימת | ריק |
+| `PreToolUse` | לפני שClaude מריץ כלי | הקלט של הכלי (למשל `{ command: "..." }` עבור Bash) |
+| `PostToolUse` | אחרי שכלי משתלם | קלט הכלי + `tool_result` (הפלט) |
+| `Notification` | כשClaude שולח התראה | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hooks חייבים תמיד להחזיר `allow()`, הם לא יכולים לחסום התראות |
+| `Stop` | כשסשן Claude מסתיים | ריק |
 
 ---
 
 ## סדר הערכה
 
-מדיניות מוערכת בסדר זה:
+מדיניויות מוערכות בסדר זה:
 
-1. מדיניות מובנית (בסדר הגדרה)
-2. מדיניות מותאמת אישית מפורשת מ-`customPoliciesPath` (בסדר `.add()`)
-3. מדיניות קונבנציה מפרויקט `.failproofai/policies/` (קבצים אלפביתיים, סדר `.add()` בתוך)
-4. מדיניות קונבנציה מ-`~/.failproofai/policies/` משתמש (קבצים אלפביתיים, סדר `.add()` בתוך)
+1. מדיניויות מובנות (בסדר הגדרה)
+2. מדיניויות מותאמות אישית מפורשות מ-`customPoliciesPath` (בסדר `.add()`)
+3. מדיניויות קונבנציה מפרויקט `.failproofai/policies/` (קבצים אלפביתיים, סדר `.add()` בתוך)
+4. מדיניויות קונבנציה ממשתמש `~/.failproofai/policies/` (קבצים אלפביתיים, סדר `.add()` בתוך)
 
 <Note>
-`deny` הראשון מקצר את כל המדיניות הבאות. כל הודעות `instruct` מצטברות ומועברות ביחד.
+`deny` הראשון מקצר את כל המדיניויות הלאחרונות. כל הודעות `instruct` מצטברות ומועברות ביחד.
 </Note>
 
 ---
 
-## יבואות טרנזיטיביים
+## ייבואים טרנזיטיביים
 
-קבצי מדיניות מותאמת אישית יכולים לייבא מודולים מקומיים באמצעות נתיבים יחסיים:
+קבצי מדיניות מותאמות אישית יכולים לייבא מודולים מקומיים באמצעות נתיבים יחסיים:
 
 ```js
 // my-policies.js
@@ -218,13 +218,13 @@ customPolicies.add({
 });
 ```
 
-כל היבואות היחסיות הנגישות מקובץ הכניסה מוסדרות. זה מיושם על ידי כתיבה מחדש `from "failproofai"` ייבואים לנתיב dist בפועל ויצירת קבצים זמניים `.mjs` כדי להבטיח תאימות ESM.
+כל הייבואים היחסיים הניתנים להשגה מקובץ הכניסה נפתרים. זה מיושם על ידי שכתוב `from "failproofai"` ייבואים לנתיב dist בפועל וליצירת קבצי `.mjs` זמניים כדי להבטיח תאימות ESM.
 
 ---
 
 ## סינון סוג אירוע
 
-השתמש `match.events` כדי להגביל מתי מדיניות מתעוררת:
+השתמש ב-`match.events` כדי להגביל מתי מדיניות נוסקת:
 
 ```js
 customPolicies.add({
@@ -238,26 +238,26 @@ customPolicies.add({
 });
 ```
 
-השמט `match` לחלוטין כדי להתעורר על כל סוג אירוע.
+השמט `match` לחלוטין כדי לנוקוב בכל סוג אירוע.
 
 ---
 
 ## טיפול בשגיאות ומצבי כשל
 
-מדיניות מותאמת אישית היא **fail-open**: שגיאות לא חוסמות מדיניות מובנית וגם לא קורסות את מטפל ה-hook.
+מדיניויות מותאמות אישית הן **fail-open**: שגיאות לעולם לא חוסמות מדיניויות מובנות או קורעות מטפל hook.
 
-| כישלון | התנהגות |
+| כשל | התנהגות |
 |---------|----------|
-| `customPoliciesPath` לא מוגדר | אין מדיניות מותאמת אישית מפורשת מתוך; מדיניות קונבנציה ומובנית ממשיכות כרגיל |
-| קובץ לא נמצא | אזהרה רשומה ל-`~/.failproofai/hook.log`; מובנה ממשיך |
-| שגיאת תחביר/ייבוא (מפורש) | שגיאה רשומה ל-`~/.failproofai/hook.log`; מדיניות מותאמת אישית מפורשת דלק |
-| שגיאת תחביר/ייבוא (קונבנציה) | שגיאה רשומה; קובץ זה דלק, קבצי קונבנציה אחרים עדיין נטענים |
-| `fn` זורק בזמן ריצה | שגיאה רשומה; hook זה מטופל כ-`allow`; hook אחרים ממשיכים |
-| `fn` לוקח יותר מ-10 שניות | timeout רשומה; מטופל כ-`allow` |
-| ספרייה קונבנציה חסרה | אין מדיניות קונבנציה מתוך; אין שגיאה |
+| `customPoliciesPath` לא מוגדר | אין מדיניויות מותאמות אישית מפורשות פועלות; מדיניויות קונבנציה ומובנות ממשיכות כרגיל |
+| קובץ לא נמצא | אזהרה רשומה ל-`~/.failproofai/hook.log`; מובנות ממשיכות |
+| שגיאה syntax/import (מפורשת) | שגיאה רשומה ל-`~/.failproofai/hook.log`; מדיניויות מותאמות אישית מפורשות דלג |
+| שגיאה syntax/import (קונבנציה) | שגיאה רשומה; הקובץ הזה דלג, קבצי קונבנציה אחרים עדיין נטענים |
+| `fn` זורק בזמן ריצה | שגיאה רשומה; ה-hook הזה מטופל כ-`allow`; hooks אחרים ממשיכים |
+| `fn` לוקח יותר מ-10 שניות | Timeout רשום; מטופל כ-`allow` |
+| ספריית קונבנציה חסרה | אין מדיניויות קונבנציה פועלות; אין שגיאה |
 
 <Tip>
-לדבוג שגיאות מדיניות מותאמת אישית, צפה בקובץ היומן:
+כדי לבצע ניפוי שגיאות של מדיניויות מותאמות אישית, צפה בקובץ היומן:
 
 ```bash
 tail -f ~/.failproofai/hook.log
@@ -266,7 +266,7 @@ tail -f ~/.failproofai/hook.log
 
 ---
 
-## דוגמה מלאה: מדיניות מרובה
+## דוגמה מלאה: מדיניויות מרובות
 
 ```js
 // my-policies.js
@@ -323,14 +323,14 @@ export { customPolicies };
 
 ## דוגמאות
 
-ספרייה `examples/` מכילה קבצי מדיניות מוכנים להפעלה:
+ספריית `examples/` מכילה קבצי מדיניות שמוכנים להרצה:
 
 | קובץ | תוכן |
 |------|----------|
-| `examples/policies-basic.js` | חמש מדיניות התחלה המכסות מצבי כשל סוכן נפוצים |
-| `examples/policies-advanced/index.js` | דפוסים מתקדמים: יבואות טרנזיטיביים, קריאות אסינכרוניות, ניקוי פלט, and וו-end-of-session |
-| `examples/convention-policies/security-policies.mjs` | מדיניות אבטחה מבוססת קונבנציה (חסום .env כתיבות, מנע כתיבה מחדש של היסטוריה של git) |
-| `examples/convention-policies/workflow-policies.mjs` | מדיניות זרימת עבודה מבוססת קונבנציה (תזכורות בדיקה, כתיבות קובץ ביקורת) |
+| `examples/policies-basic.js` | חמש מדיניויות הפעלה המכסות מצבי כשל סוכן נפוצים |
+| `examples/policies-advanced/index.js` | דפוסים מתקדמים: ייבואים טרנזיטיביים, קריאות אסינכרוניות, scrubbing פלט וhooks סיום סשן |
+| `examples/convention-policies/security-policies.mjs` | מדיניויות אבטחה מבוססות קונבנציה (חסום כתיבות .env, מנע שכתוב היסטוריית git) |
+| `examples/convention-policies/workflow-policies.mjs` | מדיניויות זרימת עבודה מבוססות קונבנציה (תזכורות בדיקה, ביקורת כתיבות קובץ) |
 
 ### שימוש בדוגמאות קובץ מפורשות
 
@@ -350,4 +350,4 @@ mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```
 
-אין צורך בפקודת התקנה — הקבצים נאספים באופן אוטומטי בעלון ה-hook הבא.
+אין צורך בפקודת התקנה — הקבצים נוקטים באופן אוטומטי באירוע hook הבא.

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

@@ -4,13 +4,13 @@ description: "כיצד להגדיר hooks עבור Claude Code ו-Agents SDK"
 icon: book-open
 ---
 
-דוגמאות מוכנות לשימוש עבור תרחישים נפוצים. כל אחת מהן מציגה כיצד להתקין ומה לצפות.
+דוגמאות מוכנות לשימוש עבור תרחישים נפוצים. כל אחת מהן מראה כיצד להתקין ומה לצפות.
 
 ---
 
 ## הגדרת hooks עבור Claude Code
 
-Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://docs.anthropic.com/en/docs/claude-code/hooks) שלו. כאשר אתה מריץ `failproofai policies --install`, הוא רושם פקודות hook בקובץ `settings.json` של Claude Code שמופעלות בכל קריאת כלי.
+Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks שלו](https://docs.anthropic.com/en/docs/claude-code/hooks). כאשר אתה מריץ `failproofai policies --install`, הוא רושם פקודות hook בקובץ `settings.json` של Claude Code שמופעלות בכל קריאת tool.
 
 <Steps>
   <Step title="התקן את failproofai">
@@ -18,24 +18,24 @@ Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://do
     npm install -g failproofai
     ```
   </Step>
-  <Step title="הפוך את כל המדיניות המובנית לזמינה">
+  <Step title="הפעל את כל המדיניויות המובנות">
     ```bash
     failproofai policies --install
     ```
   </Step>
-  <Step title="וודא שה-hooks רשומים">
+  <Step title="אמת שה-hooks רשומות">
     ```bash
     cat ~/.claude/settings.json | grep failproofai
     ```
 
-    אתה אמור לראות ערכי hook עבור אירועי `PreToolUse`, `PostToolUse`, `Notification`, ו-`Stop`.
+    אתה אמור לראות ערכי hook עבור אירועי `PreToolUse`, `PostToolUse`, `Notification` ו-`Stop`.
   </Step>
   <Step title="הרץ את Claude Code">
     ```bash
     claude
     ```
 
-    המדיניות פועלת כעת באופן אוטומטי בכל קריאת כלי. נסה לבקש מ-Claude להריץ `sudo rm -rf /` - זה יחסום.
+    המדיניויות פועלות כעת באופן אוטומטי בכל קריאת tool. נסה לבקש מ-Claude להריץ `sudo rm -rf /` - זה יחסום.
   </Step>
 </Steps>
 
@@ -43,7 +43,7 @@ Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://do
 
 ## הגדרת hooks עבור Agents SDK
 
-אם אתה בונה עם [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), אתה יכול להשתמש באותה מערכת hooks בצורה תכנותית.
+אם אתה בונה עם [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk), אתה יכול להשתמש באותה מערכת hooks בצורה תוכנתית.
 
 <Steps>
   <Step title="התקן את failproofai בפרויקט שלך">
@@ -52,14 +52,14 @@ Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://do
     ```
   </Step>
   <Step title="הגדר hooks ב-agent שלך">
-    העבר פקודות hook בעת יצירת תהליך ה-agent שלך. ה-hooks פועלים באותו אופן כמו ב-Claude Code - דרך JSON של stdin/stdout:
+    העבר פקודות hook בעת יצירת תהליך ה-agent שלך. ה-hooks מופעלים באותו אופן כמו ב-Claude Code - דרך stdin/stdout JSON:
 
     ```bash
     failproofai --hook PreToolUse   # called before each tool
     failproofai --hook PostToolUse  # called after each tool
     ```
   </Step>
-  <Step title="כתוב מדיניות מותאמת אישית עבור ה-agent שלך">
+  <Step title="כתוב מדיניות מותאמת עבור ה-agent שלך">
     ```javascript
     import { customPolicies, allow, deny } from "failproofai";
 
@@ -77,7 +77,7 @@ Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://do
     });
     ```
   </Step>
-  <Step title="התקן את המדיניות המותאמת אישית">
+  <Step title="התקן את המדיניות המותאמת">
     ```bash
     failproofai policies --install --custom ./my-agent-policies.js
     ```
@@ -88,35 +88,35 @@ Failproof AI משתלב עם Claude Code דרך [מערכת ה-hooks](https://do
 
 ## חסום פקודות הרסניות
 
-ההגדרה הנפוצה ביותר - מנע מ-agents לפעול בנזק בלתי הפיך.
+ההגדרה הנפוצה ביותר - מנע מ-agents לפעול בעלויות בלתי הפיכות.
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
 ```
 
 מה זה עושה:
-- `block-sudo` - חוסם את כל פקודות `sudo`
-- `block-rm-rf` - חוסם מחיקת קובץ רקורסיבית
+- `block-sudo` - חוסם את כל הפקודות `sudo`
+- `block-rm-rf` - חוסם מחיקת קבצים רקורסיבית
 - `block-force-push` - חוסם `git push --force`
-- `block-curl-pipe-sh` - חוסם צנרת של סקריפטים מרחוקים לשל
+- `block-curl-pipe-sh` - חוסם צנרור של סקריפטים מרחוקים לקליפה
 
 ---
 
 ## מנע דליפת סודות
 
-עצור agents מלראות או לדלוף אישורים בפלט הכלי.
+עצור agents מלראות או להדליף אישורי גישה בפלט של tool.
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-אלה פועלים על `PostToolUse` - לאחר הרצת כלי, הם מנקים את הפלט לפני שה-agent רואה זאת.
+אלה מופעלות ב-`PostToolUse` - לאחר הרצת tool, הם מנקים את הפלט לפני שה-agent רואה זאת.
 
 ---
 
-## קבל התראות Slack כאשר agents צריכים תשומת לב
+## קבל התראות Slack כאשר agents זקוקים לתשומת לב
 
-השתמש בה-notification hook כדי להעביר התראות במצב חמלה ל-Slack.
+השתמש ב-notification hook כדי להעביר התראות של תהיות ל-Slack.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -150,7 +150,7 @@ customPolicies.add({
 });
 ```
 
-התקן אותו:
+התקן זאת:
 
 ```bash
 SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
@@ -158,9 +158,9 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ---
 
-## שמור agents בענף
+## שמור על agents בענף
 
-מנע מ-agents להחליף ענפים או לדחוף לענפים מוגנים.
+מנע מ-agents לעבור לענפים אחרים או דחוף לענפים מוגנים.
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
@@ -182,7 +182,7 @@ customPolicies.add({
 
 ---
 
-## דרוש בדיקות לפני commits
+## דרוש בדיקות לפני התחייבות
 
 הזכר ל-agents להריץ בדיקות לפני commit.
 
@@ -206,11 +206,11 @@ customPolicies.add({
 
 ---
 
-## נעל ריפוזיטוריום ייצור
+## נעל מאגר ייצור
 
-בצע commit לקונפיג ברמת פרויקט כדי שלכל מפתח בצוות שלך תהיה אותה מדיניות.
+צרור תצורה ברמת פרויקט כדי שכל מפתח בצוות שלך יקבל את אותן מדיניויות.
 
-צור `.failproofai/policies-config.json` בריפוזיטוריום שלך:
+צור `.failproofai/policies-config.json` במאגר שלך:
 
 ```json
 {
@@ -231,23 +231,77 @@ customPolicies.add({
 }
 ```
 
-לאחר מכן בצע commit:
+לאחר מכן צרור זאת:
 
 ```bash
 git add .failproofai/policies-config.json
 git commit -m "Add failproofai team policies"
 ```
 
-כל חברי הצוות שיש להם failproofai מותקן יבחרו באופן אוטומטי את הכללים הללו.
+כל חברי הצוות שיש להם failproofai מותקן יטיילו באופן אוטומטי כללים אלה.
 
 ---
 
-## דוגמאות נוספות
+## בנה קנס איכות בחברה עם מדיניויות קונבנציה
 
-תיקיית [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) בריפוזיטוריום מכילה:
+ההגדרה בעלת ההשפעה הרבה ביותר: צרור `.failproofai/policies/` למאגר שלך עם מדיניויות המותאמות לפרויקט שלך. כל חברי הצוות מקבלים אותן באופן אוטומטי — ללא פקודות התקנה, ללא שינויי תצורה.
 
-| קובץ | מה הוא מציג |
+<Steps>
+  <Step title="צור את הספרייה והוסף מדיניויות">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="צרור ל-git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="המשך להשתפר">
+    כאשר הצוות שלך פוגע במצבי כישלון חדשים, הוסף מדיניויות ודחוף. כולם מקבלים את העדכון ב-`git pull` הבא שלהם. המדיניויות הללו הופכות לקנס איכות חי שגדל עם הצוות שלך.
+  </Step>
+</Steps>
+
+---
+
+## עוד דוגמאות
+
+ספרייית [`examples/`](https://github.com/exospherehost/failproofai/tree/main/examples) במאגר מכילה:
+
+| קובץ | מה הוא מראה |
 |------|---------------|
-| `policies-basic.js` | מדיניות התחלתית - חסום כתיבה בייצור, force-push, סקריפטים צנורים |
-| `policies-notification.js` | התראות Slack עבור התראות במצב חמלה וסיום הפעילות |
-| `policies-advanced/index.js` | יבוא טרנזיטיבי, hooks אסינכרונים, ניקוי פלט PostToolUse, טיפול באירוע Stop |
+| `policies-basic.js` | מדיניויות מתחילים - חסום כתיבות ייצור, force-push, סקריפטים מנוביות |
+| `policies-notification.js` | התראות Slack עבור התראות של תהיות וסיום הפעלה |
+| `policies-advanced/index.js` | יבואים טרנזיטיביים, hooks אסינכרוניים, ניקוי פלט של PostToolUse, טיפול באירוע Stop |