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

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

@@ -1,10 +1,11 @@
 ---
+---
 title: Пользовательские политики
-description: "Напишите свои собственные политики на JavaScript — обеспечьте соблюдение соглашений, предотвратите отклонения, обнаружьте сбои, интегрируйте с внешними системами"
+description: "Напишите собственные политики на JavaScript - обеспечьте соблюдение соглашений, предотвратите дрейф, выявляйте сбои, интегрируйтесь с внешними системами"
 icon: code
 ---
 
-Пользовательские политики позволяют вам написать правила для любого поведения агента: обеспечить соблюдение проектных соглашений, предотвратить отклонения, заблокировать деструктивные операции, обнаружить зависшие агенты или интегрироваться с Slack, рабочими процессами утверждения и т. д. Они используют ту же систему событий hook и решения `allow`, `deny`, `instruct`, что и встроенные политики.
+Пользовательские политики позволяют писать правила для любого поведения агента: обеспечивать соблюдение соглашений проекта, предотвращать дрейф, блокировать деструктивные операции, выявлять зависшие агенты или интегрироваться со Slack, рабочими процессами одобрения и многим другим. Они используют ту же систему событий hook и решения `allow`, `deny`, `instruct`, что и встроенные политики.
 
 ---
 
@@ -39,52 +40,52 @@ failproofai policies --install --custom ./my-policies.js
 
 ## Два способа загрузки пользовательских политик
 
-### Вариант 1: На основе соглашений (рекомендуется)
+### Вариант 1: На основе соглашения (рекомендуется)
 
-Поместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` и они будут автоматически загружены — не требуется никаких флагов или изменений конфигурации. Это работает как git hooks: поместите файл, и он просто работает.
+Разместите файлы `*policies.{js,mjs,ts}` в `.failproofai/policies/` и они будут загружены автоматически — без флагов или изменений конфигурации. Это работает как git hooks: положите файл, и он просто работает.
 
 ```
-# Уровень проекта — коммитится в git, общий для всей команды
+# На уровне проекта — добавляется в git, совместно используется командой
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Уровень пользователя — личный, применяется ко всем проектам
+# На уровне пользователя — личные, применяются ко всем проектам
 ~/.failproofai/policies/my-policies.mjs
 ```
 
 **Как это работает:**
-- Оба директория проекта и пользователя сканируются (объединение — не первый находит победителя)
-- Файлы загружаются в алфавитном порядке в каждом директории. Используйте префикс `01-`, `02-` для управления порядком
-- Загружаются только файлы, соответствующие `*policies.{js,mjs,ts}`; другие файлы игнорируются
+- Оба каталога (проекта и пользователя) сканируются (объединение — не первый найденный)
+- Файлы загружаются в алфавитном порядке в каждом каталоге. Добавьте префикс `01-`, `02-` для управления порядком
+- Загружаются только файлы, соответствующие `*policies.{js,mjs,ts}`; остальные файлы игнорируются
 - Каждый файл загружается независимо (fail-open для каждого файла)
-- Работает наряду с явным `--custom` и встроенными политиками
+- Работает рядом с явными `--custom` и встроенными политиками
 
 <Tip>
-Политики соглашений — самый простой способ поделиться политиками с командой. Коммитьте `.failproofai/policies/` в git, и каждый член команды получит их автоматически.
+Политики на основе соглашения — самый простой способ установить стандарт качества для вашей организации. Добавьте `.failproofai/policies/` в git, и каждый участник команды получит одни и те же правила автоматически — не требуется настройка для каждого разработчика. По мере того как ваша команда обнаруживает новые режимы сбоев, добавьте политику и отправьте её. Со временем эти политики становятся живым стандартом качества, который улучшается с каждым вкладом.
 </Tip>
 
-### Вариант 2: Явный путь файла
+### Вариант 2: Явный путь к файлу
 
 ```bash
-# Установите с файлом пользовательских политик
+# Установка с пользовательским файлом политик
 failproofai policies --install --custom ./my-policies.js
 
-# Замените путь файла политик
+# Замена пути к файлу политик
 failproofai policies --install --custom ./new-policies.js
 
-# Удалите путь пользовательских политик из конфигурации
+# Удаление пути к пользовательским политикам из конфигурации
 failproofai policies --uninstall --custom
 ```
 
 Разрешённый абсолютный путь сохраняется в `policies-config.json` как `customPoliciesPath`. Файл загружается заново при каждом событии hook — кеширования между событиями нет.
 
-### Использование обоих вместе
+### Использование обоих способов вместе
 
-Политики соглашений и явный файл `--custom` могут сосуществовать. Порядок загрузки:
+Политики на основе соглашения и явный файл `--custom` могут сосуществовать. Порядок загрузки:
 
-1. Файл явной `customPoliciesPath` (если настроена)
-2. Файлы соглашений проекта (`{cwd}/.failproofai/policies/`, в алфавитном порядке)
-3. Файлы соглашений пользователя (`~/.failproofai/policies/`, в алфавитном порядке)
+1. Файл с явным `customPoliciesPath` (если настроен)
+2. Файлы соглашения проекта (`{cwd}/.failproofai/policies/`, в алфавитном порядке)
+3. Файлы соглашения пользователя (`~/.failproofai/policies/`, в алфавитном порядке)
 
 ---
 
@@ -98,45 +99,45 @@ import { customPolicies, allow, deny, instruct } from "failproofai";
 
 ### `customPolicies.add(hook)`
 
-Регистрирует политику. Вызовите это столько раз, сколько требуется, для нескольких политик в одном файле.
+Регистрирует политику. Вызывайте столько раз, сколько нужно для нескольких политик в одном файле.
 
 ```ts
 customPolicies.add({
-  name: string;                         // обязательно - уникальный идентификатор
+  name: string;                         // обязателен - уникальный идентификатор
   description?: string;                 // показывается в выводе `failproofai policies`
-  match?: { events?: HookEventType[] }; // фильтр по типу события; опустите для совпадения со всеми
+  match?: { events?: HookEventType[] }; // фильтр по типу события; опустите для соответствия всем
   fn: (ctx: PolicyContext) => PolicyResult | Promise<PolicyResult>;
 });
 ```
 
-### Вспомогательные функции решений
+### Вспомогательные функции принятия решений
 
-| Функция | Эффект | Используйте, когда |
-|---------|--------|----------|
+| Функция | Эффект | Когда использовать |
+|---------|--------|-------------------|
 | `allow()` | Разрешить операцию молча | Действие безопасно, сообщение не требуется |
-| `deny(message)` | Заблокировать операцию | Агент не должен выполнять это действие |
-| `instruct(message)` | Добавить контекст без блокирования | Дайте агенту дополнительный контекст для правильного выполнения |
+| `deny(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](/ru/configuration#hint-cross-cutting).
+Вы можете добавить дополнительное руководство к любому сообщению `deny` или `instruct`, добавив поле `hint` в `policyParams` — без изменения кода. Это работает для пользовательских (`custom/`), проектных соглашений (`.failproofai-project/`) и пользовательских соглашений (`.failproofai-user/`) политик. Смотрите [Configuration → hint](/ru/configuration#hint-cross-cutting) для деталей.
 </Tip>
 
 ### Информационные сообщения allow
 
-`allow(message)` разрешает операцию **и** отправляет информационное сообщение обратно Claude. Сообщение доставляется как `additionalContext` в ответ stdout обработчика hook — того же механизма, используемого `instruct`, но семантически отличного: это обновление статуса, а не предупреждение.
+`allow(message)` разрешает операцию **и** отправляет информационное сообщение обратно Claude. Сообщение доставляется как `additionalContext` в ответе stdout обработчика hook — тот же механизм, используемый `instruct`, но семантически отличающийся: это обновление статуса, а не предупреждение.
 
-| Функция | Эффект | Используйте, когда |
-|---------|--------|----------|
+| Функция | Эффект | Когда использовать |
+|---------|--------|-------------------|
 | `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({
@@ -158,43 +159,43 @@ customPolicies.add({
 ### Поля `PolicyContext`
 
 | Поле | Тип | Описание |
-|------|------|-------------|
+|------|-----|---------|
 | `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 |
+| `payload` | `Record<string, unknown>` | Полная необработанная полезная нагрузка события из Claude Code |
 | `session` | `SessionMetadata \| undefined` | Контекст сессии (см. ниже) |
 
 ### Поля `SessionMetadata`
 
 | Поле | Тип | Описание |
-|------|------|-------------|
+|------|-----|---------|
 | `sessionId` | `string` | Идентификатор сессии Claude Code |
-| `cwd` | `string` | Рабочий директорий сессии Claude Code |
+| `cwd` | `string` | Рабочий каталог сессии Claude Code |
 | `transcriptPath` | `string` | Путь к файлу транскрипта JSONL сессии |
 
 ### Типы событий
 
 | Событие | Когда срабатывает | Содержимое `toolInput` |
-|--------|--------------|----------------------|
-| `PreToolUse` | Перед запуском инструмента Claude | Входные данные инструмента (например, `{ command: "..." }` для Bash) |
-| `PostToolUse` | После завершения инструмента | Входные данные инструмента + `tool_result` (результат) |
+|--------|------------------|----------------------|
+| `PreToolUse` | Перед запуском инструмента Claude | Входные данные инструмента (например `{ command: "..." }` для Bash) |
+| `PostToolUse` | После завершения инструмента | Входные данные инструмента + `tool_result` (выход) |
 | `Notification` | Когда Claude отправляет уведомление | `{ message: "...", notification_type: "idle" \| "permission_prompt" \| ... }` - hooks должны всегда возвращать `allow()`, они не могут блокировать уведомления |
-| `Stop` | Когда сессия Claude завершается | Пусто |
+| `Stop` | Когда сессия Claude заканчивается | Пусто |
 
 ---
 
 ## Порядок оценки
 
-Политики оцениваются в таком порядке:
+Политики оцениваются в этом порядке:
 
 1. Встроенные политики (в порядке определения)
 2. Явные пользовательские политики из `customPoliciesPath` (в порядке `.add()`)
-3. Политики соглашений из проекта `.failproofai/policies/` (файлы в алфавитном порядке, `.add()` внутри)
-4. Политики соглашений из пользователя `~/.failproofai/policies/` (файлы в алфавитном порядке, `.add()` внутри)
+3. Политики соглашения из проекта `.failproofai/policies/` (файлы в алфавитном порядке, `.add()` порядок внутри)
+4. Политики соглашения из пользователя `~/.failproofai/policies/` (файлы в алфавитном порядке, `.add()` порядок внутри)
 
 <Note>
-Первое `deny` прерывает все последующие политики. Все сообщения `instruct` накапливаются и доставляются вместе.
+Первый `deny` прерывает все последующие политики. Все сообщения `instruct` накапливаются и доставляются вместе.
 </Note>
 
 ---
@@ -218,13 +219,13 @@ customPolicies.add({
 });
 ```
 
-Все относительные импорты, достижимые из файла входа, разрешаются. Это реализовано переписыванием импортов `from "failproofai"` на фактический путь dist и созданием временных файлов `.mjs` для обеспечения совместимости ESM.
+Все относительные импорты, доступные из файла входа, разрешаются. Это реализуется путём переписывания импортов `from "failproofai"` на фактический путь dist и создания временных файлов `.mjs` для обеспечения совместимости ESM.
 
 ---
 
-## Фильтрация типов событий
+## Фильтрация по типу события
 
-Используйте `match.events` для ограничения срабатывания политики:
+Используйте `match.events` для ограничения, когда срабатывает политика:
 
 ```js
 customPolicies.add({
@@ -238,26 +239,26 @@ customPolicies.add({
 });
 ```
 
-Опустите `match` полностью, чтобы срабатывать на каждом типе события.
+Опустите `match` полностью, чтобы срабатывать при каждом типе события.
 
 ---
 
-## Обработка ошибок и режимы отказа
+## Обработка ошибок и режимы сбоя
 
-Пользовательские политики — **fail-open**: ошибки никогда не блокируют встроенные политики и не вызывают крах обработчика hook.
+Пользовательские политики — **fail-open**: ошибки никогда не блокируют встроенные политики и не приводят к краху обработчика hook.
 
-| Отказ | Поведение |
-|---------|----------|
-| `customPoliciesPath` не установлена | Явные пользовательские политики не запускаются; встроенные и политики соглашений работают нормально |
-| Файл не найден | Предупреждение логируется в `~/.failproofai/hook.log`; встроенные работают |
-| Ошибка синтаксиса/импорта (явная) | Ошибка логируется в `~/.failproofai/hook.log`; явные пользовательские политики пропущены |
-| Ошибка синтаксиса/импорта (соглашение) | Ошибка логируется; этот файл пропущен, другие файлы соглашений всё ещё загружаются |
-| `fn` выбрасывает во время выполнения | Ошибка логируется; этот hook рассматривается как `allow`; другие hooks продолжают работать |
-| `fn` работает дольше 10 сек | Timeout логируется; рассматривается как `allow` |
-| Директорий соглашений отсутствует | Политики соглашений не запускаются; нет ошибки |
+| Сбой | Поведение |
+|------|-----------|
+| `customPoliciesPath` не установлен | Явные пользовательские политики не запускаются; встроенные и политики соглашения продолжают работать нормально |
+| Файл не найден | Предупреждение записывается в `~/.failproofai/hook.log`; встроенные продолжают работать |
+| Синтаксическая/ошибка импорта (явная) | Ошибка записывается в `~/.failproofai/hook.log`; явные пользовательские политики пропускаются |
+| Синтаксическая/ошибка импорта (соглашение) | Ошибка записывается; этот файл пропускается, остальные файлы соглашения всё ещё загружаются |
+| `fn` выбрасывает исключение во время выполнения | Ошибка записывается; этот hook рассматривается как `allow`; остальные hooks продолжают работу |
+| `fn` работает дольше 10 сек | Тайм-аут записывается; рассматривается как `allow` |
+| Каталог соглашения отсутствует | Политики соглашения не запускаются; нет ошибки |
 
 <Tip>
-Для отладки ошибок пользовательской политики смотрите файл журнала:
+Для отладки ошибок пользовательских политик смотрите файл журнала:
 
 ```bash
 tail -f ~/.failproofai/hook.log
@@ -272,7 +273,7 @@ tail -f ~/.failproofai/hook.log
 // my-policies.js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
-// Предотвратите запись агента в директорий secrets/
+// Запретить агенту писать в каталог secrets/
 customPolicies.add({
   name: "block-secrets-dir",
   description: "Prevent agent from writing to secrets/ directory",
@@ -285,7 +286,7 @@ customPolicies.add({
   },
 });
 
-// Удерживайте агента на правильном пути: проверьте тесты перед коммитом
+// Держать агента на пути: проверить тесты перед коммитом
 customPolicies.add({
   name: "remind-test-before-commit",
   description: "Keep the agent on track: verify tests pass before committing",
@@ -300,7 +301,7 @@ customPolicies.add({
   },
 });
 
-// Предотвратите неплановые изменения зависимостей во время заморозки
+// Запретить незапланированные изменения зависимостей во время freeze
 customPolicies.add({
   name: "dependency-freeze",
   description: "Prevent unplanned dependency changes during freeze period",
@@ -323,31 +324,31 @@ export { customPolicies };
 
 ## Примеры
 
-Директорий `examples/` содержит готовые файлы политик:
+Каталог `examples/` содержит готовые к запуску файлы политик:
 
 | Файл | Содержимое |
-|------|----------|
-| `examples/policies-basic.js` | Пять начальных политик, охватывающих частые режимы отказа агента |
-| `examples/policies-advanced/index.js` | Продвинутые паттерны: транзитивные импорты, асинхронные вызовы, очистка вывода и hooks завершения сессии |
-| `examples/convention-policies/security-policies.mjs` | Политики безопасности на основе соглашений (блокировка записи .env, предотвращение переписывания истории git) |
-| `examples/convention-policies/workflow-policies.mjs` | Политики рабочего процесса на основе соглашений (напоминания о тестах, аудит записей файлов) |
+|------|-----------|
+| `examples/policies-basic.js` | Пять начальных политик, охватывающих распространённые режимы сбоев агента |
+| `examples/policies-advanced/index.js` | Продвинутые паттерны: транзитивные импорты, асинхронные вызовы, очистка выходных данных и hooks конца сессии |
+| `examples/convention-policies/security-policies.mjs` | Политики безопасности на основе соглашения (блокировка записей .env, предотвращение переписывания истории git) |
+| `examples/convention-policies/workflow-policies.mjs` | Политики рабочего процесса на основе соглашения (напоминания о тестах, аудит записей файлов) |
 
-### Использование примеров явного файла
+### Использование примеров с явным файлом
 
 ```bash
 failproofai policies --install --custom ./examples/policies-basic.js
 ```
 
-### Использование примеров на основе соглашений
+### Использование примеров на основе соглашения
 
 ```bash
-# Скопируйте на уровень проекта
+# Копировать на уровень проекта
 mkdir -p .failproofai/policies
 cp examples/convention-policies/*.mjs .failproofai/policies/
 
-# Или скопируйте на уровень пользователя
+# Или копировать на уровень пользователя
 mkdir -p ~/.failproofai/policies
 cp examples/convention-policies/*.mjs ~/.failproofai/policies/
 ```
 
-Команда install не требуется — файлы будут подхвачены автоматически при следующем событии hook.
+Команда установки не требуется — файлы будут подхвачены автоматически при следующем событии hook.

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

@@ -1,17 +1,18 @@
 ---
+
 ---
 title: Примеры
 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`, он регистрирует команды hooks в `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, которые срабатывают при каждом вызове инструмента.
 
 <Steps>
   <Step title="Установите failproofai">
@@ -29,14 +30,14 @@ Failproof AI интегрируется с Claude Code через его [сис
     cat ~/.claude/settings.json | grep failproofai
     ```
 
-    Вы должны увидеть записи hooks для событий `PreToolUse`, `PostToolUse`, `Notification` и `Stop`.
+    Вы должны увидеть записи hook для событий `PreToolUse`, `PostToolUse`, `Notification` и `Stop`.
   </Step>
   <Step title="Запустите Claude Code">
     ```bash
     claude
     ```
 
-    Политики теперь выполняются автоматически при каждом вызове инструмента. Попробуйте попросить Claude выполнить `sudo rm -rf /` — это будет заблокировано.
+    Политики теперь выполняются автоматически при каждом вызове инструмента. Попробуйте попросить Claude запустить `sudo rm -rf /` — это будет заблокировано.
   </Step>
 </Steps>
 
@@ -44,7 +45,7 @@ Failproof AI интегрируется с Claude Code через его [сис
 
 ## Настройка 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 в ваш проект">
@@ -53,7 +54,7 @@ Failproof AI интегрируется с Claude Code через его [сис
     ```
   </Step>
   <Step title="Настройте hooks в вашем агенте">
-    Передайте команды hooks при создании процесса агента. Hooks срабатывают точно так же, как в Claude Code — через stdin/stdout JSON:
+    Передайте hook-команды при создании процесса агента. Hooks срабатывают так же, как в Claude Code — через stdin/stdout JSON:
 
     ```bash
     failproofai --hook PreToolUse   # вызывается перед каждым инструментом
@@ -89,7 +90,7 @@ Failproof AI интегрируется с Claude Code через его [сис
 
 ## Блокировка деструктивных команд
 
-Самая распространённая настройка — предотвращение необратимого ущерба от действий агентов.
+Наиболее распространённая настройка — предотвратить необратимый ущерб от действий агентов.
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
@@ -99,25 +100,25 @@ failproofai policies --install block-sudo block-rm-rf block-force-push block-cur
 - `block-sudo` — блокирует все команды `sudo`
 - `block-rm-rf` — блокирует рекурсивное удаление файлов
 - `block-force-push` — блокирует `git push --force`
-- `block-curl-pipe-sh` — блокирует передачу удалённых скриптов в оболочку
+- `block-curl-pipe-sh` — блокирует передачу удалённых скриптов в shell
 
 ---
 
 ## Предотвращение утечки секретов
 
-Остановите агентов от просмотра или утечки учётных данных в выводе инструментов.
+Помешайте агентам видеть или утекать учётные данные в выводе инструментов.
 
 ```bash
 failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
 ```
 
-Эти политики срабатывают на `PostToolUse` — после выполнения инструмента они очищают вывод перед тем, как агент его увидит.
+Они срабатывают на `PostToolUse` — после запуска инструмента, они скрывают вывод, прежде чем агент его увидит.
 
 ---
 
-## Получайте оповещения в Slack, когда агентам требуется внимание
+## Получайте оповещения Slack, когда агентам требуется внимание
 
-Используйте hook уведомлений для отправки оповещений о неактивности в Slack.
+Используйте notification hook для отправки оповещений об ожидании в Slack.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -151,7 +152,7 @@ customPolicies.add({
 });
 ```
 
-Установите её:
+Установите это:
 
 ```bash
 SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
@@ -161,7 +162,7 @@ SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --c
 
 ## Держите агентов на одной ветке
 
-Предотвратите переключение ветвей или отправку на защищённые ветви.
+Предотвратите переключение веток и отправку на защищённые ветки.
 
 ```javascript
 import { customPolicies, allow, deny } from "failproofai";
@@ -183,9 +184,9 @@ customPolicies.add({
 
 ---
 
-## Требуйте тесты перед коммитом
+## Требуйте тесты перед коммитами
 
-Напоминайте агентам запускать тесты перед коммитом.
+Напомните агентам запустить тесты перед коммитом.
 
 ```javascript
 import { customPolicies, allow, instruct } from "failproofai";
@@ -209,7 +210,7 @@ customPolicies.add({
 
 ## Заблокируйте production репозиторий
 
-Добавьте конфигурацию на уровне проекта, чтобы все разработчики вашей команды получили одинаковые политики.
+Заколмитьте конфигурацию на уровне проекта, чтобы все разработчики в вашей команде получили одинаковые политики.
 
 Создайте `.failproofai/policies-config.json` в вашем репозитории:
 
@@ -232,7 +233,7 @@ customPolicies.add({
 }
 ```
 
-Затем добавьте её:
+Затем заколмитьте это:
 
 ```bash
 git add .failproofai/policies-config.json
@@ -243,12 +244,66 @@ git commit -m "Add failproofai team policies"
 
 ---
 
-## Больше примеров
+## Постройте стандарт качества на уровне организации с политиками соглашения
+
+Наиболее эффективная настройка: заколмитьте `.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` | Базовые политики — блокировка записей в production, force-push, передачи скриптов |
-| `policies-notification.js` | Оповещения Slack для уведомлений о неактивности и завершении сессии |
-| `policies-advanced/index.js` | Переходные импорты, асинхронные hooks, очистка вывода PostToolUse, обработка события Stop |
+| `policies-basic.js` | Начальные политики — блокировка записей в production, force-push, передача скриптов |
+| `policies-notification.js` | Оповещения Slack для уведомлений об ожидании и завершения сессии |
+| `policies-advanced/index.js` | Транзитивный импорт, асинхронные hooks, скрубинг вывода PostToolUse, обработка события Stop |