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

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

@@ -1,13 +1,13 @@
 ---
 title: Начало работы
-description: "Установите failproofai, активируйте политики и позвольте вашим агентам работать надежно"
+description: "Установите failproofai, включите политики и позвольте вашим агентам работать надёжно"
 icon: rocket
 ---
 
 ## Требования
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0 (опционально - требуется только для сборки из исходного кода)
+- **Bun** >= 1.3.0 (опционально — требуется только для сборки из исходников)
 
 ---
 
@@ -30,14 +30,14 @@ bun add -g failproofai
 ## Быстрый старт
 
 <Steps>
-  <Step title="Активируйте политики">
-    Политики — это правила, которые выполняются до и после каждого вызова инструмента агента. Они перехватывают деструктивные команды, утечки секретов и другие режимы отказа до того, как они нанесут ущерб.
+  <Step title="Включите политики">
+    Политики — это правила, которые выполняются до и после каждого вызова инструмента агентом. Они перехватывают разрушительные команды, утечки секретов и другие сбои до того, как они причинят вред.
 
     ```bash
     failproofai policies --install
     ```
 
-    Это записывает записи хуков в `settings.json` Claude Code. Вы также можете установить для одного проекта или выбрать определенные политики:
+    Это добавляет записи hook в файл `settings.json` Claude Code. Вы также можете установить политики для отдельного проекта или выбрать конкретные:
 
     ```bash
     failproofai policies --install --scope project
@@ -49,17 +49,17 @@ bun add -g failproofai
     failproofai policies
     ```
 
-    Показывает каждую политику, включена ли она и все настроенные параметры.
+    Выводит список всех политик, их статус включения и все настроенные параметры.
   </Step>
   <Step title="Запустите панель мониторинга">
     ```bash
     failproofai
     ```
 
-    Открывает локальную панель мониторинга на `http://localhost:8020`, где вы можете просматривать сеансы, проверять вызовы инструментов и управлять политиками.
+    Открывает локальную панель мониторинга по адресу `http://localhost:8020`, где вы можете просматривать сессии, инспектировать вызовы инструментов и управлять политиками.
   </Step>
-  <Step title="Запустите ваш агент">
-    Запустите Claude Code обычным образом. Если агент попытается что-то рискованное, failproofai автоматически его перехватит. Оставьте его работать без присмотра и проверьте то, что произошло, на панели мониторинга.
+  <Step title="Запустите агента">
+    Запустите Claude Code как обычно. Если агент попытается сделать что-то рискованное, failproofai автоматически это перехватит. Оставьте его работать и просмотрите результаты в панели мониторинга.
   </Step>
 </Steps>
 
@@ -75,29 +75,81 @@ Claude Code  →  failproofai --hook PreToolUse  →  читает JSON из std
                                                  записывает решение в stdout
 ```
 
-Каждая политика возвращает одно из трех решений:
+Каждая политика возвращает одно из трёх решений:
 
-- **allow** — агент продолжает работу нормально
+- **allow** — агент продолжает работу обычно
 - **deny** — действие блокируется, агенту объясняется причина
 - **instruct** — дополнительный контекст добавляется в подсказку агента
 
 <Note>
-Политики выполняются в вашем локальном процессе. Ничего не отправляется на удаленный сервис.
+Политики выполняются в вашем локальном процессе. Ничего не отправляется на удалённый сервис.
 </Note>
 
 ---
 
+## Установка командных политик с использованием соглашения о структуре каталогов
+
+Самый быстрый способ установить стандарты качества в вашей команде — использовать соглашение `.failproofai/policies/`. Поместите файлы политик в этот каталог, и они будут загружены автоматически — без флагов, изменений конфигурации или команд установки.
+
+<Steps>
+  <Step title="Создайте каталог политик">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="Добавьте файлы политик">
+    Скопируйте примеры для начинающих или напишите свои:
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    Или создайте новый:
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="Добавьте в git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+
+    Каждый член команды с установленным failproofai автоматически получит эти политики. Никаких индивидуальных настроек не требуется.
+  </Step>
+</Steps>
+
+<Tip>
+Добавьте `.failproofai/policies/` в ваш репозиторий, чтобы вся команда придерживалась одинаковых стандартов. По мере того как ваша команда обнаруживает новые сбои, добавляйте политики и отправляйте их — каждый получит обновление при следующем `git pull`. Со временем эти политики становятся живым стандартом качества, который постоянно улучшается.
+</Tip>
+
+---
+
 ## Хранение данных
 
 Все конфигурации и логи остаются на вашем компьютере:
 
-| Путь | Что здесь хранится |
-|------|----------------|
+| Путь | Что хранится |
+|------|--------------|
 | `~/.failproofai/policies-config.json` | Глобальная конфигурация политик |
-| `~/.failproofai/hook-activity.jsonl` | История выполнения хуков |
-| `~/.failproofai/hook.log` | Лог отладки для ошибок пользовательских хуков |
-| `.failproofai/policies-config.json` | Конфигурация для каждого проекта (committed) |
-| `.failproofai/policies-config.local.json` | Личные переопределения (gitignored) |
+| `~/.failproofai/hook-activity.jsonl` | История выполнения hook-ов |
+| `~/.failproofai/hook.log` | Лог отладки для ошибок пользовательских hook-ов |
+| `.failproofai/policies-config.json` | Конфигурация для проекта (добавляется в репозиторий) |
+| `.failproofai/policies-config.local.json` | Личные переопределения (исключено из git) |
 
 ---
 
@@ -107,7 +159,7 @@ Claude Code  →  failproofai --hook PreToolUse  →  читает JSON из std
 failproofai policies --uninstall
 ```
 
-Удаляет записи хуков из `~/.claude/settings.json`. Файлы конфигурации в `~/.failproofai/` сохраняются.
+Удаляет записи hook из `~/.claude/settings.json`. Файлы конфигурации в `~/.failproofai/` сохраняются.
 
 ---
 
@@ -116,7 +168,7 @@ failproofai policies --uninstall
 <CardGroup cols={2}>
 
 <Card title="Конфигурация" icon="gear" href="/ru/configuration">
-  Области действия и формат файла конфигурации
+  Области и формат файла конфигурации
 </Card>
 
 <Card title="Встроенные политики" icon="shield" href="/ru/built-in-policies">
@@ -124,11 +176,11 @@ failproofai policies --uninstall
 </Card>
 
 <Card title="Пользовательские политики" icon="code" href="/ru/custom-policies">
-  Напишите свои собственные политики на JavaScript
+  Напишите свои политики на JavaScript
 </Card>
 
 <Card title="Монитор агента" icon="chart-line" href="/ru/dashboard">
-  Мониторьте сеансы и проверяйте активность политик
+  Мониторьте сессии и просматривайте активность политик
 </Card>
 
 </CardGroup>